@intlayer/docs 9.4.0-canary.0 → 9.4.1

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

@@ -123,17 +123,6 @@ 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.
 
-## Support des frameworks
-
-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é :
-
-| 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` |
-
 ## Utilisation
 
 ### Suivi automatique au niveau du provider
@@ -177,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";
 
@@ -187,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.
@@ -236,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/cli/ci.md

@@ -128,6 +128,8 @@ bun x intlayer ci fill --verbose --mode complete
 
 ### Utilisation dans les pipelines CI/CD
 
+L'exécution de `intlayer init` crée deux workflows GitHub Actions prêts à l'emploi pour vous (voir [Scaffolded GitHub Actions](#scaffolded-github-actions) ci-dessous). L'exemple ici montre la configuration équivalente en utilisant la commande `ci` pour un monorepo, où les credentials sont injectés par projet depuis `INTLAYER_PROJECT_CREDENTIALS`.
+
 Dans votre configuration CI/CD (par exemple, GitHub Actions, GitLab CI), définissez `INTLAYER_PROJECT_CREDENTIALS` comme secret :
 
 ```yaml

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

@@ -91,7 +91,13 @@ Pour la plupart des cas d'utilisation,
 
 - **`--log`** : Mode journalisation uniquement. Ne traduit pas avec l'IA ; à la place, journalise les blocs qui nécessitent une attention (avec les numéros de ligne et le contenu) pour les locales de base et cibles, afin d'aider un autre agent à générer les traductions.
 
-  > Exemple : `npx intlayer doc review --log`
+Je suis prêt à effectuer l'audit de traduction. Cependant, je n'ai pas encore reçu :
+
+> Exemple: `npx intlayer doc review --mode report`
+
+> Exemple : `npx intlayer doc review --log`
+
+Quel que soit le mode, l'exécution se termine par une synthèse listant les documents alignés avec leur document de base et ceux qui ont encore des blocs à modifier.
 
 **Options de sortie des entrées :**
 

package/docs/fr/cli/fill.md

@@ -39,14 +39,6 @@ bun x intlayer fill
 
 Cette commande analyse vos fichiers de déclaration de contenu pour détecter d’éventuels problèmes tels que des traductions manquantes, des incohérences structurelles ou des incompatibilités de types. Si elle trouve des problèmes, **intlayer fill** proposera ou appliquera des mises à jour pour garder vos dictionnaires cohérents et complets.
 
-Points clés :
-
-- Divise les grands fichiers JSON en morceaux pour rester dans les limites de la fenêtre de contexte du modèle d'IA.
-- Réessaie la traduction si le format de sortie est incorrect.
-- Intègre le contexte spécifique à l'application et au fichier pour améliorer la précision de la traduction.
-- Préserve les traductions existantes en ne les écrasant pas.
-- Traite les fichiers, les morceaux et les locales en parallèle à l'aide d'un système de file d'attente pour augmenter la vitesse.
-
 ## Points clés :
 
 - Divise les fichiers JSON volumineux en chunks pour rester dans les limites de la fenêtre contextuelle du modèle d'IA.

package/docs/fr/cli/index.md

@@ -127,6 +127,8 @@ Pour voir comment configurer les locales disponibles ou d'autres paramètres, re
 
 - **[Connexion](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/cli/login.md)** - S'authentifier auprès du CMS Intlayer et obtenir les identifiants d'accès
 
