@intlayer/docs 8.4.7 → 8.4.9

package/docs/fr/configuration.md

@@ -16,79 +16,79 @@ slugs:
 history:
   - version: 8.4.0
     date: 2026-03-20
-    changes: Ajout de la notation d'objet par locale pour 'compiler.output' et 'dictionary.fill'
+    changes: "Ajout de la notation d'objet par locale pour 'compiler.output' et 'dictionary.fill'"
   - version: 8.3.0
     date: 2026-03-11
-    changes: Déplacement de 'baseDir' de la configuration 'content' vers la configuration 'system'
+    changes: "Déplacement de 'baseDir' de la configuration 'content' vers la configuration 'system'"
   - version: 8.2.0
     date: 2026-03-09
-    changes: Mise à jour des options du compilateur (compiler), ajout du support pour 'output' et 'noMetadata'
+    changes: "Mise à jour des options du compilateur (compiler), ajout du support pour 'output' et 'noMetadata'"
   - version: 8.1.7
     date: 2026-02-25
-    changes: Mise à jour des options du compilateur
+    changes: "Mise à jour des options du compilateur"
   - version: 8.1.5
     date: 2026-02-23
-    changes: Ajout de l'option de compilateur 'build-only' et du préfixe de dictionnaire
+    changes: "Ajout de l'option de compilateur 'build-only' et du préfixe de dictionnaire"
   - version: 8.0.6
     date: 2026-02-12
-    changes: Ajout du support pour les fournisseurs Open Router, Alibaba, Amazon, Google Vertex Bedrock, Fireworks, Groq, Hugging Face et Together.ai
+    changes: "Ajout du support pour les fournisseurs Open Router, Alibaba, Amazon, Google Vertex Bedrock, Fireworks, Groq, Hugging Face et Together.ai"
   - version: 8.0.5
     date: 2026-02-06
-    changes: Ajout de `dataSerialization` à la configuration AI
+    changes: "Ajout de `dataSerialization` à la configuration AI"
   - version: 8.0.0
     date: 2026-01-24
-    changes: Renommage du mode d'importation `live` en `fetch` pour mieux décrire le mécanisme sous-jacent.
+    changes: "Renommage du mode d'importation `live` en `fetch` pour mieux décrire le mécanisme sous-jacent."
   - version: 8.0.0
     date: 2026-01-22
-    changes: Déplacement de la configuration de build `importMode` vers la configuration `dictionary`.
+    changes: "Déplacement de la configuration de build `importMode` vers la configuration `dictionary`."
   - version: 8.0.0
     date: 2026-01-22
-    changes: Ajout de l'option `rewrite` à la configuration de routage
+    changes: "Ajout de l'option `rewrite` à la configuration de routage"
   - version: 8.0.0
     date: 2026-01-18
-    changes: Séparation de la configuration système de la configuration de contenu. Déplacement des chemins internes vers la propriété `system`. Ajout de `codeDir` pour séparer les fichiers de contenu et la transformation de code.
+    changes: "Séparation de la configuration système de la configuration de contenu. Déplacement des chemins internes vers la propriété `system`. Ajout de `codeDir` pour séparer les fichiers de contenu et la transformation de code."
   - version: 8.0.0
     date: 2026-01-18
-    changes: Ajout des options de dictionnaire `location` et `schema`
+    changes: "Ajout des options de dictionnaire `location` et `schema`"
   - version: 7.5.1
     date: 2026-01-10
-    changes: Ajout du support pour les formats de fichiers JSON5 et JSONC
+    changes: "Ajout du support pour les formats de fichiers JSON5 et JSONC"
   - version: 7.5.0
     date: 2025-12-17
-    changes: Ajout de l'option `buildMode`
+    changes: "Ajout de l'option `buildMode`"
   - version: 7.0.0
     date: 2025-10-25
-    changes: Ajout de la configuration `dictionary`
+    changes: "Ajout de la configuration `dictionary`"
   - version: 7.0.0
     date: 2025-10-21
-    changes: Remplacement de `middleware` par la configuration de routage `routing`
+    changes: "Remplacement de `middleware` par la configuration de routage `routing`"
   - version: 7.0.0
     date: 2025-10-12
-    changes: Ajout de l'option `formatCommand`
+    changes: "Ajout de l'option `formatCommand`"
   - version: 6.2.0
     date: 2025-10-12
-    changes: Mise à jour de l'option `excludedPath`
+    changes: "Mise à jour de l'option `excludedPath`"
   - version: 6.0.2
     date: 2025-09-23
-    changes: Ajout de l'option `outputFormat`
+    changes: "Ajout de l'option `outputFormat`"
   - version: 6.0.0
     date: 2025-09-21
-    changes: Suppression du champ `dictionaryOutput` et du champ `i18nextResourcesDir`
+    changes: "Suppression du champ `dictionaryOutput` et du champ `i18nextResourcesDir`"
   - version: 6.0.0
     date: 2025-09-16
-    changes: Ajout du mode d'importation `live`
+    changes: "Ajout du mode d'importation `live`"
   - version: 6.0.0
     date: 2025-09-04
-    changes: Remplacement du champ `hotReload` par `liveSync` et ajout des champs `liveSyncPort` et `liveSyncURL`
+    changes: "Remplacement du champ `hotReload` par `liveSync` et ajout des champs `liveSyncPort` et `liveSyncURL`"
   - version: 5.6.1
     date: 2025-07-25
-    changes: Remplacement de `activateDynamicImport` par l'option `importMode`
+    changes: "Remplacement de `activateDynamicImport` par l'option `importMode`"
   - version: 5.6.0
     date: 2025-07-13
-    changes: Modification du contentDir par défaut de `['src']` à `['.']`
+    changes: "Modification du contentDir par défaut de `['src']` à `['.']`"
   - version: 5.5.11
     date: 2025-06-29
-    changes: Ajout des commandes `docs`
+    changes: "Ajout des commandes `docs`"
 ---
 
 # Documentation de Configuration Intlayer
@@ -563,12 +563,12 @@ Les sections suivantes décrivent les différents paramètres de configuration d
 
 Définit les paramètres liés à l'internationalisation, y compris les locales disponibles et la locale par défaut de l'application.
 
