@intlayer/docs 9.3.3 → 9.4.0

package/docs/en-GB/releases/v6.md

@@ -116,6 +116,8 @@ const config: IntlayerConfig = {
 export default config;
 ```
 
+Auto-fill your missing translations using the `npx intlayer fill` command.
+
 You can still fine‑tune per dictionary using the `autoFill` field in content files. See the full reference in `doc/autoFill` and `doc/dictionary/content_file`.
 
 ---
@@ -175,6 +177,20 @@ See details in the [Official VS Code Extension](https://github.com/aymericzip/in
 
 ---
 
+Updated the MCP server to support the new features.
+
+- Auto-fill
+- Test missing translations
+- Live updates
+- Logging
+- Validation
+- Migration notes
+- Documentation
+
+> MCP server helps with the automation of projects using Intlayer. Testing missing translations for autogenerated code. It helps understand your config, and embed the documentation of Intlayer in your IDE.
+
+---
+
 ## Performance: 10× faster
 
 - Parallel resolution of local and remote dictionaries
@@ -264,31 +280,6 @@ export default {
 };
 ```
 
-See [Configuration](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en-GB/configuration.md) for all logging options.
-
----
-
-## Live updates with CMS (Production‑safe)
-
-Serve live content updates (e.g., editorial updates) in production without rebuilding your application.
-
-1. Enable live import mode:
-
-```ts fileName="intlayer.config.ts"
-import { type IntlayerConfig } from "intlayer";
-
-const config: IntlayerConfig = {
-  build: {
-    importMode: "live", // "static" | "dynamic" | "live"
-  },
-  editor: {
-    liveSync: true, // enable live sync server side
-  },
-};
-
-export default config;
-```
-
 2. Run your app and live process side‑by‑side:
 
 ```bash packageManager="npm"
@@ -309,10 +300,21 @@ bun x intlayer live --with 'vite preview'
 
 Notes:
 
-- Only dictionaries flagged to use live mode will be fetched live. Others are optimised for performance.
-- Falls back to dynamic import if the live API isn’t reachable.
+See [Configuration](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en-GB/configuration.md) for all logging options.
+
+---
+
+## Live updates with CMS (Production‑safe)
+
+Serve live content updates (e.g., editorial updates) in production without rebuilding your application.
+
+1. Enable live import mode:
 
-See [CMS and Live Sync](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en-GB/intlayer_CMS.md) and [Configuration](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en-GB/configuration.md) for complete guidance.
+2. Run your app and live process side‑by‑side:
+
+```bash packageManager="bun"
+bun x intlayer live --with 'vite preview'
+```
 
 ---
 

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/agent_skills.md

@@ -1,11 +1,11 @@
 ---
 createdAt: 2026-02-09
 updatedAt: 2026-03-03
-title: Habilidades del Agente
-description: Aprenda a usar las Habilidades del Agente de Intlayer para mejorar la comprensión de su proyecto por parte de su agente de IA, incluyendo guías de configuración completas para Metadatos, Sitemaps y Acciones del Servidor.
+title: Agent Skills
+description: Aprenda a usar las Agent Skills de Intlayer para mejorar la comprensión de su proyecto por parte de su agente de IA, incluyendo guías de configuración completas para Metadatos, Sitemaps y Acciones del Servidor.
 keywords:
   - Intlayer
-  - Habilidades del Agente
+  - Agent Skills
   - Agente de IA
   - Internacionalización
   - Documentación
@@ -19,13 +19,13 @@ history:
 author: aymericzip
 ---
 
-# Habilidades del Agente
+# Agent Skills
 
 ## Configuración
 
 ### Usando la CLI
 
-El comando `intlayer init skills` es la forma más fácil de configurar las habilidades del agente en su proyecto. Detecta su entorno e instala los archivos de configuración necesarios para sus plataformas preferidas.
+El comando `intlayer init skills` es la forma más fácil de configurar las Agent Skills en su proyecto. Detecta su entorno e instala los archivos de configuración necesarios para sus plataformas preferidas.
 
 ```bash packageManager="npm"
 npx intlayer init skills
@@ -54,10 +54,10 @@ npx skills add aymericzip/intlayer-skills
 1. Abra la Paleta de Comandos (Ctrl+Shift+P o Cmd+Shift+P).
 2. Escriba `Intlayer: Setup AI Agent Skills`
 3. Elija la plataforma que usa (por ejemplo, `VS Code`, `Cursor`, `Windsurf`, `OpenCode`, `Claude Code`, `GitHub Copilot Workspace`, etc.).
-4. Elija las habilidades que desea instalar (por ejemplo, `Next.js`, `React`, `Vite`, `Compiler`, `Configuration`).
+4. Elija las Agent Skills que desea instalar (por ejemplo, `Next.js`, `React`, `Vite`, `Compiler`, `Configuration`).
 5. Presione Enter.
 
-## Lista de Habilidades
+## Lista de Agent Skills
 
 **intlayer-config**
 

package/docs/es/analytics.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-07-08
-updatedAt: 2026-07-08
+updatedAt: 2026-08-22
 title: Intlayer Analytics | Seguimiento de la exposición del contenido y pruebas A/B
 description: Descubre cómo @intlayer/analytics rastrea las vistas de páginas/configuraciones regionales y la exposición del contenido, y cómo usarlo para ejecutar pruebas A/B en tu contenido de Intlayer.
 keywords:
@@ -18,6 +18,9 @@ slugs:
   - concept
   - analytics
 history:
+  - version: 9.3.3
+    date: 2026-08-22
+    changes: "Habilitar las analíticas de forma predeterminada cuando `@intlayer/analytics` está instalado"
   - version: 9.0.0
     date: 2026-07-08
     changes: "Init doc — paquete @intlayer/analytics, seguimiento a nivel de proveedor/nodo, pruebas A/B, panel de control"
@@ -57,7 +60,7 @@ Intlayer ya te permite declarar [Variantes](https://github.com/aymericzip/intlay
 
 ## Instalación
 
-`@intlayer/analytics` es una dependencia **par y opcional** — nunca instalada automáticamente por un paquete de framework. Añádela junto a `intlayer`:
+`@intlayer/analytics` es una **dependencia opcional** de todos los paquetes de framework (`react-intlayer`, `next-intlayer`, `vue-intlayer`, …), por lo que la mayoría de los proyectos ya la tienen. Instálala explícitamente si tu configuración omite las dependencias opcionales (`npm install --no-optional`, …):
 
 ```bash packageManager="npm"
 npm install @intlayer/analytics
@@ -75,11 +78,11 @@ pnpm add @intlayer/analytics
 bun add @intlayer/analytics
 ```
 
-Si no lo instalas, todos los puntos de integración se resuelven como una operación nula (no-op) — consulta [Costo cero cuando no está instalado](#costo-cero-cuando-no-esta-instalado) a continuación.
+Instalar el paquete es todo lo que hace falta para activar las analíticas: `analytics.enabled` es `true` de forma predeterminada, y `@intlayer/config` lo resuelve a `false` cuando no encuentra el paquete en tu proyecto. Si no lo instalas, todos los puntos de integración se resuelven como una operación nula (no-op) — consulta [Costo cero cuando no está instalado](#costo-cero-cuando-no-esta-instalado) a continuación.
 
 ## Configuración
 
-Analytics **reutiliza el bloque de configuración `editor` existente** — no hay un esquema de configuración `analytics` separado que rellenar:
+Las analíticas no necesitan configuración para empezar: están **habilitadas de forma predeterminada** y **reutilizan el bloque de configuración `editor` existente** para su endpoint y su clave de proyecto.
 
 ```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import type { IntlayerConfig } from "intlayer";
@@ -100,16 +103,25 @@ export default config;
 
 Si autoalojas Intlayer, las analíticas apuntan automáticamente a tu propia instancia, ya que comparte `editor.backendURL`.
 
-## Soporte de frameworks
+### Cómo desactivarlas
 
-Analytics está integrado en el `IntlayerProvider` compartido de `react-intlayer`, por lo que está disponible hoy en cualquier lugar donde se use ese proveedor:
+El bloque opcional `analytics` ajusta —o desactiva— la recopilación:
 
-| 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` |
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  analytics: {
+    enabled: false, // Predeterminado: true — excluye toda la integración del bundle
+    flushInterval: 20_000, // Milisegundos entre dos envíos por lotes
+    sampleRate: 1, // Fracción de sesiones a registrar, de 0 (ninguna) a 1 (todas)
+  },
+};
+
+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.
 
 ## Uso
 
@@ -154,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";
 
@@ -164,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.
@@ -177,7 +219,7 @@ const variant = client?.getVariant("homepage-hero", [
 `@intlayer/analytics` sigue exactamente el mismo patrón de dependencia opcional que `@intlayer/editor`:
 
 - cada punto de integración carga el paquete a través de un **`import()` dinámico envuelto en `try/catch`** — una app que nunca instala `@intlayer/analytics` nunca paga un costo de tamaño de bundle o tiempo de ejecución, y nunca ve un error;
-- una variable de entorno en tiempo de compilación (`INTLAYER_ANALYTICS_ENABLED`), configurada automáticamente en `'false'` por `@intlayer/config` cuando `editor.clientId` no está configurado, permite a los empaquetadores **eliminar el código muerto** de toda la integración;
+- una variable de entorno en tiempo de compilación (`INTLAYER_ANALYTICS_ENABLED`), establecida automáticamente en `'false'` por `@intlayer/config` cuando el paquete no está instalado, `analytics.enabled` es `false` o `editor.clientId` no está configurado, permite a los bundlers **eliminar como código muerto (dead-code-eliminate)** toda la integración;
 - las analíticas se desactivan dentro del iframe de vista previa del editor/CMS de Intlayer, por lo que las sesiones de edición nunca se cuentan como tráfico real.
 
 ## Panel de control: Página de Analíticas
@@ -213,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/bundle_optimization.md

@@ -476,7 +476,7 @@ const config: IntlayerConfig = {
 export default config;
 ```
 
-> La minificación se omite cuando `optimize` es `false` o cuando `editor.enabled` es `true` (el Editor Visual requiere de los nombres de los campos originales para editarlos).
+> La minificación se omite cuando `optimize` es `false`. Cuando `editor.enabled` es `true`, sigue ejecutándose, pero sin el paso de renombrado de campos — el editor visual resuelve las ediciones mediante `keyPath`, por lo que los nombres de campo originales deben conservarse.
 
 > En Next.js, la minificación también se omite cuando `@intlayer/swc` no está instalado o no puede cargarse (Next.js por debajo de 16.1.0). El plugin es la mitad que reescribe los accesos en el código fuente, así que renombrar los diccionarios sin él dejaría tu código leyendo nombres de campos que ya no existen.
 
@@ -508,7 +508,7 @@ export default config;
 { "title": "…", "subtitle": "…" }
 ```
 
-> La purga se omite cuando `optimize` es `false` o cuando `editor.enabled` es `true`. En Next.js se omite además cuando `@intlayer/swc` no está disponible y cuando hay llamadores de adaptadores de compatibilidad configurados.
+> La purga se omite cuando `optimize` es `false`. Permanece activa cuando `editor.enabled` es `true` — un campo purgado no es leído por ningún componente, por lo que el editor nunca lo renderiza. En Next.js se omite además cuando `@intlayer/swc` no está disponible y cuando hay llamadores de adaptadores de compatibilidad configurados.
 
 > La purga también se omite por protección cuando un archivo del código fuente sea irreparable y no logre ejecutarse `useIntlayer` al mismo tiempo que una destructuración. Por lo cual todo el diccionario pasaría a formar parte por completo y sin purgar.
 

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`.