@intlayer/docs 9.3.3 → 9.4.0

package/docs/es/packages/react-intlayer/useIntlayer.md

@@ -31,32 +31,6 @@ Esta sección proporciona una guía detallada sobre cómo usar el hook `useIntla
 
 ## Ejemplo de uso en React
 
-Demostración del hook `useIntlayer` dentro de un componente React:
-
-```tsx fileName="src/app.tsx" codeFormat={["typescript", "esm"]}
-import type { FC } from "react";
-import { ClientComponentExample, ServerComponentExample } from "@components";
-import { IntlayerProvider } from "react-intlayer";
-import { useIntlayer, IntlayerServerProvider } from "react-intlayer/server";
-import { Locales } from "intlayer";
-
-const App: FC<{ locale: Locales }> = ({ locale }) => {
-  const content = useIntlayer("homepage", locale);
-
-  return (
-    <>
-      <p>{content.introduction}</p>
-      <IntlayerProvider locale={locale}>
-        <ClientComponentExample />
-      </IntlayerProvider>
-      <IntlayerServerProvider locale={locale}>
-        <ServerComponentExample />
-      </IntlayerServerProvider>
-    </>
-  );
-};
-```
-
 ```tsx fileName="src/components/ComponentExample.tsx" codeFormat={["typescript", "esm"]}
 import type { FC } from "react";
 import { useIntlayer } from "react-intlayer";
@@ -73,22 +47,6 @@ const ComponentExample: FC = () => {
 };
 ```
 
-```tsx fileName="src/components/ServerComponentExample.tsx" codeFormat={["typescript", "esm"]}
-import { useIntlayer } from "react-intlayer/server";
-
-const ServerComponentExample = () => {
-  const content = useIntlayer("server-component");
-
-  return (
-    <div>
-      <h1>{content.title}</h1> {/* Título del componente del servidor */}
-      <p>{content.description}</p>{" "}
-      {/* Descripción del componente del servidor */}
-    </div>
-  );
-};
-```
-
 ## Recursos Adicionales
 
 - **Editor Visual de Intlayer**: Para una experiencia de gestión de contenido más intuitiva, consulta la documentación del editor visual [aquí](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_visual_editor.md).

package/docs/es/packages/solid-intlayer/useRewriteURL.md

@@ -46,8 +46,6 @@ const Layout = (props) => {
 
 ## ¿Por qué usarlo?
 
-/// **URLs canónicas**: Impone una única URL para cada versión localizada de tu contenido, lo cual es crucial para el SEO.
-
 - **Conveniencia para desarrolladores**: Te permite mantener las definiciones internas de rutas canónicas a la vez que expones rutas localizadas y amigables para el usuario al mundo exterior.
 - **Consistencia**: Corrige las URLs cuando los usuarios escriben manualmente una ruta que no sigue tus reglas de localización preferidas.
 

package/docs/es/packages/vite-intlayer/intlayerMinify.md

@@ -56,7 +56,7 @@ export default defineConfig({
 2. `build.optimize` es `true` (o `undefined`, que por defecto es `true` para compilaciones).
 3. `build.minify` es `true` en su configuración de Intlayer.
 
-Se **desactiva** automáticamente cuando `editor.enabled` es `true` porque el editor necesita el contenido del diccionario completo y legible por humanos.
+Cuando `editor.enabled` es `true`, el plugin se sigue ejecutando pero **omite el renombrado de campos**: renombrar reescribe las claves de contenido que recorre el intérprete, por lo que el `keyPath` que recibe el editor visual ya no coincidiría con los diccionarios sin fusionar que edita. La compactación de espacios en blanco y la eliminación de metadatos de nivel superior se mantienen activas.
 
 ## Qué se minifica
 

package/docs/es/packages/vite-intlayer/intlayerPrune.md

@@ -28,6 +28,8 @@ author: aymericzip
 
 El plugin `intlayerPrune` para Vite se utiliza para aplicar tree-shaking y eliminar los diccionarios no utilizados del bundle de tu aplicación. Esto ayuda a reducir el tamaño final del bundle incluyendo únicamente el contenido multilingüe necesario.
 
+> El plugin ya está incluido y configurado automáticamente cuando usas [`intlayer()`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/vite-intlayer/intlayer.md). Solo necesitas registrarlo manualmente si estás componiendo la pila de plugins tú mismo.
+
 ## Uso
 
 ### Como parte de `intlayer()` (recomendado)
@@ -107,6 +109,12 @@ Si la estructura de contenido de un diccionario no puede ser reconocida (por eje
 
 Cuando la poda tiene éxito, `intlayerPrune` también escribe `pruneContext.dictionaryKeyToFieldRenameMap` — un mapeo de nombres de campos originales a alias cortos. `intlayerMinify` lee este mapa para renombrar campos en el JSON de salida, y el paso de renombrado de Babel de `intlayerOptimize` actualiza los accesos a propiedades en los archivos de origen en consecuencia.
 
-## Descripción
+## Condiciones de activación
+
+`intlayerPrune` está activo **solo** cuando se cumplen todas las siguientes condiciones:
+
+1. El comando de Vite es `build`.
+2. `build.optimize` es `true` (o `undefined`, que por defecto es `true` en los builds).
+3. `build.purge` es `true` en tu configuración de Intlayer.
 
-El plugin analiza tu código fuente para identificar qué claves de diccionario se usan realmente. A continuación elimina cualquier contenido no utilizado de los archivos de diccionario empaquetados. Esto es especialmente útil en proyectos grandes con muchos diccionarios donde solo se utiliza un subconjunto en páginas o componentes específicos.
+Permanece activo cuando `editor.enabled` es `true`: el editor visual resuelve cada edición mediante `dictionaryKey` + `keyPath` contra los diccionarios sin fusionar, que este plugin nunca toca, y un campo purgado es uno que ningún componente lee — por lo que nunca se renderiza ni se puede seleccionar en la página.

package/docs/es/per_locale_file.md

@@ -77,6 +77,17 @@ const helloWorldContent = {
 module.exports = helloWorldContent;
 ```
 