+> `intlayer login` génère une **clé d'accès** (`clientId` / `clientSecret`) que chaque commande authentifiée utilise. Le secret est une credential côté serveur et n'atteint jamais votre client bundle — voir [Keeping the access key safe](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/cli/login.md#keeping-the-access-key-safe).
+
 ### Commandes principales
 
 - **[Build de dictionnaires](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/cli/build.md)** - Construisez vos dictionnaires à partir des fichiers de déclaration de contenu

package/docs/fr/cli/list_projects.md

@@ -52,8 +52,6 @@ Cette commande recherche et liste tous les projets Intlayer en trouvant les rép
 
   > Exemple : `npx intlayer projects list --base-dir /path/to/workspace`
 
-  > Exemple : `npx intlayer projects list --base-dir /path/to/workspace`
-
 - **`--git-root`** : Rechercher à partir du répertoire racine git au lieu du répertoire de base. Ceci est utile pour trouver tous les projets Intlayer dans un monorepo ou un dépôt git.
 
   > Exemple : `npx intlayer projects list --git-root`

package/docs/fr/cli/login.md

@@ -122,6 +122,34 @@ INTLAYER_CLIENT_SECRET=your_client_secret
 }
 ```
 
+## Conserver la clé d'accès en sécurité
+
+`intlayer login` émet une **clé d'accès** : une paire `clientId` / `clientSecret` que chaque commande authentifiée (`push`, `pull`, `fill`, `configuration push`, `live`, …) utilise pour s'authentifier.
+
+```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` est une credential côté serveur.** Elle accorde un accès API complet avec portée projet — lecture et écriture de vos dictionnaires, votre projet et votre organisation. Conservez-la dans `.env` (ignorée par git) ou votre stockage secret CI, et ne l'insérez jamais en dur dans le fichier de configuration.
+
+Intlayer force cela plutôt que de simplement le documenter :
+
+- `clientSecret` est **supprimée de la configuration que votre bundler inline**, elle ne peut donc pas atteindre un bundle navigateur quel que soit l'intégration de framework que vous utilisez. Elle n'est lue que côté serveur, au runtime, depuis l'environnement.
+- `clientId` est différente : c'est la **clé publique** du projet, sûre à déployer, et utilisée par [`@intlayer/analytics`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/analytics.md#how-events-are-authenticated) pour obtenir un token à courte durée de vie, réservé à l'ingestion.
+
+Commenter `clientId` suffit pour désactiver tout comportement authentifié — récupération de dictionnaire distant, accès CMS, analytics — même quand les variables d'environnement sont toujours définies.
+
+Pour les pipelines CI, préférez la [`commande ci`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/cli/ci.md), qui injecte les credentials pour la durée d'une seule exécution au lieu de les persister.
+
 ## Configuration manuelle
 
 Si le navigateur ne s'ouvre pas automatiquement, vous pouvez visiter manuellement l'URL affichée dans le terminal.

package/docs/fr/compiler.md

@@ -40,6 +40,12 @@ Le **Intlayer Compiler** est un outil puissant conçu pour automatiser le proces
 
 ## Pourquoi utiliser le Intlayer Compiler ?
 
+- **Automation** : Élimine la copie-collage manuelle du contenu dans les dictionnaires.
+
+- **Speed** : Extraction de contenu optimisée garantissant que votre processus de build reste rapide.
+
+- **Developer Experience** : Gardez les déclarations de contenu là où elles sont utilisées, améliorant ainsi la maintenabilité.
+
 - **Automatisation** : Élimine le copier-coller manuel du contenu dans les dictionnaires.
 - **Rapidité** : Extraction de contenu optimisée garantissant que votre processus de build reste rapide.
 - **Expérience développeur** : Gardez les déclarations de contenu là où elles sont utilisées, améliorant ainsi la maintenabilité.
@@ -54,6 +60,8 @@ Bien que le compilateur offre une excellente expérience "fonctionne tout seul",
 - **Ambiguïté heuristique** : Le compilateur doit deviner ce qui est du contenu destiné aux utilisateurs par rapport à la logique de l'application (par exemple, `className="active"`, codes de statut, identifiants de produits). Dans des bases de code complexes, cela peut conduire à de faux positifs ou à des chaînes manquées qui nécessitent des annotations manuelles et des exceptions.
 - **Extraction statique uniquement** : L'extraction basée sur le compilateur repose sur l'analyse statique. Les chaînes qui n'existent qu'à l'exécution (codes d'erreur API, champs CMS, etc.) ne peuvent pas être découvertes ou traduites par le compilateur seul, vous avez donc toujours besoin d'une stratégie i18n d'exécution complémentaire.
 
+- **Extraction statique uniquement** : L'extraction basée sur le compilateur repose sur l'analyse statique. Les chaînes qui n'existent qu'à l'exécution (codes d'erreur API, champs CMS, etc.) ne peuvent pas être découvertes ou traduites par le compilateur seul, vous avez donc besoin d'une stratégie i18n runtime complémentaire.
+
 Pour une comparaison architecturale plus approfondie, consultez l'article de blog [Compiler vs. Declarative i18n](https://github.com/aymericzip/intlayer/blob/main/docs/blog/fr/compiler_vs_declarative_i18n.md).
 
 Comme alternative, pour automatiser votre processus i18n tout en gardant un contrôle total de votre contenu, Intlayer fournit également une commande d'auto-extraction `intlayer extract` (voir la [documentation CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/cli/extract.md)), ou la commande `Intlayer: extract content to Dictionary` de l'extension Intlayer VS Code (voir la [documentation de l'extension VS Code](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/vs_code_extension.md)).
@@ -94,12 +102,18 @@ export default defineConfig({
 });
 ```
 