-| Champ             | Type       | Description                                                                                                                  | Exemple              | Note                                                                                                                                                                                                                                                                                                               |
-| ----------------- | ---------- | ---------------------------------------------------------------------------------------------------------------------------- | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `locales`         | `string[]` | Liste des locales supportées dans l'application. Par défaut : `[Locales.ENGLISH]`                                            | `['en', 'fr', 'es']` |                                                                                                                                                                                                                                                                                                                    |
-| `requiredLocales` | `string[]` | Liste des locales obligatoires dans l'application. Par défaut : `[]`                                                         | `[]`                 | Si vide, toutes les locales sont obligatoires en mode `strict`. Assurez-vous que les locales obligatoires sont également définies dans le champ `locales`.                                                                                                                                                         |
-| `strictMode`      | `string`   | Garantit une implémentation robuste du contenu internationalisé en utilisant TypeScript. Par défaut : `inclusive`            |                      | Si `"strict"`: la fonction `t` nécessite que chaque locale déclarée soit définie — renvoie une erreur si l'une d'elles est manquante ou non déclarée. Si `"inclusive"`: avertit des locales manquantes mais accepte les locales non déclarées existantes. Si `"loose"`: accepte n'importe quelle locale existante. |
-| `defaultLocale`   | `string`   | Locale par défaut utilisée comme solution de secours si la locale demandée n'est pas trouvée. Par défaut : `Locales.ENGLISH` | `'en'`               | Utilisé pour déterminer la locale lorsqu'aucune n'est spécifiée dans l'URL, le cookie ou l'en-tête.                                                                                                                                                                                                                |
+| Champ             | Description                                                                                      | Type       | Par défaut          | Exemple              | Note                                                                                                                                                                                                                                                                                                                       |
+| ----------------- | ------------------------------------------------------------------------------------------------ | ---------- | ------------------- | -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `locales`         | La liste des locales supportées dans l'application.                                              | `string[]` | `[Locales.ENGLISH]` | `['en', 'fr', 'es']` |                                                                                                                                                                                                                                                                                                                            |
+| `requiredLocales` | La liste des locales obligatoires dans l'application.                                            | `string[]` | `[]`                | `[]`                 | • Si vide, toutes les locales sont obligatoires en mode `strict`.<br/>• Assurez-vous que les locales obligatoires sont également définies dans le champ `locales`.                                                                                                                                                         |
+| `strictMode`      | Garantit une implémentation robuste du contenu internationalisé en utilisant TypeScript.         | `string`   | `'inclusive'`       |                      | • Si `"strict"`: la fonction `t` nécessite que chaque locale déclarée soit définie — lève une erreur si l'une d'elles est manquante ou non déclarée.<br/>• Si `"inclusive"`: avertit des locales manquantes mais accepte celles non déclarées qui existent.<br/>• Si `"loose"`: accepte n'importe quelle locale existante. |
+| `defaultLocale`   | La locale par défaut utilisée comme solution de secours si la locale demandée n'est pas trouvée. | `string`   | `Locales.ENGLISH`   | `'en'`               | Utilisé pour déterminer la locale lorsqu'aucune n'est spécifiée dans l'URL, le cookie ou l'en-tête.                                                                                                                                                                                                                        |
 
 ---
 
@@ -576,31 +576,33 @@ Définit les paramètres liés à l'internationalisation, y compris les locales
 
 Définit les paramètres liés à l'éditeur intégré, y compris le port du serveur et l'état d'activité.
 