+```json5 fileName="hello-world.es.content.json" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "hello-world",
+  "locale": "es", // Importante
+  "content": {
+    "multilingualContent": "Título de mi componente",
+  },
+}
+```
+
 ```json fileName="hello-world.content.ts" contentDeclarationFormat="json"
 {
   "$schema": "https://intlayer.org/schema.json",
@@ -95,6 +106,8 @@ module.exports = helloWorldContent;
 
 > Recomendado: Este formato es el mejor cuando se utiliza el editor visual de Intlayer o se gestionan las traducciones directamente en el código.
 
+> Nota: En ambos casos, el archivo de declaración de contenido debe seguir el patrón de nomenclatura `*.content.{ts,tsx,js,jsx,mjs,cjs,json}` para ser reconocido por Intlayer. El sufijo `.[locale]` es opcional y se utiliza solo como una convención de nomenclatura.
+
 ### Configuración global para archivos por locale
 
 Puedes configurar la configuración global para archivos por locale agregando lo siguiente a tu archivo `intlayer.config.ts`:
@@ -146,17 +159,6 @@ const helloWorldContent = {
 export default helloWorldContent;
 ```
 
-```json5 fileName="hello-world.en.content.json" contentDeclarationFormat="json"
-{
-  "$schema": "https://intlayer.org/schema.json",
-  "key": "hello-world",
-  "locale": "en", // Importante
-  "content": {
-    "multilingualContent": "Título de mi componente",
-  },
-}
-```
-
 ```json5 fileName="hello-world.es.content.json" contentDeclarationFormat="json"
 {
   "$schema": "https://intlayer.org/schema.json",
@@ -170,8 +172,6 @@ export default helloWorldContent;
 
 > Importante: Asegúrate de que el campo locale esté definido. Indica a Intlayer qué idioma representa el archivo.
 
-> Nota: En ambos casos, el archivo de declaración de contenido debe seguir el patrón de nombres `*.content.{ts,tsx,js,jsx,mjs,cjs,json}` para ser reconocido por Intlayer. El sufijo `.[locale]` es opcional y se usa solo como convención de nombres.
-
 ## Mezclando formatos
 
 Puedes combinar ambos enfoques de declaración para la misma clave de contenido. Por ejemplo:

package/docs/es/readme.md

@@ -225,8 +225,8 @@ Explore nuestra documentación completa para comenzar con Intlayer y aprender c
   <li><a href="https://intlayer.org/doc/environment/vite-and-vue" rel=''>Vite + Vue</a></li>
   <li><a href="https://intlayer.org/doc/environment/nuxt-and-vue" rel=''>Vite + Nuxt</a></li>
   <li><a href="https://intlayer.org/doc/environment/vite-and-solid" rel=''>Vite + Solid</a></li>
-  <li><a href="https://intlayer.org/doc/environment/angular" rel=''>Angular</a></li>
-  <li>
+  <li><a href="https://intlayer.org/doc/environment/solid-start" rel=''>Solid Start</a></li>
+  <li><a href="https://intlayer.org/doc/environment/angular" rel=''>Angular</a></li>  <li>
      <a href="https://intlayer.org/doc/environment/express" rel=''>Backend</a>
      <ul>
       <li><a href="https://intlayer.org/doc/environment/express" rel=''>Express</a></li>
@@ -234,6 +234,7 @@ Explore nuestra documentación completa para comenzar con Intlayer y aprender c
       <li><a href="https://intlayer.org/doc/environment/fastify" rel=''>Fastify</a></li>
       <li><a href="https://intlayer.org/doc/environment/adonisjs" rel=''>AdonisJS</a></li>
       <li><a href="https://intlayer.org/doc/environment/hono" rel=''>Hono</a></li>
+      <li><a href="https://intlayer.org/doc/environment/elysia" rel=''>Elysia</a></li>
     </ul>
   </li>
 </ul>

package/docs/es/releases/v6.md

@@ -118,6 +118,8 @@ export default config;
 
 Aún puedes ajustar por diccionario usando el campo `autoFill` en los archivos de contenido. Consulta la referencia completa en `doc/autoFill` y `doc/dictionary/content_file`.
 
+Aún puedes ajustar por diccionario usando el campo `autoFill` en archivos de contenido. Intlayer primero considerará la configuración por diccionario y luego recurrirá a la configuración global. Consulta la referencia completa en [Auto-fill](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/autoFill.md) y [Referencia de archivo de contenido](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dictionary/content_file.md).
+
 ---
 
 ## Comando fill: valores predeterminados más seguros
@@ -169,6 +171,12 @@ La extensión ahora incluye una pestaña dedicada de Intlayer en la Barra de Act
 - Barra de herramientas en la vista de Diccionarios: Construir, Extraer (Pull), Enviar (Push), Rellenar, Actualizar, Probar, Crear archivo de diccionario
 - Menús contextuales: Extraer/Enviar en diccionarios; Rellenar en archivos
 
+Consulta los detalles en la documentación de la [Extensión Oficial de VS Code](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/vs_code_extension.md).
+
+---
+
+Se actualizó el servidor MCP para admitir las nuevas funciones.
+
 - Auto-revelación: el archivo actual del editor se resalta en el árbol de Diccionarios cuando es aplicable
 - Nuevos comandos disponibles desde la Paleta de Comandos: Rellenar Diccionarios y Probar Diccionarios
 
@@ -297,8 +305,6 @@ Notas:
 
 Consulta [CMS y sincronización en vivo](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_CMS.md) y [Configuración](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/configuration.md) para obtener una guía completa.
 
----
-
 ## Proceso paralelo para monitorear archivos en turbopack
 
 Al usar Turbopack en Next.js 14 y superior como tu servidor de desarrollo con el comando `next dev --turbopack`, los cambios en el diccionario no se detectarán automáticamente de forma predeterminada.

package/docs/es/releases/v9.md

@@ -370,6 +370,8 @@ curl -fsSL https://intlayer.org/install.sh | sh
 
 El instalador descarga un `docker-compose.yml` y un `.env`, genera automáticamente los secretos necesarios y ejecuta `docker compose up -d`. Todo — el panel de control, la API, la base de datos, el almacenamiento de objetos y el correo electrónico transaccional — se ejecuta localmente en contenedores.
 
+---
+
 ## Notas de migración desde v8
 
 Si estás actualizando desde v8, ten en cuenta que la v9 no incluye cambios disruptivos. Pero aquí están los cambios clave:

package/docs/es/self_hosting.md

@@ -21,12 +21,16 @@ author: aymericzip
 
 Intlayer puede ejecutarse completamente en tu propia infraestructura, sin necesidad de una cuenta de Intlayer Cloud. Un solo comando inicia una pila lista para producción:
 
+Un comando instala todo:
+
 ```sh
 curl -fsSL https://intlayer.org/install.sh | sh
 ```
 
 El instalador descarga un `docker-compose.yml` y un `.env`, autogenera los secretos necesarios e inicia todos los contenedores con `docker compose up -d`.
 
+La única dependencia externa es **MongoDB**: el backend se conecta a un cluster de MongoDB **Atlas**, que proporcionas. Todo lo demás se ejecuta dentro del contenedor.
+
 ## Tabla de Contenidos
 
 <TOC/>
@@ -60,23 +64,77 @@ Chromium (utilizado para la generación de capturas de pantalla de Puppeteer) se
 - Puertos `3000`, `3100`, `8025`, `9000` y `9001` disponibles en el host.
 - Un host Linux o macOS (o WSL2 en Windows).
 
+Todo lo demás — Bun, Redis, MinIO, Chromium — se incluye dentro de la imagen.
+
 ---
 
 ## Inicio rápido
 
+### 1. Ejecutar el instalador
+
 ```sh
 curl -fsSL https://intlayer.org/install.sh | sh
 ```
 
-Lo que hace el instalador:
+Verifica que Docker esté instalado y en ejecución, escribe `./intlayer.env` con `BETTER_AUTH_SECRET` y `S3_SECRET_ACCESS_KEY` ya generadas, y descarga la imagen. No inicia el contenedor — el backend no puede arrancar sin tus credenciales de base de datos.
+
+Ejecutar nuevamente el instalador es seguro: un `intlayer.env` existente nunca se sobrescribe, por lo que también sirve como ruta de actualización.
+
+### 2. Rellena tus credenciales
+
+Abre `intlayer.env` y completa los valores marcados como `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>
+```
+
+El archivo también contiene bloques comentados para las características opcionales — [SMTP mailer](#global-mailer), `OPENAI_API_KEY` y los proveedores de OAuth. Descomenta lo que necesites.
+
+> El archivo se lee mediante `docker run --env-file`, que no elimina las comillas y trata todo después de `=` como el valor. Escribe valores sin comillas y mantén los comentarios en sus propias líneas.
+
+### 3. Inicia el container
+
+Este es el comando que el instalador imprime cuando finaliza:
+
+```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 \
+  --env-file ./intlayer.env \
+  ghcr.io/aymericzip/intlayer-selfhost:latest
+```
+
+Luego abre **http://localhost:3000**. El primer inicio inicializa los almacenes de datos, así que espera un minuto.
+
+> El panel de control se sirve en `localhost`. Ver [Limitaciones](#limitations) — los dominios personalizados no son compatibles con la imagen publicada.
 
-1.  Verifica que `docker` y `docker compose` estén presentes.
-2.  Descarga `docker-compose.yml` y `.env.example` en `./intlayer/`.
-3.  Si no existe un `.env`, copia el ejemplo y genera secretos aleatorios para `BETTER_AUTH_SECRET`, `S3_ACCESS_KEY_ID` y `S3_SECRET_ACCESS_KEY` a través de `openssl rand`.
-4.  Ejecuta `docker compose pull` + `docker compose up -d`.
-5.  Imprime las URLs: dashboard `:3000`, API `:3100`, interfaz de usuario de correo electrónico `:8025`, consola de MinIO `:9001`.
+### Configuración del instalador
 
-Una vez que la pila esté en funcionamiento, abre **http://localhost:3000** y crea tu primera cuenta.
+El instalador lee algunas variables de entorno. Dado que se canaliza en `sh`, pásalas al shell en lugar de a `curl`:
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | INTLAYER_ENV_FILE=./config/intlayer.env sh
+```
+
+| Variable                  | Default                                       | Descripción                           |
+| ------------------------- | --------------------------------------------- | ------------------------------------- |
+| `INTLAYER_IMAGE`          | `ghcr.io/aymericzip/intlayer-selfhost:latest` | Imagen a descargar                    |
+| `INTLAYER_ENV_FILE`       | `./intlayer.env`                              | Dónde escribir el archivo env         |
+| `INTLAYER_CONTAINER_NAME` | `intlayer`                                    | Nombre del contenedor                 |
+| `INTLAYER_DATA_VOLUME`    | `intlayer-data`                               | Volumen nombrado montado en `/data`   |
+| `INTLAYER_APP_PORT`       | `3000`                                        | Puerto del host para el dashboard     |
+| `INTLAYER_API_PORT`       | `3100`                                        | Puerto del host para la API           |
+| `INTLAYER_S3_PORT`        | `9000`                                        | Puerto del host para la API MinIO S3  |
+| `INTLAYER_CONSOLE_PORT`   | `9001`                                        | Puerto del host para la consola MinIO |
+
+> Las cuatro variables de puerto solo cambian el lado del **host** del mapeo impreso en el comando `docker run`. La imagen publicada tiene `http://localhost:3000`, `http://localhost:3100` y `http://localhost:9000` compilados en el bundle del dashboard en el momento de la compilación, por lo que reasignarlos deja el navegador apuntando a los puertos antiguos. Mantén los valores predeterminados a menos que estés construyendo tu propia imagen — consulta [Limitaciones](#limitations).
 
 ---
 
@@ -103,8 +161,6 @@ Una vez que existe un admin, `/init` redirige a la página estándar de inicio d
 | **minio**   | `minio/minio`                              | `9000` (S3), `9001` (consola)        | Almacenamiento de objetos compatible con S3 para avatares y capturas de pantalla |
 | **mailpit** | `axllent/mailpit`                          | `1025` (SMTP), `8025` (interfaz web) | Receptor local de correos electrónicos transaccionales                           |
 
-Los puertos internos (mongo, redis) no se exponen al host por defecto.
-
 > El puerto `9000` de MinIO debe ser accesible desde el navegador porque los activos cargados (avatares, capturas de pantalla) se cargan directamente desde `S3_PUBLIC_URL=http://localhost:9000/intlayer`.
 
 ---
@@ -160,8 +216,6 @@ Los puertos internos (mongo, redis) no se exponen al host por defecto.
 | `LINKEDIN_CLIENT_ID`, `LINKEDIN_CLIENT_SECRET`           | Inicio de sesión LinkedIn OAuth                                                         |
 | `ATLASSIAN_CLIENT_ID`, `ATLASSIAN_CLIENT_SECRET`         | Inicio de sesión Atlassian OAuth                                                        |
 
----
-
 ### Servicio de correo global
 
 De forma predeterminada, todos los correos electrónicos transaccionales se envían a través de Resend utilizando `RESEND_API_KEY`. Los despliegues auto-hospedados pueden enrutar **todos** los correos electrónicos — incluyendo correos no organizacionales como restablecimiento de contraseña y enlaces mágicos — a través de un servicio de correo global configurado con variables de entorno.
@@ -247,16 +301,8 @@ const { data: dictionaries } = await dictionaryEndpoint(cms).getDictionaries();
 
 ## Actualización
 
-Volver a ejecutar el instalador en un despliegue existente realiza una actualización continua:
-
-```sh
-curl -fsSL https://intlayer.org/install.sh | sh
-```
-
 Esto descarga las últimas imágenes y reinicia los contenedores con `docker compose pull && docker compose up -d`. Los volúmenes existentes (`mongo-data`, `redis-data`, `minio-data`) se conservan, sin pérdida de datos.
 
-Para actualizar manualmente desde el directorio `./intlayer/`:
-
 ```sh
 docker compose pull
 docker compose up -d
@@ -320,15 +366,12 @@ docker compose logs mongo
 docker compose logs redis
 ```
 
+Busca `MongoDB connection error` cerca de la parte superior del log.
+
 ### El dashboard no puede conectar con la API
 
 Verifica que `VITE_BACKEND_URL` coincida con la URL donde el backend es accesible desde el **navegador** (no desde la red de Docker). Si cambiaste el puerto del backend o añadiste un proxy inverso, reconstruye la imagen del dashboard:
 
-```sh
-docker compose build app
-docker compose up -d app
-```
-
 ### Falta el bucket de MinIO
 
 Si el servicio de un solo uso `minio-init` no se ejecutó (o se ejecutó antes de que MinIO estuviera listo), crea el bucket manualmente:

package/docs/fr/CI_CD.md

@@ -170,6 +170,8 @@ jobs:
           labels: translation, automated
 ```
 
+Pour configurer les variables d'environnement, allez sur GitHub → Settings → Secrets and variables → Actions et ajoutez le secret.
+
 > Comme pour Husky, dans le cas d'un monorepo, vous pouvez utiliser l'argument `--base-dir` pour traiter séquentiellement chaque application.
 
 > Par défaut, l'argument `--git-diff` filtre les dictionnaires qui incluent les modifications de la base (par défaut `origin/main`) vers la branche courante (par défaut : `HEAD`).

package/docs/fr/agent_skills.md

@@ -1,11 +1,11 @@
 ---
 createdAt: 2026-02-09
 updatedAt: 2026-03-03
-title: Compétences de l'agent
-description: Apprenez à utiliser les compétences de l'agent Intlayer pour améliorer la compréhension de votre projet par votre agent IA, y compris des guides complets pour les métadonnées, les sitemaps et les actions serveur.
+title: Agent Skills
+description: Apprenez à utiliser les Agent Skills Intlayer pour améliorer la compréhension de votre projet par votre agent IA, y compris des guides complets pour les métadonnées, les sitemaps et les actions serveur.
 keywords:
   - Intlayer
-  - Compétences de l'agent
+  - Agent Skills
   - Agent IA
   - Internationalisation
   - Documentation
@@ -19,13 +19,13 @@ history:
 author: aymericzip
 ---
 
-# Compétences de l'agent
+# Agent Skills
 
 ## Configuration
 
 ### Utilisation de la CLI
 
-La commande `intlayer init skills` est le moyen le plus simple de configurer les compétences de l'agent dans votre projet. Elle détecte votre environnement et installe les fichiers de configuration nécessaires pour vos plateformes préférées.
+La commande `intlayer init skills` est le moyen le plus simple de configurer les Agent Skills dans votre projet. Elle détecte votre environnement et installe les fichiers de configuration nécessaires pour vos plateformes préférées.
 
 ```bash packageManager="npm"
 npx intlayer init skills
@@ -54,10 +54,10 @@ npx skills add aymericzip/intlayer-skills
 1. Ouvrez la palette de commandes (Ctrl+Maj+P ou Cmd+Maj+P).
 2. Tapez `Intlayer: Setup AI Agent Skills`
 3. Choisissez la plateforme que vous utilisez (par ex. `VS Code`, `Cursor`, `Windsurf`, `OpenCode`, `Claude Code`, `GitHub Copilot Workspace`, etc.).
-4. Choisissez les compétences que vous souhaitez installer (par ex. `Next.js`, `React`, `Vite`, `Compiler`, `Configuration`).
+4. Choisissez les Agent Skills que vous souhaitez installer (par ex. `Next.js`, `React`, `Vite`, `Compiler`, `Configuration`).
 5. Appuyez sur Entrée.
 
-## Liste des compétences
+## Liste des Agent Skills
 
 **intlayer-config**
 

package/docs/fr/analytics.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-07-08
-updatedAt: 2026-07-08
+updatedAt: 2026-08-22
 title: Analytique Intlayer | Suivre l'exposition du contenu et exécuter des tests A/B
 description: Découvrez comment @intlayer/analytics suit les vues de pages/locales et l'exposition du contenu, et comment l'utiliser pour exécuter des tests A/B sur votre contenu Intlayer.
 keywords:
@@ -18,6 +18,9 @@ slugs:
   - concept
   - analytics
 history:
+  - version: 9.3.3
+    date: 2026-08-22
+    changes: "Activer les analytics par défaut dès que `@intlayer/analytics` est installé"
   - version: 9.0.0
     date: 2026-07-08
     changes: "Init doc — package @intlayer/analytics, suivi au niveau du provider/node, tests A/B, dashboard"
@@ -57,7 +60,7 @@ Intlayer vous permet déjà de déclarer des [Variantes](https://github.com/ayme
 
 ## Installation
 
-`@intlayer/analytics` est une dépendance **peer, optionnelle** — jamais installée automatiquement par un package de framework. Ajoutez-la aux côtés de `intlayer` :
+`@intlayer/analytics` est une **dépendance optionnelle** de chaque package de framework (`react-intlayer`, `next-intlayer`, `vue-intlayer`, …) : la plupart des projets l'ont donc déjà. Installez-la explicitement si votre configuration ignore les dépendances optionnelles (`npm install --no-optional`, …) :
 
 ```bash packageManager="npm"
 npm install @intlayer/analytics
@@ -75,11 +78,11 @@ pnpm add @intlayer/analytics
 bun add @intlayer/analytics
 ```
 
-Si vous ne l'installez pas, chaque point d'intégration se résout en une opération vide (no-op) — voir [Zéro coût quand non installé](#zero-cout-quand-non-installe) ci-dessous.
+Installer le package suffit à activer l'analytique : `analytics.enabled` vaut `true` par défaut, et `@intlayer/config` le résout à `false` dès que le package est introuvable dans votre projet. Si vous ne l'installez pas, chaque point d'intégration se résout en une opération vide (no-op) — voir [Zéro coût quand non installé](#zero-cout-quand-non-installe) ci-dessous.
 
 ## Configuration
 
-Analytics **réutilise le bloc de configuration `editor` existant** — il n'y a pas de schéma de configuration `analytics` séparé à remplir :
+L'analytique ne nécessite aucune configuration pour démarrer : elle est **activée par défaut** et **réutilise le bloc de configuration `editor` existant** pour son endpoint et sa clé de projet.
 
 ```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import type { IntlayerConfig } from "intlayer";
@@ -100,16 +103,25 @@ export default config;
 
 Si vous auto-hébergez (self-host) Intlayer, l'analytique pointe automatiquement vers votre propre instance puisqu'elle partage `editor.backendURL`.
 
-## Support des frameworks
+### Désactiver l'analytique
 
-Analytics est intégré dans le `IntlayerProvider` partagé de `react-intlayer`, il est donc disponible dès aujourd'hui partout où ce provider est utilisé :
+Le bloc optionnel `analytics` permet d'ajuster — ou de désactiver — la collecte :
 
-| Framework                                                | Statut                                                                                                           |
-| -------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
-| React                                                    | ✅ Disponible                                                                                                    |
-| Next.js (`next-intlayer`)                                | ✅ Disponible (via `react-intlayer`)                                                                             |
-| React Native / Expo (`react-native-intlayer`)            | ✅ Disponible (via `react-intlayer`)                                                                             |
-| Vue, Svelte, Angular, Solid, Preact, Lit, Astro, Vanilla | 🚧 Planifié — même client, liaisons au niveau du provider suivant le modèle de déploiement de `@intlayer/editor` |
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  analytics: {
+    enabled: false, // Par défaut : true — exclut toute l'intégration du bundle
+    flushInterval: 20_000, // Millisecondes entre deux envois groupés
+    sampleRate: 1, // Fraction des sessions enregistrées, de 0 (aucune) à 1 (toutes)
+  },
+};
+
+export default config;
+```
+
+Désinstaller `@intlayer/analytics` produit le même effet que `enabled: false`. Consultez la [référence de configuration](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/configuration.md) pour la liste complète des champs.
 
 ## Utilisation
 
@@ -154,6 +166,56 @@ const CTAButton = () => {
 
 ### Résolution d'une variante côté client
 
+  </Tab>
+  <Tab label="Angular" value="angular">
+
+`variant` et `isAssigned` sont des `Signal`s — appelez-les pour lire la valeur.
+
+    ```typescript fileName="hero.component.ts"
+    import { Component } from "@angular/core";
+    import { useExperiment } from "angular-intlayer";
+    import { HeroBannerComponent } from "./hero-banner.component";
+
+    @Component({
+      selector: "app-hero",
+      imports: [HeroBannerComponent],
+      template: `@if (experiment.isAssigned()) {
+        <app-hero-banner [variant]="experiment.variant()" />
+      }`,
+    })
+    export class HeroComponent {
+      experiment = useExperiment("homepage-hero", ["default", "black_friday"]);
+    }
+    ```
+
+  </Tab>
+</Tabs>
+
+Les poids sont optionnels — passez-en un par variante pour biaiser la répartition, par exemple `useExperiment("homepage-hero", ["default", "black_friday"], [9, 1])`.
+
+L'enfant lit ensuite la [Variante](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/dynamic_dictionaries/variants.md) du dictionnaire qui correspond :
+
+```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>
+  );
+};
+```
+
+> Lire la variante dans un **composant enfant** est ce qui fait que cela fonctionne en dehors de React : dans Vue, Svelte, Solid et Angular, le sélecteur passé à `useIntlayer` est capturé lors de la configuration du composant, donc la lecture doit se faire dans un composant qui ne se monte qu'une fois la variante connue.
+
+Si l'expérience couvre une page entière plutôt qu'un seul dictionnaire, remontez la variante sur le fournisseur à la place — voir [Variante ambiante](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/dynamic_dictionaries/variants.md#ambient-variant). Chaque `useIntlayer` ci-dessous se résout alors contre celle-ci sans modification du site d'appel.
+
+Si vous avez besoin de l'assignment brut en dehors d'un composant, accédez directement au client :
+
 ```tsx fileName="useHeroVariant.ts" codeFormat="tsx"
 import { getGlobalAnalyticsClient } from "@intlayer/analytics/client";
 
@@ -164,6 +226,8 @@ const variant = client?.getVariant("homepage-hero", [
 ]);
 ```
 
+> `getVariant` assigne uniquement — il n'enregistre pas l'exposition. Préférez `useExperiment()`, sinon le taux de conversion n'a pas de dénominateur.
+
 ## Confidentialité & performance
 
 - **Anonyme par conception** : les sessions sont identifiées par un ID rotatif ; le backend ne stocke jamais qu'un **hash SHA-256** de cet ID — jamais l'ID brut, jamais une adresse IP.
@@ -177,7 +241,7 @@ const variant = client?.getVariant("homepage-hero", [
 `@intlayer/analytics` suit exactement le même modèle de dépendance optionnelle que `@intlayer/editor` :
 
 - chaque point d'intégration charge le package via un **`import()` dynamique enveloppé dans un `try/catch`** — une application qui n'installe jamais `@intlayer/analytics` ne paie aucun coût en taille de bundle ou à l'exécution, et ne voit jamais d'erreur ;
-- une variable d'environnement au moment de la compilation (`INTLAYER_ANALYTICS_ENABLED`), définie automatiquement à `'false'` par `@intlayer/config` chaque fois que `editor.clientId` n'est pas configuré, permet aux bundlers d'**éliminer le code mort (dead-code-eliminate)** de toute l'intégration ;
+- une variable d'environnement au moment de la compilation (`INTLAYER_ANALYTICS_ENABLED`), définie automatiquement à `'false'` par `@intlayer/config` dès que le package n'est pas installé, que `analytics.enabled` vaut `false` ou que `editor.clientId` n'est pas configuré, permet aux bundlers d'**éliminer le code mort (dead-code-eliminate)** de toute l'intégration ;
 - l'analytique est désactivée à l'intérieur de l'iframe de prévisualisation de l'éditeur/CMS Intlayer, afin que les sessions d'éditeur ne soient jamais comptées comme du vrai trafic.
 
 ## Tableau de bord : Page Analytique
@@ -213,6 +277,8 @@ const cms = createIntlayerCMS();
 const { data: audience } = await analyticsEndpoint(cms).getAudience(30);
 ```
 
+> **Côté serveur uniquement.** `createIntlayerCMS()` s'authentifie avec `clientId` + `clientSecret`, et le secret n'est jamais disponible dans le navigateur — ce snippet émettrait des requêtes non authentifiées s'il s'exécutait là. Conservez-le dans un gestionnaire de route, une action serveur ou un script.
+
 ## Liens utiles
 
 - [Dictionnaires dynamiques - Collections et variantes](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/dynamic_dictionaries/index.md)

package/docs/fr/benchmark/tanstack.md

@@ -194,6 +194,8 @@ L'idée derrière `Wuchale` est intéressante mais ce n'est pas encore une solut
 
 `Tolgee` traite bon nombre des problèmes mentionnés plus haut. Je l'ai trouvé plus difficile à prendre en main que d'autres outils aux approches similaires. Il n'offre pas de sécurité de type, ce qui rend également beaucoup plus difficile la détection des clés manquantes à la compilation. J'ai dû wrapper les APIs de Tolgee avec les miennes pour ajouter la détection des clés manquantes.
 
+Le package est assez lourd (~11.1kb, ce qui est plus de 2× `react-intlayer`).
+
 Sur TanStack Start, j'ai également eu des problèmes de réactivité : au changement de locale, je devais forcer le provider à se re-rendre et souscrire aux événements de changement de locale pour que le chargement dans une autre langue se comporte correctement.
 
 **(next-intl)** (`next-intl@4.9.1`) :
@@ -208,6 +210,8 @@ Sur TanStack Start, vous évitez les pièges spécifiques à Next.js (`setReques
 
 Pourtant, elle partage les mêmes inconvénients majeurs que les stacks basées sur `t('a.b.c')` : les optimisations sont possibles mais très gourmandes en temps, et les gros projets risquent de mauvaises pratiques (namespaces + chargement dynamique + types).
 
+Le package est particulièrement lourd (~17.3kb, ce qui représente environ 3.5× `react-intlayer`).
+
 Les formats de messages divergent également : `next-intl` utilise ICU MessageFormat, tandis qu'i18next utilise son propre format - ce qui complique l'outillage ou les migrations si vous les mélangez.
 
 **(Lingui)** (`@lingui/core@5.3.0`) :
@@ -218,6 +222,8 @@ Les formats de messages divergent également : `next-intl` utilise ICU MessageFo
 
 `react-intl` est une implémentation performante de l'équipe Format.js. La DX reste verbeuse : `const intl = useIntl()` + `intl.formatMessage({ id: "xx.xx" })` ajoute de la complexité, du travail JavaScript supplémentaire et lie l'instance globale i18n à de nombreux nœuds dans l'arbre React.
 
+Le package est également volumineux (~14.4kb, soit environ 3× `react-intlayer`).
+
 ### 4 - Recommandations
 
 Ce benchmark TanStack Start n'a pas d'équivalent direct à `next-translate` (plugin Next.js + `getStaticProps`). Pour les équipes qui veulent vraiment une API `t()` avec un écosystème mature, `react-i18next` et `next-intl` restent des choix "raisonnables", mais attendez-vous à investir beaucoup de temps dans l'optimisation pour éviter les fuites.

package/docs/fr/bundle_optimization.md

@@ -476,7 +476,7 @@ const config: IntlayerConfig = {
 export default config;
 ```
 
-> La minification est ignorée lorsque `optimize` est `false` ou lorsque `editor.enabled` est `true` (l'éditeur visuel requiert les noms de champs originaux pour permettre l'édition).
+> La minification est ignorée lorsque `optimize` est `false`. Lorsque `editor.enabled` est `true`, elle s'exécute toujours, mais sans l'étape de renommage des champs — l'éditeur visuel résout les modifications via `keyPath`, donc les noms de champs originaux doivent être conservés.
 
 > Sur Next.js, la minification est également ignorée lorsque `@intlayer/swc` n'est pas installé ou ne peut pas être chargé (Next.js inférieur à 16.1.0). Le plugin est la moitié qui réécrit les accès dans le source : renommer les dictionnaires sans lui laisserait votre code lire des noms de champs qui n'existent plus.
 
@@ -508,7 +508,7 @@ export default config;
 { "title": "…", "subtitle": "…" }
 ```
 
-> La purge est ignorée lorsque `optimize` est `false` ou lorsque `editor.enabled` est `true`. Sur Next.js, elle est en outre ignorée lorsque `@intlayer/swc` est indisponible, ainsi que lorsque des appelants d'adaptateurs de compatibilité sont configurés.
+> La purge est ignorée lorsque `optimize` est `false`. Elle reste active lorsque `editor.enabled` est `true` — un champ purgé n'est lu par aucun composant, donc l'éditeur ne le rend jamais. Sur Next.js, elle est en outre ignorée lorsque `@intlayer/swc` est indisponible, ainsi que lorsque des appelants d'adaptateurs de compatibilité sont configurés.
 
 > La purge est également ignorée de manière conservative lorsqu'un fichier source ne peut pas être analysé, ou lorsque le résultat de `useIntlayer` est assigné à une variable et transmis de manières que l'analyseur statique ne peut pas suivre (par ex. propagation dans un objet, passé en tant que prop sans déstructuration). Dans ces cas, le dictionnaire complet est conservé.