+> Le plugin autonome `intlayerCompiler()` est toujours exporté pour les configurations avancées. L'enregistrer aux côtés de `intlayer()` est sûr — le compilateur se déduplique lui-même et s'exécute une seule fois.
+
 See complete tutorial: [Intlayer Compiler with Vite+React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_vite+react_compiler.md)
 
 #### Support des frameworks
 
 Le plugin Vite détecte et gère automatiquement différents types de fichiers :
 
+- **React / JSX / TSX** : Géré nativement.
+
+- **Vue** : Requires `@intlayer/vue-compiler`.
+
 - **React / JSX / TSX** : Pris en charge nativement.
 - **Vue** : Nécessite `@intlayer/vue-compiler`.
 - **Svelte** : Nécessite `@intlayer/svelte-compiler`.

package/docs/fr/configuration.md

@@ -739,8 +739,6 @@ Définit les paramètres liés à l'éditeur intégré, y compris le port du ser
 | `liveSyncPort`               | Le port du serveur de synchronisation en direct.                                                                                                                                     | `number`                          | `4000`                              | `4000`                                                                                          |                                                                                                                                                                                                                                                                        |
 | `liveSyncURL`                | L'URL du serveur de synchronisation en direct.                                                                                                                                       | `string`                          | `'http://localhost:{liveSyncPort}'` | `'https://example.com'`                                                                         | Pointe vers localhost par défaut ; peut être changé pour un serveur de synchronisation en direct distant.                                                                                                                                                              |
 
----
-
 ### Configuration des Analytics (Analytics Configuration)
 
 Définit les paramètres liés aux analytics Intlayer : la collecte du contenu réellement affiché aux utilisateurs (pages vues, expositions de contenu) et l'alimentation des tests A/B sur le contenu.
@@ -987,10 +985,15 @@ Ces paramètres sont destinés aux cas d'utilisation avancés et à la configura
 | `configDir`               | Répertoire des fichiers de configuration compilés. | `string` | `'.intlayer/config'`              |         |      |
 | `cacheDir`                | Répertoire des fichiers de cache.                  | `string` | `'.intlayer/cache'`               |         |      |
 
----
-
 ### Configuration du Dictionnaire (Dictionary Configuration)
 
+Paramètres qui contrôlent les opérations du dictionnaire, y compris le comportement de remplissage automatique et la génération de contenu.
+
+Cette configuration de dictionnaire sert deux objectifs principaux :
+
+1. **Valeurs par défaut** : Définir les valeurs par défaut lors de la création de fichiers de déclaration de contenu
+2. **Comportement de secours** : Fournir des valeurs de secours lorsque des champs spécifiques ne sont pas définis, ce qui vous permet de définir le comportement de l'opération dictionnaire globalement
+
 Paramètres contrôlant les opérations de dictionnaire, y compris le comportement de remplissage automatique et la génération de contenu.
 
 | Champ                       | Description                                                                                                                                                      | Type                                                                                                            | Par défaut   | Exemple                                                                                     | Note                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