-| Champ                        | Type                      | Description                                                                                                                                                                                                          | Exemple                                                                               | Note                                                                                                                                                                                                                                                                                  |
-| ---------------------------- | ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `applicationURL`             | `string`                  | L'URL de votre application. Par défaut : `''`                                                                                                                                                                        | `'http://localhost:3000'`, `'https://example.com'`, `process.env.INTLAYER_EDITOR_URL` | Utilisé pour restreindre l'origine de l'éditeur pour des raisons de sécurité. Si défini sur `'*'`, l'éditeur peut être accédé depuis n'importe quelle origine.                                                                                                                        |
-| `port`                       | `number`                  | Port utilisé par le serveur de l'Éditeur Visuel. Par défaut : `8000`                                                                                                                                                 |                                                                                       |                                                                                                                                                                                                                                                                                       |
-| `editorURL`                  | `string`                  | URL du serveur de l'éditeur. Par défaut : `'http://localhost:8000'`                                                                                                                                                  | `'http://localhost:3000'`, `'https://example.com'`, `process.env.INTLAYER_EDITOR_URL` | Utilisé pour restreindre les origines pouvant interagir avec l'application. Si défini sur `'*'`, accessible de n'importe quel origine. Doit être défini en cas de changement de port ou si l'éditeur est hébergé sur un domaine différent.                                            |
-| `cmsURL`                     | `string`                  | URL de l'Intlayer CMS. Par défaut : `'https://intlayer.org'`                                                                                                                                                         | `'https://intlayer.org'`                                                              |                                                                                                                                                                                                                                                                                       |
-| `backendURL`                 | `string`                  | URL du serveur backend. Par défaut : `https://back.intlayer.org`                                                                                                                                                     | `http://localhost:4000`                                                               |                                                                                                                                                                                                                                                                                       |
-| `enabled`                    | `boolean`                 | Indique si l'application interagira avec l'éditeur visuel. Par défaut : `true`                                                                                                                                       | `process.env.NODE_ENV !== 'production'`                                               | Si `false`, l'éditeur ne peut pas interagir avec l'application. Le désactiver pour des environnements spécifiques renforce la sécurité.                                                                                                                                               |
-| `clientId`                   | `string &#124; undefined` | Permet aux paquets intlayer de s'authentifier auprès du backend à l'aide d'oAuth2. Pour obtenir un jeton d'accès, rendez-vous sur [intlayer.org/project](https://app.intlayer.org/project). Par défaut : `undefined` |                                                                                       | Garder secret ; stocker dans les variables d'environnement.                                                                                                                                                                                                                           |
-| `clientSecret`               | `string &#124; undefined` | Permet aux paquets intlayer de s'authentifier auprès du backend à l'aide d'oAuth2. Pour obtenir un jeton d'accès, rendez-vous sur [intlayer.org/project](https://app.intlayer.org/project). Par défaut : `undefined` |                                                                                       | Garder secret ; stocker dans les variables d'environnement.                                                                                                                                                                                                                           |
-| `dictionaryPriorityStrategy` | `string`                  | Stratégie de priorisation des dictionnaires lorsque des dictionnaires locaux et distants sont présents. Par défaut : `'local_first'`                                                                                 | `'distant_first'`                                                                     | `'distant_first'`: donne la priorité au distant sur le local. `'local_first'`: donne la priorité au local sur le distant.                                                                                                                                                             |
-| `liveSync`                   | `boolean`                 | Indique si le serveur de l'application doit recharger le contenu à chaud lorsqu'un changement est détecté sur le CMS / Éditeur Visuel / Backend. Par défaut : `true`                                                 | `true`                                                                                | Lorsqu'un dictionnaire est ajouté/mis à jour, l'application met à jour le contenu de la page. La synchronisation en direct externalise le contenu vers un autre serveur, ce qui peut affecter légèrement les performances. Il est recommandé d'héberger les deux sur la même machine. |
-| `liveSyncPort`               | `number`                  | Port du serveur de synchronisation en direct. Par défaut : `4000`                                                                                                                                                    | `4000`                                                                                |                                                                                                                                                                                                                                                                                       |
-| `liveSyncURL`                | `string`                  | URL du serveur de synchronisation en direct. Par défaut : `'http://localhost:{liveSyncPort}'`                                                                                                                        | `'https://example.com'`                                                               | Pointe vers localhost par défaut ; peut être changé pour un serveur de synchronisation en direct distant.                                                                                                                                                                             |
+| Champ                        | Description                                                                                                                                                                          | Type                              | Par défaut                          | Exemple                                                                                         | Note                                                                                                                                                                                                                                                                   |
+| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------- | ----------------------------------- | ----------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `applicationURL`             | L'URL de l'application.                                                                                                                                                              | `string`                          | `undefined`                         | `'http://localhost:3000'` <br/> `'https://example.com'` <br/> `process.env.INTLAYER_EDITOR_URL` | • Utilisé pour restreindre l'origine de l'éditeur pour des raisons de sécurité.<br/>• Si défini sur `'*'`, l'éditeur est accessible depuis n'importe quelle origine.                                                                                                   |
+| `port`                       | Le port utilisé par le serveur de l'éditeur visuel.                                                                                                                                  | `number`                          | `8000`                              |                                                                                                 |                                                                                                                                                                                                                                                                        |
+| `editorURL`                  | L'URL du serveur de l'éditeur.                                                                                                                                                       | `string`                          | `'http://localhost:8000'`           | `'http://localhost:3000'` <br/> `'https://example.com'` <br/> `process.env.INTLAYER_EDITOR_URL` | • Utilisé pour restreindre les origines pouvant interagir avec l'application.<br/>• Si défini sur `'*'`, accessible depuis n'importe quelle origine.<br/>• Doit être défini si le port est changé ou si l'éditeur est hébergé sur un domaine différent.                |
+| `cmsURL`                     | L'URL de l'Intlayer CMS.                                                                                                                                                             | `string`                          | `'https://app.intlayer.org'`        | `'https://app.intlayer.org'`                                                                    |                                                                                                                                                                                                                                                                        |
+| `backendURL`                 | L'URL du serveur backend.                                                                                                                                                            | `string`                          | `https://back.intlayer.org`         | `http://localhost:4000`                                                                         |                                                                                                                                                                                                                                                                        |
+| `enabled`                    | Indique si l'application interagit avec l'éditeur visuel.                                                                                                                            | `boolean`                         | `false`                             | `process.env.NODE_ENV !== 'production'`                                                         | • Si `false`, l'éditeur ne peut pas interagir avec l'application.<br/>• La désactivation pour des environnements spécifiques renforce la sécurité.                                                                                                                     |
+| `clientId`                   | Permet aux paquets intlayer de s'authentifier auprès du backend via oAuth2. Pour obtenir un jeton d'accès, rendez-vous sur [intlayer.org/project](https://app.intlayer.org/project). | `string` &#124; <br/> `undefined` | `undefined`                         |                                                                                                 | Garder secret ; stocker dans les variables d'environnement.                                                                                                                                                                                                            |
+| `clientSecret`               | Permet aux paquets intlayer de s'authentifier auprès du backend via oAuth2. Pour obtenir un jeton d'accès, rendez-vous sur [intlayer.org/project](https://app.intlayer.org/project). | `string` &#124; <br/> `undefined` | `undefined`                         |                                                                                                 | Garder secret ; stocker dans les variables d'environnement.                                                                                                                                                                                                            |
+| `dictionaryPriorityStrategy` | Stratégie de priorité des dictionnaires lorsque le local et le distant sont présents.                                                                                                | `string`                          | `'local_first'`                     | `'distant_first'`                                                                               | • `'distant_first'`: donne la priorité au distant sur le local.<br/>• `'local_first'`: donne la priorité au local sur le distant.                                                                                                                                      |
+| `liveSync`                   | Indique si le serveur de l'application doit recharger le contenu à chaud lorsqu'un changement est détecté sur le CMS <br/> Éditeur Visuel <br/> Backend.                             | `boolean`                         | `true`                              | `true`                                                                                          | • Lorsqu'un dictionnaire est ajouté/mis à jour, l'application met à jour le contenu de la page.<br/>• La synchronisation en direct externalise le contenu, ce qui peut impacter légèrement les performances.<br/>• Recommandé d'héberger les deux sur la même machine. |
+| `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 du Routage (Routing Configuration)
 
 Paramètres contrôlant le comportement du routage, y compris la structure des URL, le stockage des locales et la gestion du middleware.
 
-| Champ      | Type                                                                                                                                                 | Description                                                                                                                                                                                   | Exemple                                                                                                                                                                                              | Note                                                                                                                                                                                                                                                                                             |
-| ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `mode`     | `'prefix-no-default' &#124; 'prefix-all' &#124; 'no-prefix' &#124; 'search-params'`                                                                  | Mode de routage d'URL pour la gestion des locales. Par défaut : `'prefix-no-default'`                                                                                                         | `'prefix-no-default'`: `/dashboard` (en) ou `/fr/dashboard` (fr). `'prefix-all'`: `/en/dashboard`. `'no-prefix'`: la locale est gérée par d'autres moyens. `'search-params'`: `/dashboard?locale=fr` | N'affecte pas la gestion des cookies ou du stockage des locales.                                                                                                                                                                                                                                 |
-| `storage`  | `false &#124; 'cookie' &#124; 'localStorage' &#124; 'sessionStorage' &#124; 'header' &#124; CookiesAttributes &#124; StorageAttributes &#124; Array` | Configuration pour stocker la locale sur le client. Par défaut : `['cookie', 'header']`                                                                                                       | `'localStorage'`, `[{ type: 'cookie', name: 'custom-locale', secure: true }]`                                                                                                                        | Voir le tableau des Options de Stockage ci-dessous.                                                                                                                                                                                                                                              |
-| `basePath` | `string`                                                                                                                                             | Chemin de base pour les URL de l'application. Par défaut : `''`                                                                                                                               | `'/my-app'`                                                                                                                                                                                          | Si l'application est sur `https://example.com/my-app`, basePath est `'/my-app'` et les URL deviennent `https://example.com/my-app/en`.                                                                                                                                                           |
-| `rewrite`  | `Record<string, StrictModeLocaleMap<string>>`                                                                                                        | Règles de réécritures d'URL personnalisées qui surchargent le mode de routage par défaut pour des chemins spécifiques. Supporte les paramètres dynamiques `[param]`. Par défaut : `undefined` | Voir l'exemple ci-dessous                                                                                                                                                                            | Les règles de réécriture ont la priorité sur le `mode`. Fonctionne avec Next.js et Vite. `getLocalizedUrl()` applique automatiquement les règles correspondantes. Voir [Réécritures d'URL Personnalisées](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/custom_url_rewrites.md). |
+| Champ      | Description                                                                                                                                                         | Type                                                                                                                                                                                                         | Par défaut             | Exemple                                                                                                                                                                                       | Note                                                                                                                                                                                                                                                                                                                 |
+| ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `mode`     | Mode de routage d'URL pour la gestion des locales.                                                                                                                  | `'prefix-no-default'` &#124; <br/> `'prefix-all'` &#124; <br/> `'no-prefix'` &#124; <br/> `'search-params'`                                                                                                  | `'prefix-no-default'`  | `'prefix-no-default'`: `/dashboard` (en) ou `/fr/dashboard` (fr). `'prefix-all'`: `/en/dashboard`. `'no-prefix'`: locale gérée par d'autres moyens. `'search-params'`: `/dashboard?locale=fr` | N'impacte pas la gestion des cookies ou du stockage des locales.                                                                                                                                                                                                                                                     |
+| `storage`  | Configuration pour stocker la locale sur le client.                                                                                                                 | `false` &#124; <br/> `'cookie'` &#124; <br/> `'localStorage'` &#124; <br/> `'sessionStorage'` &#124; <br/> `'header'` &#124; <br/> `CookiesAttributes` &#124; <br/> `StorageAttributes` &#124; <br/> `Array` | `['cookie', 'header']` | `'localStorage'` <br/> `[{ type: 'cookie', name: 'custom-locale', secure: true }]`                                                                                                            | Voir le tableau des Options de Stockage ci-dessous.                                                                                                                                                                                                                                                                  |
+| `basePath` | Le chemin de base pour les URL de l'application.                                                                                                                    | `string`                                                                                                                                                                                                     | `''`                   | `'/my-app'`                                                                                                                                                                                   | Si l'application est sur `https://example.com/my-app`, basePath est `'/my-app'` et les URL deviennent `https://example.com/my-app/en`.                                                                                                                                                                               |
+| `rewrite`  | Règles de réécriture d'URL personnalisées qui surchargent le mode de routage par défaut pour des chemins spécifiques. Supporte les paramètres dynamiques `[param]`. | `Record<string, StrictModeLocaleMap<string>>`                                                                                                                                                                | `undefined`            | Voir l'exemple ci-dessous                                                                                                                                                                     | • Les règles de réécriture ont la priorité sur le `mode`.<br/>• Fonctionne avec Next.js et Vite.<br/>• `getLocalizedUrl()` applique automatiquement les règles correspondantes.<br/>• Voir [Réécritures d'URL Personnalisées](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/custom_url_rewrites.md). |
 
 **Exemple de `rewrite`** :
 
@@ -795,14 +797,14 @@ export default config;
 
 Paramètres relatifs au traitement du contenu dans l'application (noms de répertoires, extensions de fichiers et configurations dérivées).
 
-| Champ            | Type       | Description                                                                                                                                                                                                              | Exemple                             | Note                                                                                                                                              |
-| ---------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `watch`          | `boolean`  | Indique si Intlayer doit surveiller les modifications des fichiers de déclaration de contenu pour reconstruire les dictionnaires. Par défaut : `process.env.NODE_ENV === 'development'`                                  |                                     |                                                                                                                                                   |
-| `fileExtensions` | `string[]` | Extensions de fichiers utilisées pour scanner les fichiers de déclaration de contenu. Par défaut : `['.content.ts', '.content.js', '.content.mjs', '.content.cjs', '.content.json', '.content.json5', '.content.jsonc']` | `['.content.ts', '.content.js']`    |                                                                                                                                                   |
-| `contentDir`     | `string[]` | Chemins vers les répertoires où se trouvent les fichiers de déclaration de contenu. Par défaut : `['.']`                                                                                                                 | `['src/content']`                   |                                                                                                                                                   |
-| `codeDir`        | `string[]` | Chemins vers les répertoires où se trouvent les fichiers du code source de votre application. Par défaut : `['.']`                                                                                                       | `['src']`                           | Utilisé pour optimiser le build et garantir que la transformation de code et le rechargement à chaud ne s'appliquent qu'aux fichiers nécessaires. |
-| `excludedPath`   | `string[]` | Chemins exclus du scan de contenu. Par défaut : `['node_modules', '.intlayer', '.next', 'dist', 'build']`                                                                                                                | `['src/styles']`                    |                                                                                                                                                   |
-| `formatCommand`  | `string`   | Commande qui sera exécutée pour formater les fichiers de contenu nouvellement créés ou mis à jour. Par défaut : `undefined`                                                                                              | `'npx prettier --write "{{file}}"'` | Utilisé lors de l'extraction de contenu ou via l'éditeur visuel.                                                                                  |
+| Champ            | Description                                                                                                                       | Type       | Par défaut                                                                                                                                                                | Exemple                                                                                                                                                                               | Note                                                                                                                                                          |
+| ---------------- | --------------------------------------------------------------------------------------------------------------------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `watch`          | Indique si Intlayer doit surveiller les modifications des fichiers de déclaration de contenu pour reconstruire les dictionnaires. | `boolean`  | `true`                                                                                                                                                                    |                                                                                                                                                                                       |                                                                                                                                                               |
+| `fileExtensions` | Extensions de fichiers à rechercher lors du build des dictionnaires.                                                              | `string[]` | `['.content.ts', '.content.js', '.content.cjs', '.content.mjs', '.content.json', '.content.json5', '.content.jsonc', '.content.tsx', '.content.jsx']`                     | `['.data.ts', '.data.js', '.data.json']`                                                                                                                                              | La personnalisation peut aider à éviter les conflits.                                                                                                         |
+| `contentDir`     | Chemin du répertoire où sont stockés les fichiers de définition de contenu (`.content.*`).                                        | `string[]` | `['.']`                                                                                                                                                                   | `['src', '../../ui-library', require.resolve("@my-package/content"), '@my-package/content']`                                                                                          | Utilisé pour surveiller les fichiers de contenu afin de reconstruire les dictionnaires.                                                                       |
+| `codeDir`        | Chemin du répertoire où le code est stocké, relatif au répertoire de base.                                                        | `string[]` | `['.']`                                                                                                                                                                   | `['src', '../../ui-library']`                                                                                                                                                         | • Utilisé pour surveiller les fichiers de code à transformer (élagage, optimisation).<br/>• Séparer de `contentDir` peut améliorer les performances de build. |
+| `excludedPath`   | Répertoires exclus de la recherche de contenu.                                                                                    | `string[]` | `['**/node_modules/**', '**/dist/**', '**/build/**', '**/.intlayer/**', '**/.next/**', '**/.nuxt/**', '**/.expo/**', '**/.vercel/**', '**/.turbo/**', '**/.tanstack/**']` |                                                                                                                                                                                       | Pas encore utilisé ; prévu pour une implémentation future.                                                                                                    |
+| `formatCommand`  | Commande pour formater les fichiers de contenu lorsque Intlayer les écrit localement.                                             | `string`   | `undefined`                                                                                                                                                               | `'npx prettier --write "{{file}}" --log-level silent'` (Prettier), `'npx biome format "{{file}}" --write --log-level none'` (Biome), `'npx eslint --fix "{{file}}" --quiet'` (ESLint) | • `{{file}}` est remplacé par le chemin du fichier.<br/>• Si non défini, Intlayer auto-détecte (essaie prettier, biome, eslint).                              |
 
 ---
 
@@ -810,121 +812,147 @@ Paramètres relatifs au traitement du contenu dans l'application (noms de réper
 
 Paramètres contrôlant les opérations de 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 des valeurs par défaut lors de la création de fichiers de déclaration de contenu.
-2. **Comportement de Repli** : Fournir des valeurs de repli lorsque des champs spécifiques ne sont pas définis, vous permettant de définir globalement le comportement des opérations de dictionnaire.
-
-Pour plus d'informations sur les fichiers de déclaration de contenu et sur la manière dont les valeurs de configuration sont appliquées, consultez la [Documentation des fichiers de contenu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/dictionary/content_file.md).
-
-| Champ                       | Type                                                                                            | Description                                                                                                                                                                               | Exemple                   | Note                                                                                                                                                                                                                                                                                                                                                                                                 |
-| --------------------------- | ----------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `fill`                      | `boolean &#124; FilePathPattern &#124; Partial<Record<Locale, boolean &#124; FilePathPattern>>` | Contrôle la manière dont les fichiers de sortie de remplissage automatique (traduction par IA) sont générés. Par défaut : `true`                                                          | Voir l'exemple ci-dessous | `true`: chemin par défaut (même fichier que la source). `false`: désactiver. Un modèle de chaîne/fonction génère des fichiers par locale. Objet par locale : chaque locale correspond à son propre modèle ; `false` ignore cette locale. L'inclusion de `{{locale}}` déclenche la génération par locale. Le `fill` au niveau du dictionnaire a toujours la priorité sur cette configuration globale. |
-| `description`               | `string`                                                                                        | Aide à comprendre l'objectif du dictionnaire dans l'éditeur et le CMS. Utilisé également comme contexte pour la génération de traductions par IA. Par défaut : `undefined`                | `'User profile section'`  |                                                                                                                                                                                                                                                                                                                                                                                                      |
-| `locale`                    | `LocalesValues`                                                                                 | Transforme le dictionnaire en un format par locale. Chaque champ déclaré devient un nœud de traduction. Si absent, le dictionnaire est traité comme multilingue. Par défaut : `undefined` | `'en'`                    | Utilisez ceci lorsque le dictionnaire est spécifique à une seule locale plutôt que de contenir des traductions pour plusieurs locales.                                                                                                                                                                                                                                                               |
-| `importMode`                | `'static' &#124; 'dynamic' &#124; 'fetch'`                                                      | Contrôle la manière dont les dictionnaires sont importés. Par défaut : `'static'`                                                                                                         | `'dynamic'`               | `'static'`: importé statiquement. `'dynamic'`: importé dynamiquement via Suspense. `'fetch'`: récupéré dynamiquement via l'API live sync. N'affecte pas `getIntlayer`, `getDictionary`, `useDictionary`, etc.                                                                                                                                                                                        |
-| `location`                  | `'local' &#124; 'remote' &#124; 'hybrid' &#124; 'plugin' &#124; string`                         | Indique où les fichiers de dictionnaire sont stockés et leur mode de synchronisation avec le CMS. Par défaut : `'local'`                                                                  | `'hybrid'`                | `'local'` : géré localement uniquement. `'remote'` : géré à distance uniquement (CMS). `'hybrid'` : géré à la fois localement et à distance. `'plugin'` ou chaîne personnalisée : géré par un plugin ou une source personnalisée.                                                                                                                                                                    |
-| `contentAutoTransformation` | `boolean &#124; { markdown?: boolean; html?: boolean; insertion?: boolean }`                    | Transforme automatiquement les chaînes de contenu en nœuds typés (markdown, HTML ou insertion). Par défaut : `false`                                                                      | `true`                    | Markdown : `### Title` → `md('### Title')`. HTML : `<div>Title</div>` → `html('<div>Title</div>')`. Insertion : `Hello {{name}}` → `insert('Hello {{name}}')`.                                                                                                                                                                                                                                       |
-| `priority`                  | `number`                                                                                        | Priorité du dictionnaire. Les valeurs plus élevées ont la priorité sur les valeurs plus basses lors de la résolution des conflits entre dictionnaires. Par défaut : `undefined`           | `1`                       |                                                                                                                                                                                                                                                                                                                                                                                                      |
-| `live`                      | `boolean`                                                                                       | Déprécié — utilisez plutôt `importMode: 'fetch'`. Indiquait si le contenu du dictionnaire était récupéré dynamiquement via l'API live sync. Par défaut : `undefined`                      |                           | Renommé en `importMode: 'fetch'` dans la v8.0.0.                                                                                                                                                                                                                                                                                                                                                     |
-| `schema`                    | `'https://intlayer.org/schema.json'`                                                            | Généré automatiquement par Intlayer pour la validation du schéma JSON. Par défaut : généré automatiquement                                                                                |                           | Ne pas modifier manuellement.                                                                                                                                                                                                                                                                                                                                                                        |
-| `title`                     | `string`                                                                                        | Aide à identifier le dictionnaire dans l'éditeur et le CMS. Par défaut : `undefined`                                                                                                      | `'User Profile'`          |                                                                                                                                                                                                                                                                                                                                                                                                      |
-| `tags`                      | `string[]`                                                                                      | Catégorise les dictionnaires et fournit du contexte ou des instructions pour l'éditeur et l'IA. Par défaut : `undefined`                                                                  | `['user', 'profile']`     |                                                                                                                                                                                                                                                                                                                                                                                                      |
-| `version`                   | `string`                                                                                        | Version du dictionnaire distant ; aide à suivre la version actuellement utilisée. Par défaut : `undefined`                                                                                | `'1.0.0'`                 | Gérable sur le CMS. Ne pas modifier localement.                                                                                                                                                                                                                                                                                                                                                      |
+| Champ                       | Description                                                                                                                                                      | Type                                                                                                            | Par défaut  | Exemple                                                                                     | Note                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
+| --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `fill`                      | Contrôle la manière dont les fichiers de sortie de remplissage automatique (traduction par IA) sont générés.                                                     | `boolean` &#124; <br/> `FilePathPattern` &#124; <br/> `Partial<Record<Locale, boolean &#124; FilePathPattern>>` | `true`      | `{ en: '/locales/en/{{key}}.json', fr: ({ key }) => '/locales/fr/${key}.json', es: false }` | • `true`: chemin par défaut (même fichier que la source).<br/>• `false`: désactiver.<br/>• Le modèle string/fonction génère des fichiers par locale.<br/>• Objet par locale : chaque locale correspond à son propre modèle ; `false` ignore cette locale.<br/>• L'inclusion de `{{locale}}` déclenche la génération par locale.<br/>• Le `fill` au niveau du dictionnaire a toujours la priorité sur cette configuration globale.                                                               |
+| `description`               | Aide à comprendre l'objectif du dictionnaire dans l'éditeur et le CMS. Également utilisé comme contexte pour la génération de traductions par IA.                | `string`                                                                                                        | `undefined` | `'User profile section'`                                                                    |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
+| `locale`                    | Transforme le dictionnaire en un format par locale. Chaque champ déclaré devient un nœud de traduction. Si absent, le dictionnaire est traité comme multilingue. | `LocalesValues`                                                                                                 | `undefined` | `'en'`                                                                                      | Utilisez ceci lorsque le dictionnaire est spécifique à une seule locale plutôt que de contenir des traductions pour plusieurs locales.                                                                                                                                                                                                                                                                                                                                                          |
+| `contentAutoTransformation` | Transforme automatiquement les chaînes de contenu en nœuds typés (markdown, HTML ou insertion).                                                                  | `boolean` &#124; <br/> `{ markdown?: boolean; html?: boolean; insertion?: boolean }`                            | `false`     | `true`                                                                                      | • Markdown : `### Title` → `md('### Title')`.<br/>• HTML : `<div>Title</div>` → `html('<div>Title</div>')`.<br/>• Insertion : `Hello {{name}}` → `insert('Hello {{name}}')`.                                                                                                                                                                                                                                                                                                                    |
+| `location`                  | Indique où les fichiers de dictionnaire sont stockés et leur mode de synchronisation avec le CMS.                                                                | `'local'` &#124; <br/> `'remote'` &#124; <br/> `'hybrid'` &#124; <br/> `'plugin'` &#124; <br/> `string`         | `'local'`   | `'hybrid'`                                                                                  | • `'local'` : géré localement uniquement.<br/>• `'remote'` : géré à distance uniquement (CMS).<br/>• `'hybrid'` : géré à la fois localement et à distance.<br/>• `'plugin'` ou chaîne personnalisée : géré par un plugin ou une source personnalisée.                                                                                                                                                                                                                                           |
+| `importMode`                | Contrôle la manière dont les dictionnaires sont importés.                                                                                                        | `'static'` &#124; <br/> `'dynamic'` &#124; <br/> `'fetch'`                                                      | `'static'`  | `'dynamic'`                                                                                 | • `'static'`: importé statiquement (remplace `useIntlayer` par `useDictionary`).<br/>• `'dynamic'`: importé dynamiquement via Suspense (remplace par `useDictionaryDynamic`).<br/>• `'fetch'`: récupéré via l'API live sync ; retombe sur `'dynamic'` en cas d'échec.<br/>• Repose sur les plugins `@intlayer/babel` et `@intlayer/swc`.<br/>• Les clés doivent être déclarées statiquement.<br/>• Ignoré si `optimize` est désactivé.<br/>• N'affecte pas `getIntlayer`, `getDictionary`, etc. |
+| `priority`                  | Priorité du dictionnaire. Les valeurs les plus élevées l'emportent sur les plus basses lors de la résolution des conflits entre dictionnaires.                   | `number`                                                                                                        | `undefined` | `1`                                                                                         |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
+| `live`                      | Déprécié — utilisez plutôt `importMode: 'fetch'`. Indiquait si le contenu du dictionnaire était récupéré dynamiquement via l'API live sync.                      | `boolean`                                                                                                       | `undefined` |                                                                                             | Renommé en `importMode: 'fetch'` dans la v8.0.0.                                                                                                                                                                                                                                                                                                                                                                                                                                                |
+| `schema`                    | Généré automatiquement par Intlayer pour la validation du schéma JSON.                                                                                           | `'https://intlayer.org/schema.json'`                                                                            | auto-généré |                                                                                             | Ne pas modifier manuellement.                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
+| `title`                     | Aide à identifier le dictionnaire dans l'éditeur et le CMS.                                                                                                      | `string`                                                                                                        | `undefined` | `'User Profile'`                                                                            |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
+| `tags`                      | Catégorise les dictionnaires et fournit du contexte ou des instructions pour l'éditeur et l'IA.                                                                  | `string[]`                                                                                                      | `undefined` | `['user', 'profile']`                                                                       |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
+| `version`                   | Version du dictionnaire distant ; aide à suivre la version actuellement utilisée.                                                                                | `string`                                                                                                        | `undefined` | `'1.0.0'`                                                                                   | • Gérable sur le CMS.<br/>• Ne pas modifier localement.                                                                                                                                                                                                                                                                                                                                                                                                                                         |
 
 **Exemple de `fill`** :
 
 ```ts
 dictionary: {
   fill: {
-    en: '/locales/en/{{key}}.content.json',
+    en: "/locales/en/{{key}}.content.json",
     fr: ({ key }) => `/locales/fr/${key}.content.json`,
     es: false,
-  }
-}
+  },
+};
 ```
 
 ---
 
-### Configuration AI (AI Configuration)
+### Configuration du Logger (Logger Configuration)
 
-Définit les paramètres pour les fonctionnalités basées sur l'IA d'Intlayer, telles que la construction de traductions.
+Paramètres pour personnaliser la sortie des logs d'Intlayer.
 
-| Champ                | Type                   | Description                                                                                          | Exemple                                              | Note                                                                                              |
-| -------------------- | ---------------------- | ---------------------------------------------------------------------------------------------------- | ---------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
-| `provider`           | `string`               | Fournisseur d'IA à utiliser.                                                                         | `'openai'`, `'anthropic'`, `'googlevertex'`          |                                                                                                   |
-| `model`              | `string`               | Modèle d'IA à utiliser.                                                                              | `'gpt-4o'`, `'claude-3-5-sonnet-20240620'`           |                                                                                                   |
-| `apiKey`             | `string`               | Clé API pour le fournisseur sélectionné.                                                             | `process.env.OPENAI_API_KEY`                         |                                                                                                   |
-| `applicationContext` | `string`               | Contexte supplémentaire sur votre application pour améliorer la précision de la traduction par l'IA. | `'Une plateforme d'apprentissage pour les enfants.'` |                                                                                                   |
-| `baseURL`            | `string`               | URL de base optionnelle pour les appels d'API.                                                       |                                                      | Utile si vous utilisez un proxy ou un déploiement d'IA local.                                     |
-| `dataSerialization`  | `'json' &#124; 'toon'` | Définit comment les données sont envoyées à l'IA. Par défaut : `'json'`                              | `'json'`                                             | `'json'`: plus robuste et précis. `'toon'`: consomme moins de tokens mais peut être moins stable. |
+| Champ    | Description                | Type                                                           | Par défaut      | Exemple                 | Note                                                                                                    |
+| -------- | -------------------------- | -------------------------------------------------------------- | --------------- | ----------------------- | ------------------------------------------------------------------------------------------------------- |
+| `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 de Build (Build Configuration)
+### Configuration AI
+
+Paramètres qui contrôlent les fonctionnalités IA d'Intlayer, y compris le fournisseur, le modèle et la clé API.
+
+Cette configuration est optionnelle si vous êtes inscrit sur le [Tableau de bord Intlayer](https://app.intlayer.org/project) en utilisant une clé d'accès. Intlayer gérera automatiquement la solution IA la plus efficace et la plus rentable pour vos besoins. L'utilisation des options par défaut garantit une meilleure maintenabilité à long terme car Intlayer se met continuellement à jour pour utiliser les modèles les plus pertinents.
+
+Si vous préférez utiliser votre propre clé API ou un modèle spécifique, vous pouvez définir votre configuration IA personnalisée.
+Cette configuration IA sera utilisée globalement dans votre environnement Intlayer. Les commandes CLI utiliseront ces paramètres par défaut pour les commandes (ex: `fill`), ainsi que le SDK, l'Éditeur Visuel et le CMS. Vous pouvez surcharger ces valeurs par défaut pour des cas d'utilisation spécifiques via les paramètres de commande.
+
+Intlayer supporte plusieurs fournisseurs d'IA pour une flexibilité accrue. Les fournisseurs actuellement supportés sont :
+
+- **OpenAI** (par défaut)
+- **Anthropic Claude**
+- **Mistral AI**
+- **DeepSeek**
+- **Google Gemini**
+- **Google AI Studio**
+- **Google Vertex**
+- **Meta Llama**
+- **Ollama**
+- **OpenRouter**
+- **Alibaba Cloud**
+- **Fireworks**
+- **Hugging Face**
+- **Groq**
+- **Amazon Bedrock**
+- **Together.ai**
+
+| Champ                | Description                                                                                                                                   | Type                                                                                                                                                                                                                                                                                                                                                                                           | Par défaut  | Exemple                                                       | Note                                                                                                                                                                                                              |
+| -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- | ------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `provider`           | Le fournisseur à utiliser pour les fonctionnalités IA d'Intlayer.                                                                             | `'openai'` &#124; <br/> `'anthropic'` &#124; <br/> `'mistral'` &#124; <br/> `'deepseek'` &#124; <br/> `'gemini'` &#124; <br/> `'ollama'` &#124; <br/> `'openrouter'` &#124; <br/> `'alibaba'` &#124; <br/> `'fireworks'` &#124; <br/> `'groq'` &#124; <br/> `'huggingface'` &#124; <br/> `'bedrock'` &#124; <br/> `'googleaistudio'` &#124; <br/> `'googlevertex'` &#124; <br/> `'togetherai'` | `undefined` | `'anthropic'`                                                 | Les différents fournisseurs nécessitent des clés API différentes et ont des tarifs variés.                                                                                                                        |
+| `model`              | Le modèle à utiliser pour les fonctionnalités IA.                                                                                             | `string`                                                                                                                                                                                                                                                                                                                                                                                       | Aucun       | `'gpt-4o-2024-11-20'`                                         | Le modèle spécifique varie selon le fournisseur.                                                                                                                                                                  |
+| `temperature`        | Contrôle le caractère aléatoire des réponses de l'IA.                                                                                         | `number`                                                                                                                                                                                                                                                                                                                                                                                       | Aucun       | `0.1`                                                         | Température plus élevée = plus créatif et moins prévisible.                                                                                                                                                       |
+| `apiKey`             | Votre clé API pour le fournisseur sélectionné.                                                                                                | `string`                                                                                                                                                                                                                                                                                                                                                                                       | Aucun       | `process.env.OPENAI_API_KEY`                                  | Garder secret ; stocker dans les variables d'environnement.                                                                                                                                                       |
+| `applicationContext` | Contexte supplémentaire sur votre application pour aider l'IA à générer des traductions plus précises (domaine, audience, ton, terminologie). | `string`                                                                                                                                                                                                                                                                                                                                                                                       | Aucun       | `'Mon contexte d'application'`                                | Peut être utilisé pour ajouter des règles (ex: `"Vous ne devez pas transformer les urls"`).                                                                                                                       |
+| `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.). |
 
-Paramètres pour le processus de build et d'optimisation d'Intlayer.
+---
 
-| Champ          | Type                     | Description                                                                                                                 | Exemple | Note |
-| -------------- | ------------------------ | --------------------------------------------------------------------------------------------------------------------------- | ------- | ---- |
-| `mode`         | `'auto' &#124; 'manual'` | Indique si Intlayer doit s'exécuter automatiquement pendant les étapes de pré-build de l'application. Par défaut : `'auto'` |         |      |
-| `optimize`     | `boolean`                | Indique si les dictionnaires compilés doivent être optimisés pour l'exécution. Par défaut : `true` en production            |         |      |
-| `outputFormat` | `('cjs' &#124; 'esm')[]` | Format de sortie pour les fichiers de dictionnaire générés. Par défaut : `['cjs', 'esm']`                                   |         |      |
-| `checkTypes`   | `boolean`                | Indique si Intlayer doit vérifier les types dans les fichiers générés. Par défaut : `false`                                 |         |      |
+### Configuration de Build
 
----
+Paramètres qui contrôlent comment Intlayer optimise et construit l'internationalisation de votre application.
 
-### Configuration Système (System Configuration)
+Les options de build s'appliquent aux plugins `@intlayer/babel` et `@intlayer/swc`.
 
-Ces paramètres sont destinés aux cas d'utilisation avancés et à la configuration interne d'Intlayer.
+> En mode développement, Intlayer utilise des imports statiques pour les dictionnaires afin de simplifier l'expérience de développement.
+
+> Lorsqu'il est optimisé, Intlayer remplacera les appels de dictionnaire pour optimiser le chunking, de sorte que le bundle final n'importe que les dictionnaires réellement utilisés.
 
-| Champ                     | Type     | Description                                        | Par défaut                        |
-| ------------------------- | -------- | -------------------------------------------------- | --------------------------------- |
-| `dictionariesDir`         | `string` | Répertoire des dictionnaires compilés.             | `'.intlayer/dictionary'`          |
-| `moduleAugmentationDir`   | `string` | Répertoire d'augmentation de modules TypeScript.   | `'.intlayer/types'`               |
-| `unmergedDictionariesDir` | `string` | Répertoire des dictionnaires non fusionnés.        | `'.intlayer/unmerged_dictionary'` |
-| `typesDir`                | `string` | Répertoire des types générés.                      | `'.intlayer/types'`               |
-| `mainDir`                 | `string` | Répertoire du fichier principal d'Intlayer.        | `'.intlayer/main'`                |
-| `configDir`               | `string` | Répertoire des fichiers de configuration compilés. | `'.intlayer/config'`              |
-| `cacheDir`                | `string` | Répertoire des fichiers de cache.                  | `'.intlayer/cache'`               |
+| Champ             | Description                                                                   | Type                             | Par défaut                                                                                                                                                                        | Exemple                                                                       | Note                                                                                                                                                                                                                                                                                                                                     |
+| ----------------- | ----------------------------------------------------------------------------- | -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `mode`            | Contrôle le mode du build.                                                    | `'auto'` &#124; <br/> `'manual'` | `'auto'`                                                                                                                                                                          | `'manual'`                                                                    | • `'auto'`: build activé automatiquement lors du build de l'application.<br/>• `'manual'`: ne s'exécute que lorsque la commande de build est exécutée.<br/>• Peut être utilisé pour désactiver les builds de dictionnaires (ex: pour éviter l'exécution dans des environnements Node.js).                                                |
+| `optimize`        | Contrôle si le build doit être optimisé.                                      | `boolean`                        | `undefined`                                                                                                                                                                       | `process.env.NODE_ENV === 'production'`                                       | • Si non défini, l'optimisation est déclenchée lors du build du framework (Vite/Next.js).<br/>• `true` force l'optimisation y compris en mode dev.<br/>• `false` la désactive.<br/>• Une fois activé, remplace les appels de dictionnaire pour optimiser le chunking.<br/>• Repose sur les plugins `@intlayer/babel` et `@intlayer/swc`. |
+| `checkTypes`      | Indique si le build doit vérifier les types TypeScript et loguer les erreurs. | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | Peut ralentir le build.                                                                                                                                                                                                                                                                                                                  |
+| `outputFormat`    | Contrôle le format de sortie des dictionnaires.                               | `('esm' &#124; 'cjs')[]`         | `['esm', 'cjs']`                                                                                                                                                                  | `['cjs']`                                                                     |                                                                                                                                                                                                                                                                                                                                          |
+| `traversePattern` | Motifs définissant quels fichiers parcourir lors de l'optimisation.           | `string[]`                       | `['**/*.{tsx,ts,js,mjs,cjs,jsx,vue,svelte,svte}', '!**/node_modules/**', '!**/dist/**', '!**/.intlayer/**', '!**/*.config.*', '!**/*.test.*', '!**/*.spec.*', '!**/*.stories.*']` | `['src/**/*.{ts,tsx}', '../ui-library/**/*.{ts,tsx}', '!**/node_modules/**']` | • Limitez l'optimisation aux fichiers pertinents pour améliorer les performances de build.<br/>• Ignoré si `optimize` est désactivé.<br/>• Utilise des motifs glob.                                                                                                                                                                      |
 
 ---
 
-### Configuration du Compilateur (Compiler Configuration)
+### Configuration Système (System Configuration)
 
-Paramètres pour le compilateur Intlayer (`intlayer compiler`).
+Ces paramètres sont destinés aux cas d'utilisation avancés et à la configuration interne d'Intlayer.
 
-| Champ                 | Type                     | Description                                                                                     | Par défaut |
-| --------------------- | ------------------------ | ----------------------------------------------------------------------------------------------- | ---------- |
-| `enabled`             | `boolean`                | Indique si le compilateur est actif.                                                            | `false`    |
-| `output`              | `string &#124; Function` | Chemin de sortie pour les dictionnaires extraits.                                               |            |
-| `saveComponents`      | `boolean`                | Indique si les fichiers sources originaux doivent être remplacés par les versions transformées. | `false`    |
-| `noMetadata`          | `boolean`                | Si `true`, le compilateur n'inclura pas de métadonnées dans les fichiers générés.               | `false`    |
-| `dictionaryKeyPrefix` | `string`                 | Préfixe de clé de dictionnaire optionnel.                                                       | `''`       |
+| Champ                     | Description                                        | Type     | Par défaut                        | Exemple | Note |
+| ------------------------- | -------------------------------------------------- | -------- | --------------------------------- | ------- | ---- |
+| `dictionariesDir`         | Répertoire des dictionnaires compilés.             | `string` | `'.intlayer/dictionary'`          |         |      |
+| `moduleAugmentationDir`   | Répertoire d'augmentation de modules TypeScript.   | `string` | `'.intlayer/types'`               |         |      |
+| `unmergedDictionariesDir` | Répertoire des dictionnaires non fusionnés.        | `string` | `'.intlayer/unmerged_dictionary'` |         |      |
+| `typesDir`                | Répertoire des types générés.                      | `string` | `'.intlayer/types'`               |         |      |
+| `mainDir`                 | Répertoire du fichier principal d'Intlayer.        | `string` | `'.intlayer/main'`                |         |      |
+| `configDir`               | Répertoire des fichiers de configuration compilés. | `string` | `'.intlayer/config'`              |         |      |
+| `cacheDir`                | Répertoire des fichiers de cache.                  | `string` | `'.intlayer/cache'`               |         |      |
 
 ---
 
-### Configuration du Logger (Logger Configuration)
+### Configuration du Compilateur
 
-Paramètres pour personnaliser la sortie des logs d'Intlayer.
+Paramètres qui contrôlent le compilateur Intlayer, qui extrait les dictionnaires directement de vos composants.
 
-| Champ    | Type                                           | Description                       | Par défaut     |
-| -------- | ---------------------------------------------- | --------------------------------- | -------------- |
-| `mode`   | `'default' &#124; 'verbose' &#124; 'disabled'` | Mode de logging.                  | `'default'`    |
-| `prefix` | `string`                                       | Préfixe pour les messages de log. | `'[intlayer]'` |
+| Champ                 | Description                                                                                                                                                                                                                                                                                                                  | Type                                                                                                            | Par défaut  | Exemple                                                                                                                                                  | Note                                                                                                                                                                                                                               |
+| --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `enabled`             | Indique si le compilateur doit être activé pour extraire les dictionnaires.                                                                                                                                                                                                                                                  | `boolean` &#124; <br/> `'build-only'`                                                                           | `true`      | `'build-only'`                                                                                                                                           | `'build-only'` ignore le compilateur pendant le développement pour accélérer les builds ; ne s'exécute que lors des commandes de build.                                                                                            |
+| `dictionaryKeyPrefix` | Préfixe pour les clés de dictionnaire extraites.                                                                                                                                                                                                                                                                             | `string`                                                                                                        | `''`        | `'ma-clé-'`                                                                                                                                              | Ajouté à la clé générée (basée sur le nom du fichier) pour éviter les conflits.                                                                                                                                                    |
+| `saveComponents`      | Indique si les composants doivent être sauvegardés après avoir été transformés.                                                                                                                                                                                                                                              | `boolean`                                                                                                       | `false`     |                                                                                                                                                          | • Si `true`, remplace les fichiers originaux par les fichiers transformés.<br/>• Le compilateur peut ensuite être supprimé après une exécution.                                                                                    |
+| `output`              | Définit le chemin des fichiers de sortie. Remplace `outputDir`. Supporte les variables de modèle : `{{fileName}}`, <br/> `{{key}}`, <br/> `{{locale}}`, <br/> `{{extension}}`, <br/> `{{componentFileName}}`, <br/> `{{componentExtension}}`, <br/> `{{format}}`, <br/> `{{componentFormat}}`, <br/> `{{componentDirPath}}`. | `boolean` &#124; <br/> `FilePathPattern` &#124; <br/> `Partial<Record<Locale, boolean &#124; FilePathPattern>>` | `undefined` | `'./{{fileName}}{{extension}}'` <br/> `'/locales/{{locale}}/{{key}}.json'` <br/> `{ en: ({ key }) => './locales/en/${key}.json', fr: '...', es: false }` | • Les chemins `./` sont résolus par rapport au répertoire du composant.<br/>• Les chemins `/` par rapport à la racine.<br/>• `{{locale}}` déclenche la génération séparée par locale.<br/>• Supporte la notation objet par locale. |
+| `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     | Type                        | Description                                                                       |
-| --------- | --------------------------- | --------------------------------------------------------------------------------- |
-| `schemas` | `Record<string, ZodSchema>` | Permet de définir des schémas Zod pour valider la structure de vos dictionnaires. |
+| Champ     | Description                                                                       | Type                        |
+| --------- | --------------------------------------------------------------------------------- | --------------------------- |
+| `schemas` | Permet de définir des schémas Zod pour valider la structure de vos dictionnaires. | `Record<string, ZodSchema>` |
 
 ---
 
 ### Plugins
 
-| Champ     | Type               | Description                           |
-| --------- | ------------------ | ------------------------------------- |
-| `plugins` | `IntlayerPlugin[]` | Liste des plugins Intlayer à activer. |
+| Champ     | Description                           | Type               |
+| --------- | ------------------------------------- | ------------------ |
+| `plugins` | Liste des plugins Intlayer à activer. | `IntlayerPlugin[]` |