@@ -1032,8 +1035,6 @@ Paramètres pour personnaliser la sortie des logs d'Intlayer.
 | `mode`   | Indique le mode du logger. | `'default'` &#124; <br/> `'verbose'` &#124; <br/> `'disabled'` | `'default'`     | `'verbose'`             | • `'verbose'`: log plus d'infos pour le débogage.<br/>• `'disabled'`: désactive complètement le logger. |
 | `prefix` | Le préfixe du logger.      | `string`                                                       | `'[intlayer] '` | `'[my custom prefix] '` |                                                                                                         |
 
----
-
 ### Configuration AI
 
 Paramètres qui contrôlent les fonctionnalités IA d'Intlayer, y compris le fournisseur, le modèle et la clé API.
@@ -1073,8 +1074,6 @@ Intlayer supporte plusieurs fournisseurs d'IA pour une flexibilité accrue. Les
 | `baseURL`            | L'URL de base pour l'API IA.                                                                                                                  | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                             | Aucun       | `'https://api.openai.com/v1'` <br/> `'http://localhost:5000'` | Peut pointer vers un point de terminaison d'API IA local ou personnalisé.                                                                                                                                         |
 | `dataSerialization`  | Format de sérialisation des données pour les fonctionnalités IA.                                                                              | `'json'` &#124; <br/> `'toon'`                                                                                                                                                                                                                                                                                                                                                                                                                       | `undefined` | `'toon'`                                                      | • `'json'`: standard, fiable ; utilise plus de tokens.<br/>• `'toon'`: moins de tokens, moins cohérent.<br/>• Des paramètres supplémentaires sont passés au modèle comme contexte (effort de raisonnement, etc.). |
 
----
-
 ### Configuration de Build
 
 Paramètres qui contrôlent comment Intlayer optimise et construit l'internationalisation de votre application.
@@ -1112,8 +1111,6 @@ Paramètres qui contrôlent le compilateur Intlayer, qui extrait les dictionnair
 | `noMetadata`          | Si `true`, le compilateur omet les métadonnées du dictionnaire (clé, wrapper de contenu) de la sortie.                                                                                                                                                                                                                       | `boolean`                                                                                                       | `false`     | `false` → `{"key":"ma-clé","content":{"key":"valeur"}}` <br/> `true` → `{"key":"valeur"}`                                                                | • Utile pour les sorties JSON i18next ou ICU MessageFormat.<br/>• Fonctionne bien avec le plugin `loadJSON`.                                                                                                                                                                                                      |
 | `dictionaryKeyPrefix` | Préfixe de clé de dictionnaire                                                                                                                                                                                                                                                                                               | `string`                                                                                                        | `''`        |                                                                                                                                                          | Ajoute un préfixe optionnel aux clés de dictionnaire extraites                                                                                                                                                                                                                                                    |
 
----
-
 ### Schémas Personnalisés (Custom Schemas)
 
 | Champ     | Description                                                                       | Type                        |

package/docs/fr/custom_domains.md

@@ -138,6 +138,38 @@ getMultilingualUrls("/about", { currentDomain: "intlayer.org" });
 
 Ces URLs absolues sont prêtes à être utilisées dans les balises `<link rel="alternate" hreflang="...">` pour le SEO.
 
+## Inférence de type
+
+`routing.domains` est sérialisé dans l'augmentation de module générée, donc
+`getLocalizedUrl` et `getLocalizedPath` affinent leur type de retour à l'URL exacte
+qu'une locale routée par domaine résout — la suppression du préfixe incluse.
+
+```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"   (jamais une origine, et pas de préfixe /zh/)
+```
+
+Le type URL est l'**union** des deux valeurs que la fonction peut retourner : l'URL
+absolue sur le domaine de la locale, et celle relative qu'elle retourne quand la
+page en cours de rendu vit déjà sur ce domaine. `getLocalizedPath` n'a pas cette
+ambiguïté — elle n'émet jamais une origine — donc elle reste un littéral unique.
+
+Les locales qui partagent un domaine conservent également leur préfixe normal dans le type :
+
+```ts
+getLocalizedUrl("/about", "fr");
+//     ^? "https://intlayer.org/fr/about" | "/fr/about"
+```
+
+> Régénérez les types (`npx intlayer build`, ou n'importe quelle exécution de dev server) après
+> avoir modifié `routing.domains` — l'affinement provient du
+> `__RoutingRegistry` généré, pas du fichier de configuration lui-même.
+
 ## Comportement du Proxy
 
 ### Next.js
@@ -170,6 +202,8 @@ GET intlayer.zh/about
 
 Le plugin Vite `intlayerProxy` applique la même logique pendant le développement :
 
+> Depuis Intlayer v9, `intlayerProxy()` est intégré directement dans le plugin `intlayer()` et activé par défaut via l'option `routing.enableProxy` (`true` par défaut). L'enregistrer séparément comme indiqué ci-dessous est maintenant optionnel — il est conservé pour la compatibilité rétroactive et pour les configurations qui ont besoin de contrôler l'ordre des plugins. Définissez `routing.enableProxy: false` pour refuser. Voir les [notes de version v9](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/releases/v9.md).
+
 ```typescript fileName="vite.config.ts"
 import { defineConfig } from "vite";
 import { intlayer } from "vite-intlayer";

package/docs/fr/custom_url_rewrites.md

@@ -248,7 +248,7 @@ Pour faire en sorte que la barre d'adresse du navigateur reflète toujours l'URL
 
 <Tabs group='framework'>
   <Tab label="Next.js" value="nextjs">
-  
+
     ```tsx
     'use client';
 
@@ -263,7 +263,7 @@ Pour faire en sorte que la barre d'adresse du navigateur reflète toujours l'URL
   </Tab>
 
   <Tab label="React Router" value="reactrouter">
-  
+
     ```tsx
     'use client';
 
@@ -279,7 +279,7 @@ Pour faire en sorte que la barre d'adresse du navigateur reflète toujours l'URL
   </Tab>
 
   <Tab label="Vue" value="vue">
-  
+
     ```vue
     <script setup>
     import { useRewriteURL } from "vue-intlayer";
@@ -291,7 +291,7 @@ Pour faire en sorte que la barre d'adresse du navigateur reflète toujours l'URL
 
   </Tab>
   <Tab label="Solid" value="solid">
-  
+
     ```tsx
     import { useRewriteURL } from "solid-intlayer";
 
@@ -303,7 +303,7 @@ Pour faire en sorte que la barre d'adresse du navigateur reflète toujours l'URL
 
   </Tab>
   <Tab label="Svelte" value="svelte">
-  
+
     ```svelte
     <script>
     import { useRewriteURL } from "svelte-intlayer";
@@ -340,6 +340,8 @@ export function middleware(request: NextRequest) {
 
 Pour SolidJS, Vue et Svelte, le plugin Vite `intlayerProxy` gère les réécritures pendant le développement.
 
+> Depuis Intlayer v9, `intlayerProxy()` est intégré directement dans le plugin `intlayer()` et activé par défaut via l'option `routing.enableProxy` (`true` par défaut). Son enregistrement séparé comme montré ci-dessous est désormais optionnel — il est conservé pour la compatibilité rétroactive et pour les configurations qui ont besoin de contrôler l'ordre des plugins. Définissez `routing.enableProxy: false` pour refuser. Voir les [notes de publication v9](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/releases/v9.md).
+
 ```typescript fileName="vite.config.ts"
 import { defineConfig } from "vite";
 import { intlayer } from "vite-intlayer";