@intlayer/docs 9.3.2 → 9.4.0-canary.0

package/docs/fr/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-08-06
+updatedAt: 2026-08-22
 title: Configuration
 description: Apprenez à configurer Intlayer pour votre application. Comprenez les différents paramètres et options disponibles pour personnaliser Intlayer selon vos besoins.
 keywords:
@@ -14,6 +14,9 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 9.3.3
+    date: 2026-08-22
+    changes: "Activer les analytics par défaut dès que `@intlayer/analytics` est installé"
   - version: 9.1.3
     date: 2026-08-06
     changes: "Rendre `routing.enableProxy` tri-état : non défini (auto), `true`, `false`"
@@ -380,8 +383,8 @@ const config: IntlayerConfig = {
   analytics: {
     /**
      * Indique si la collecte des analytics est activée (pages vues, expositions de contenu, événements A/B).
-     * Nécessite que `editor.clientId` soit défini pour l'attribution.
-     * Par défaut : false
+     * Nécessite que `@intlayer/analytics` soit installé et que `editor.clientId` soit défini pour l'attribution.
+     * Par défaut : true
      */
     enabled: true,
 
@@ -478,6 +481,30 @@ const config: IntlayerConfig = {
      */
     purge: true,
 
+    /**
+     * Regrouper les chunks de dictionnaire par locale selon la frontière de
+     * code-splitting qui les utilise, pour qu'une page chargée paresseusement
+     * récupère son contenu en une seule requête.
+     * Par défaut : true
+     *
+     * Note :
+     * - S'applique uniquement aux dictionnaires utilisant `importMode: 'dynamic'`.
+     */
+    chunkGrouping: true,
+
+    /**
+     * Charger un dictionnaire en même temps que le chunk qui l'utilise, au lieu de
+     * le récupérer une fois ce chunk rendu. Les lecteurs s'affichent de façon
+     * synchrone au lieu de suspendre, donc la navigation ne fait plus clignoter
+     * d'état de chargement.
+     * Par défaut : true
+     *
+     * Note :
+     * - Seule la locale résolue est attendue, la page ne télécharge donc que la
+     *   langue qu'elle affiche.
+     */
+    dictionariesPreload: true,
+
     /**
      * Format de sortie pour les fichiers de dictionnaire générés.
      * Par défaut : ['cjs', 'esm']
@@ -718,13 +745,13 @@ Définit les paramètres liés à l'éditeur intégré, y compris le port du ser
 
 Définit les paramètres liés aux analytics Intlayer : la collecte du contenu réellement affiché aux utilisateurs (pages vues, expositions de contenu) et l'alimentation des tests A/B sur le contenu.
 
-Les analytics sont strictement optionnelles (opt-in) : rien n'est collecté à moins que `analytics.enabled` soit explicitement défini sur `true` **et** qu'une clé de projet (`editor.clientId`) soit configurée pour l'attribution. Lorsqu'elles sont désactivées (par défaut), l'intégralité de l'intégration analytics est éliminée du bundle de votre application (dead-code elimination).
+Les analytics sont désactivables (opt-out) : elles sont activées par défaut et commencent à collecter dès que le paquet `@intlayer/analytics` est installé **et** qu'une clé de projet (`editor.clientId`) est configurée pour l'attribution. Définissez `analytics.enabled` sur `false` — ou n'installez pas le paquet — et l'intégralité de l'intégration analytics est éliminée du bundle de votre application (dead-code elimination).
 
-| Champ           | Description                                                                            | Type      | Par défaut | Exemple | Note                                                                                                                                    |
-| --------------- | -------------------------------------------------------------------------------------- | --------- | ---------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------- |
-| `enabled`       | Active la collecte des analytics (pages vues, expositions de contenu, événements A/B). | `boolean` | `false`    | `true`  | Nécessite que `editor.clientId` soit défini pour l'attribution ; sinon les analytics restent désactivées même si `enabled` vaut `true`. |
-| `flushInterval` | Millisecondes entre les envois groupés automatiques vers le backend.                   | `number`  | `20000`    | `10000` |                                                                                                                                         |
-| `sampleRate`    | Fraction des sessions à enregistrer, de `0` (aucune) à `1` (toutes).                   | `number`  | `1`        | `0.5`   | L'échantillonnage est déterministe par session, donc une session enregistrée rapporte tous ses événements (pas d'entonnoirs partiels).  |
+| Champ           | Description                                                                            | Type      | Par défaut | Exemple | Note                                                                                                                                                                               |
+| --------------- | -------------------------------------------------------------------------------------- | --------- | ---------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `enabled`       | Active la collecte des analytics (pages vues, expositions de contenu, événements A/B). | `boolean` | `true`     | `false` | Nécessite que `@intlayer/analytics` soit installé et que `editor.clientId` soit défini pour l'attribution ; sinon les analytics restent désactivées même si `enabled` vaut `true`. |
+| `flushInterval` | Millisecondes entre les envois groupés automatiques vers le backend.                   | `number`  | `20000`    | `10000` |                                                                                                                                                                                    |
+| `sampleRate`    | Fraction des sessions à enregistrer, de `0` (aucune) à `1` (toutes).                   | `number`  | `1`        | `0.5`   | L'échantillonnage est déterministe par session, donc une session enregistrée rapporte tous ses événements (pas d'entonnoirs partiels).                                             |
 
 ---
 
@@ -1058,15 +1085,17 @@ Les options de build s'appliquent aux plugins `@intlayer/babel` et `@intlayer/sw
 
 > 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             | 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`. |
-| `minify`          | Minifier les dictionnaires pour réduire la taille du bundle.                  | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | • Indique si le bundle doit être minifié.<br/>• Par défaut : `true` en production.<br/>• Cette option sera ignorée si `optimize` est désactivé.<br/>• Cette option sera ignorée si `editor.enabled` est vrai.                                                                                                                            |
-| `purge`           | Purger les clés inutilisées dans les dictionnaires.                           | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | • Indique si le bundle doit être purgé.<br/>• Par défaut : `true` en production.<br/>• Cette option sera ignorée si `optimize` est désactivé.                                                                                                                                                                                            |
-| `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.                                                                                                                                                                      |
+| 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`.                                                                                                                                                                                                                                                                              |
+| `minify`              | Minifier les dictionnaires pour réduire la taille du bundle.                                                              | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | • Indique si le bundle doit être minifié.<br/>• Par défaut : `true` en production.<br/>• Cette option sera ignorée si `optimize` est désactivé.<br/>• Cette option sera ignorée si `editor.enabled` est vrai.                                                                                                                                                                                                                                                                                                                                                                                                         |
+| `purge`               | Purger les clés inutilisées dans les dictionnaires.                                                                       | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | • Indique si le bundle doit être purgé.<br/>• Par défaut : `true` en production.<br/>• Cette option sera ignorée si `optimize` est désactivé.                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
+| `checkTypes`          | Indique si le build doit vérifier les types TypeScript et loguer les erreurs.                                             | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | Peut ralentir le build.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
+| `chunkGrouping`       | Indique s'il faut regrouper les chunks de dictionnaire par locale selon la frontière de code-splitting qui les utilise.   | `boolean`                        | `true`                                                                                                                                                                            |                                                                               | • Sans regroupement, une page composée de nombreux composants émet une requête par dictionnaire.<br/>• Les dictionnaires atteints depuis plusieurs frontières sont placés dans un chunk partagé, aucune page n'embarque donc le contenu d'une autre.<br/>• S'applique uniquement aux dictionnaires utilisant `importMode: 'dynamic'`.<br/>• S'applique uniquement au build client, et uniquement lors du bundling (pas en dev).                                                                                                                                                                                       |
+| `dictionariesPreload` | Indique si un dictionnaire doit être chargé avec le chunk qui l'utilise, au lieu d'être récupéré une fois ce chunk rendu. | `boolean`                        | `true`                                                                                                                                                                            |                                                                               | • Le point d'entrée généré attend la locale de navigation au niveau racine, une route chargée paresseusement n'est donc pas considérée comme chargée tant que son contenu n'est pas là.<br/>• Les lecteurs s'affichent de façon synchrone au lieu de suspendre, la navigation ne fait donc plus clignoter d'état de chargement.<br/>• Seule la locale résolue est attendue, la page ne télécharge donc que la langue qu'elle affiche.<br/>• S'applique uniquement aux dictionnaires utilisant `importMode: 'dynamic'`, sur le build client.<br/>• Nécessite un bundler supportant le top-level await (Vite, esbuild). |
+| `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.                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
 
 ---
 

package/docs/fr/dictionary/content_file.md

@@ -532,28 +532,6 @@ Utilisé en conjonction avec les Variantes, ce champ définit des alternatives d
 
 > Voir [Variantes](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/dynamic_dictionaries/variants.md) pour plus d'informations.
 
-#### `meta` (`Record<string, string | number | boolean>`)
-
-Utilisé en conjonction avec les Enregistrements Dynamiques, ce champ permet de déclarer des enregistrements gérés par le CMS ou des données arbitraires récupérées à l'exécution par un identifiant opaque. L'identité du dictionnaire est définie par l'ensemble arbitraire de paires clé-valeur déclarées dans ce champ `meta`.
-
-**Exemple :**
-
-```typescript
-{
-  key: "product-copy",
-  meta: {
-    id: "prod_abc",
-    userId: "user_123"
-  },
-  content: {
-    name: "Widget Pro",
-    description: "The best widget."
-  }
-}
-```
-
-> Voir [Enregistrements Dynamiques](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/dynamic_dictionaries/dynamic_content.md) pour plus d'informations.
-
 ### Propriétés CMS
 
 ##### `version` (string)

package/docs/fr/dictionary/function_fetching.md

@@ -89,6 +89,29 @@ Impossible de récupérer du contenu depuis un fichier JSON, utilisez plutôt un
 
 Dans ce cas, la fonction `fakeFetch` imite un délai pour simuler le temps de réponse du serveur. Intlayer exécute la fonction asynchrone et utilise le résultat comme contenu pour la clé `text`.
 
+## Récupération de contenu distant
+
+Vous pouvez également assigner directement une promesse à un champ de contenu. Intlayer l'attend lors de la construction des dictionnaires et y insère la valeur résolue :
+
+```typescript fileName="**/*.content.ts" contentDeclarationFormat={["typescript", "esm", "commonjs"]}
+import type { Dictionary } from "intlayer";
+
+const remoteContent = {
+  key: "remote_content",
+  content: {
+    externalContent: fetch("https://example.com").then((res) => res.json()),
+  },
+} satisfies Dictionary;
+
+export default remoteContent;
+```
+
+```plaintext fileName="**/*.content.json" contentDeclarationFormat="json"
+Impossible de récupérer du contenu depuis un fichier JSON, utilisez plutôt un fichier .ts ou .js
+```
+
+> La requête est exécutée au moment du build, les données récupérées sont donc un instantané intégré au dictionnaire. Reconstruisez vos dictionnaires pour les actualiser.
+
 ## Utilisation de contenu basé sur une fonction dans les composants React
 
 Pour utiliser un contenu basé sur une fonction dans un composant React, vous devez importer `useIntlayer` depuis `react-intlayer` et l'appeler avec l'ID du contenu pour récupérer ce contenu. Voici un exemple :

package/docs/fr/eslint.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-08-12
-updatedAt: 2026-08-12
+updatedAt: 2026-08-13
 title: Plugin ESLint | Règles de lint pour Intlayer
 description: Détectez les chaînes codées en dur, les appels dynamiques que le compilateur Intlayer ne peut pas optimiser et le contenu de dictionnaire inutilisé, avec eslint-plugin-intlayer. Compatible ESLint et oxlint, sur React, Vue, Svelte, Angular et Astro.
 keywords:
@@ -52,7 +52,7 @@ pnpm add --save-dev eslint-plugin-intlayer
 yarn add --dev eslint-plugin-intlayer
 ```
 
-Nécessite ESLint 9 ou une version ultérieure (flat config).
+Nécessite ESLint 9 ou une version ultérieure (flat config). ESLint 10 est pris en charge.
 
 ## Utilisation
 
@@ -61,20 +61,20 @@ Le plugin fonctionne à la fois avec ESLint et [oxlint](https://oxc.rs) — mêm
 <Tabs defaultTab="eslint">
   <Tab label="ESLint" value="eslint">
 
-```javascript fileName="eslint.config.mjs" codeFormat="esm"
+```javascript fileName="eslint.config.mjs"
 import intlayer from "eslint-plugin-intlayer";
 
 export default [...intlayer.configs.recommended];
 ```
 
-Ou activez les règles une par une :
+Ou étalez une config et définissez vous-même les niveaux de sévérité :
 
-```javascript fileName="eslint.config.mjs" codeFormat="esm"
+```javascript fileName="eslint.config.mjs"
 import intlayer from "eslint-plugin-intlayer";
 
 export default [
+  ...intlayer.configs.recommended,
   {
-    plugins: { intlayer },
     rules: {
       "intlayer/no-raw-text": "warn",
       "intlayer/static-dictionary-key": "error",
@@ -144,7 +144,7 @@ Pour corriger tout un fichier d'un coup, lancez `npx intlayer extract` et laisse
 
 **Options**
 
-```javascript fileName="eslint.config.mjs" codeFormat="esm"
+```javascript fileName="eslint.config.mjs"
 {
   "intlayer/no-raw-text": [
     "warn",
@@ -247,7 +247,7 @@ Contrairement aux autres règles, celle-ci ne peut pas répondre uniquement à p
 
 **Options**
 
-```javascript fileName="eslint.config.mjs" codeFormat="esm"
+```javascript fileName="eslint.config.mjs"
 {
   "intlayer/no-unused-content": [
     "warn",
@@ -296,7 +296,7 @@ Toutes les règles fonctionnent sur l'ensemble des intégrations Intlayer, y com
 | Templates Angular         | `.component.html` | `@angular-eslint/template-parser` |
 | Astro                     | `.astro`          | `astro-eslint-parser`             |
 
-```javascript fileName="eslint.config.mjs" codeFormat="esm"
+```javascript fileName="eslint.config.mjs"
 import intlayer from "eslint-plugin-intlayer";
 import tseslint from "typescript-eslint";
 import vueParser from "vue-eslint-parser";

package/docs/fr/intlayer_with_react_native+expo.md

@@ -86,7 +86,7 @@ Déclarer le contenu directement au plus près de vos composants **facilite la m
 
 <Accordion header="Prêt pour les agents IA">
 
-La colocalisation du contenu **réduit le contexte nécessaire** aux grands modèles de langage (LLM). Intlayer est également livré avec une suite d'outils, tels qu'une **CLI** pour vérifier les traductions manquantes, un **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**, un **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** et des **[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/agent_skills.md)**, afin de rendre l'expérience développeur (DX) encore plus fluide pour les agents IA.
+La colocalisation du contenu **réduit le contexte nécessaire** aux grands modèles de langage (LLM). Intlayer est également livré avec une suite d'outils, tels qu'une **CLI** pour vérifier les traductions manquantes, un **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**, un **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** et des **[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/agent_skills.md)**, afin de rendre l'expérience développeur (DX) encore plus fluide pour les agents IA.
 
 </Accordion>
 

package/docs/fr/intlayer_with_solid_start.md

@@ -78,7 +78,7 @@ Cibler le contenu de votre application **facilite la maintenance** pour les appl
 
 <Accordion header="Agent IA">
 
-Colocaliser le contenu **réduit le contexte nécessaire** pour les grands modèles de langage (LLM). Intlayer est également livré avec une suite d'outils, tels qu'un **CLI** pour tester les traductions manquantes, le **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/lsp.md)**, le **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/mcp_server.md)**, et des **[compétences d'agent](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/agent_skills.md)**, pour rendre l'expérience développeur (DX) encore plus fluide pour les agents IA.
+Colocaliser le contenu **réduit le contexte nécessaire** pour les grands modèles de langage (LLM). Intlayer est également livré avec une suite d'outils, tels qu'un **CLI** pour tester les traductions manquantes, le **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/lsp.md)**, le **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/mcp_server.md)**, et des **[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/agent_skills.md)**, pour rendre l'expérience développeur (DX) encore plus fluide pour les agents IA.
 
 </Accordion>
 

package/docs/fr/mcp_server.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-06-07
-updatedAt: 2026-03-03
+updatedAt: 2026-08-21
 title: Documentation du serveur MCP
 description: Explorez les fonctionnalités et la configuration du serveur MCP pour optimiser la gestion et les opérations de votre serveur.
 keywords:
@@ -15,6 +15,9 @@ slugs:
   - doc
   - mcp-server
 history:
+  - version: 9.3.3
+    date: 2026-08-21
+    changes: "Group the platform setup sections into tabs"
   - version: 5.5.12
     date: 2025-07-11
     changes: "Ajout de la configuration de ChatGPT"
@@ -113,13 +116,18 @@ Cette commande va :
 
 ---
 
-## Configuration dans Cursor
+## Configuration manuelle
+
+<Tabs defaultTab="cursor">
+  <Tab label="Cursor" value="cursor">
+
+### Configuration dans Cursor
 
 Suivez la [documentation officielle](https://docs.cursor.com/context/mcp) pour configurer le serveur MCP dans Cursor.
 
 À la racine de votre projet, ajoutez le fichier de configuration `.cursor/mcp.json` suivant :
 
-### Serveur local (stdio) (recommandé)
+#### Serveur local (stdio) (recommandé)
 
 ```json fileName=".cursor/mcp.json"
 {
@@ -132,7 +140,7 @@ Suivez la [documentation officielle](https://docs.cursor.com/context/mcp) pour c
 }
 ```
 
-### Serveur distant (Streamable HTTP)
+#### Serveur distant (Streamable HTTP)
 
 Pour se connecter à un serveur MCP Intlayer distant utilisant les Server-Sent Events (Streamable HTTP), vous pouvez configurer votre client MCP pour se connecter au service hébergé.
 
@@ -149,15 +157,16 @@ Pour se connecter à un serveur MCP Intlayer distant utilisant les Server-Sent E
 
 Cela indique à votre IDE de lancer le serveur MCP Intlayer en utilisant `npx`, garantissant qu'il utilise toujours la dernière version disponible sauf si vous la fixez.
 
----
+  </Tab>
+  <Tab label="VS Code" value="vscode">
 
-## Configuration dans VS Code
+### Configuration dans VS Code
 
 Suivez la [documentation officielle](https://code.visualstudio.com/docs/copilot/chat/mcp-servers) pour configurer le serveur MCP dans VS Code.
 
 Pour utiliser le serveur MCP Intlayer avec VS Code, vous devez le configurer dans les paramètres de votre espace de travail ou utilisateur.
 
-### Serveur local (stdio) (recommandé)
+#### Serveur local (stdio) (recommandé)
 
 Créez un fichier `.vscode/mcp.json` à la racine de votre projet :
 
@@ -173,7 +182,7 @@ Créez un fichier `.vscode/mcp.json` à la racine de votre projet :
 }
 ```
 
-### Serveur distant (Streamable HTTP)
+#### Serveur distant (Streamable HTTP)
 
 Pour se connecter à un serveur MCP Intlayer distant utilisant les Server-Sent Events (Streamable HTTP), vous pouvez configurer votre client MCP pour se connecter au service hébergé.
 
@@ -188,11 +197,12 @@ Pour se connecter à un serveur MCP Intlayer distant utilisant les Server-Sent E
 }
 ```
 
----
+  </Tab>
+  <Tab label="ChatGPT" value="chatgpt">
 
-## Configuration dans ChatGPT
+### Configuration dans ChatGPT
 
-### Serveur distant (Streamable HTTP)
+#### Serveur distant (Streamable HTTP)
 
 Suivez la [documentation officielle](https://platform.openai.com/docs/mcp#test-and-connect-your-mcp-server) pour configurer le serveur MCP dans ChatGPT.
 
@@ -209,9 +219,10 @@ Suivez la [documentation officielle](https://platform.openai.com/docs/mcp#test-a
 
 7. Cliquez sur `Save`
 
----
+  </Tab>
+  <Tab label="Claude Desktop" value="claude-desktop">
 
-## Configuration dans Claude Desktop
+### Configuration dans Claude Desktop
 
 Suivez la [documentation officielle](https://modelcontextprotocol.io/quickstart/user#2-add-the-filesystem-mcp-server) pour configurer le serveur MCP dans Claude Desktop.
 
@@ -220,7 +231,7 @@ Chemin du fichier de configuration :
 - macOS : `~/Library/Application\ Support/Claude/claude_desktop_config.json`
 - Windows : `%APPDATA%\Claude\claude_desktop_config.json`
 
-### Serveur local (stdio) (recommandé)
+#### Serveur local (stdio) (recommandé)
 
 ```json fileName="claude_desktop_config.json"
 {
@@ -233,7 +244,7 @@ Chemin du fichier de configuration :
 }
 ```
 
-### Serveur distant (Streamable HTTP)
+#### Serveur distant (Streamable HTTP)
 
 ```json fileName="claude_desktop_config.json"
 {
@@ -246,13 +257,14 @@ Chemin du fichier de configuration :
 }
 ```
 
----
+  </Tab>
+  <Tab label="Claude Code (CLI)" value="claude-code">
 
-## Configuration dans Claude Code (CLI)
+### Configuration dans Claude Code (CLI)
 
 Suivez la [documentation officielle](https://modelcontextprotocol.io/quickstart/user) pour configurer le serveur MCP dans Claude Code.
 
-### Serveur local (stdio) (recommandé)
+#### Serveur local (stdio) (recommandé)
 
 Pour connecter le serveur MCP Intlayer à Claude Code en utilisant stdio :
 
@@ -260,7 +272,7 @@ Pour connecter le serveur MCP Intlayer à Claude Code en utilisant stdio :
 claude mcp add intlayer npx -y @intlayer/mcp
 ```
 
-### Serveur distant (Streamable HTTP)
+#### Serveur distant (Streamable HTTP)
 
 Pour connecter le serveur MCP Intlayer à Claude Code en utilisant Streamable HTTP (SSE) :
 
@@ -268,6 +280,9 @@ Pour connecter le serveur MCP Intlayer à Claude Code en utilisant Streamable HT
 claude mcp add intlayer https://mcp.intlayer.org -t http
 ```
 
+  </Tab>
+</Tabs>
+
 ---
 
 ## Utilisation du serveur MCP via la CLI

package/docs/fr/migration_from_i18next_to_intlayer.md

@@ -44,7 +44,7 @@ Intlayer est également la solution avec le **développement le plus actif** dan
 
 <Accordion header="Agent IA">
 
-Colocaliser le contenu **réduit le contexte nécessaire** pour les Grands Modèles de Langage (LLM). Intlayer est également livré avec une suite d'outils, tels qu'une **CLI** pour tester les traductions manquantes, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/mcp_server.md)**, et des **[compétences d'agent](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/agent_skills.md)**, pour rendre l'expérience développeur (DX) encore plus fluide pour les agents IA.
+Colocaliser le contenu **réduit le contexte nécessaire** pour les Grands Modèles de Langage (LLM). Intlayer est également livré avec une suite d'outils, tels qu'une **CLI** pour tester les traductions manquantes, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/mcp_server.md)**, et des **[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/agent_skills.md)**, pour rendre l'expérience développeur (DX) encore plus fluide pour les agents IA.
 
 </Accordion>
 

package/docs/fr/migration_from_next-i18next_to_intlayer.md

@@ -47,7 +47,7 @@ Intlayer est également la solution avec le **développement le plus actif** dan
 
 <Accordion header="Agent IA">
 
-Colocaliser le contenu **réduit le contexte nécessaire** pour les Grands Modèles de Langage (LLM). Intlayer est également livré avec une suite d'outils, tels qu'une **CLI** pour tester les traductions manquantes, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/mcp_server.md)**, et des **[compétences d'agent](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/agent_skills.md)**, pour rendre l'expérience développeur (DX) encore plus fluide pour les agents IA.
+Colocaliser le contenu **réduit le contexte nécessaire** pour les Grands Modèles de Langage (LLM). Intlayer est également livré avec une suite d'outils, tels qu'une **CLI** pour tester les traductions manquantes, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/mcp_server.md)**, et des **[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/agent_skills.md)**, pour rendre l'expérience développeur (DX) encore plus fluide pour les agents IA.
 
 </Accordion>
 

package/docs/fr/migration_from_next-intl_to_intlayer.md

@@ -45,7 +45,7 @@ Intlayer est également la solution avec le **développement le plus actif** dan
 
 <Accordion header="Agent IA">
 
-Colocaliser le contenu **réduit le contexte nécessaire** pour les Grands Modèles de Langage (LLM). Intlayer est également livré avec une suite d'outils, tels qu'une **CLI** pour tester les traductions manquantes, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/mcp_server.md)**, et des **[compétences d'agent](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/agent_skills.md)**, pour rendre l'expérience développeur (DX) encore plus fluide pour les agents IA.
+Colocaliser le contenu **réduit le contexte nécessaire** pour les Grands Modèles de Langage (LLM). Intlayer est également livré avec une suite d'outils, tels qu'une **CLI** pour tester les traductions manquantes, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/mcp_server.md)**, et des **[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/agent_skills.md)**, pour rendre l'expérience développeur (DX) encore plus fluide pour les agents IA.
 
 </Accordion>
 

package/docs/fr/migration_from_nuxtjs_i18n_to_intlayer.md

@@ -46,7 +46,7 @@ Intlayer est également la solution avec le **développement le plus actif** dan
 
 <Accordion header="Agent IA">
 
-Colocaliser le contenu **réduit le contexte nécessaire** pour les Grands Modèles de Langage (LLM). Intlayer est également livré avec une suite d'outils, tels qu'une **CLI** pour tester les traductions manquantes, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/mcp_server.md)**, et des **[compétences d'agent](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/agent_skills.md)**, pour rendre l'expérience développeur (DX) encore plus fluide pour les agents IA.
+Colocaliser le contenu **réduit le contexte nécessaire** pour les Grands Modèles de Langage (LLM). Intlayer est également livré avec une suite d'outils, tels qu'une **CLI** pour tester les traductions manquantes, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/mcp_server.md)**, et des **[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/agent_skills.md)**, pour rendre l'expérience développeur (DX) encore plus fluide pour les agents IA.
 
 </Accordion>
 

package/docs/fr/migration_from_react-i18next_to_intlayer.md

@@ -46,7 +46,7 @@ Intlayer est également la solution avec le **développement le plus actif** dan
 
 <Accordion header="Agent IA">
 
-Colocaliser le contenu **réduit le contexte nécessaire** pour les Grands Modèles de Langage (LLM). Intlayer est également livré avec une suite d'outils, tels qu'une **CLI** pour tester les traductions manquantes, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/mcp_server.md)**, et des **[compétences d'agent](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/agent_skills.md)**, pour rendre l'expérience développeur (DX) encore plus fluide pour les agents IA.
+Colocaliser le contenu **réduit le contexte nécessaire** pour les Grands Modèles de Langage (LLM). Intlayer est également livré avec une suite d'outils, tels qu'une **CLI** pour tester les traductions manquantes, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/mcp_server.md)**, et des **[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/agent_skills.md)**, pour rendre l'expérience développeur (DX) encore plus fluide pour les agents IA.
 
 </Accordion>
 

package/docs/fr/migration_from_vue-i18n_to_intlayer.md

@@ -45,7 +45,7 @@ Intlayer est également la solution avec le **développement le plus actif** dan
 
 <Accordion header="Agent IA">
 
-Colocaliser le contenu **réduit le contexte nécessaire** pour les Grands Modèles de Langage (LLM). Intlayer est également livré avec une suite d'outils, tels qu'une **CLI** pour tester les traductions manquantes, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/mcp_server.md)**, et des **[compétences d'agent](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/agent_skills.md)**, pour rendre l'expérience développeur (DX) encore plus fluide pour les agents IA.
+Colocaliser le contenu **réduit le contexte nécessaire** pour les Grands Modèles de Langage (LLM). Intlayer est également livré avec une suite d'outils, tels qu'une **CLI** pour tester les traductions manquantes, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/mcp_server.md)**, et des **[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/agent_skills.md)**, pour rendre l'expérience développeur (DX) encore plus fluide pour les agents IA.
 
 </Accordion>
 

package/docs/fr/packages/intlayer/getLocalizedPath.md

@@ -128,6 +128,20 @@ getLocalizedPath("/contact", Locales.FRENCH, manualRules);
 
 ---
 
+### Omission de la locale
+
+Quand aucune locale n'est donnée, le chemin est localisé pour la locale par défaut configurée :
+
+```typescript codeFormat="typescript"
+import { getLocalizedPath } from "intlayer";
+
+// Configuration: defaultLocale = Locales.ENGLISH, { '/about': { en: '/about', fr: '/a-propos' } }
+getLocalizedPath("/about");
+// Output: "/about"
+```
+
+---
+
 ## Fonctions associées
 
 - [`getCanonicalPath`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/packages/intlayer/getCanonicalPath.md) : Résout un chemin localisé en son chemin canonique interne.

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

@@ -56,7 +56,7 @@ export default defineConfig({
 2. `build.optimize` est à `true` (ou `undefined`, qui vaut par défaut `true` pour les builds).
 3. `build.minify` est à `true` dans votre configuration Intlayer.
 
-Il est automatiquement **désactivé** lorsque `editor.enabled` est à `true` car l'éditeur a besoin du contenu complet et lisible par l'homme du dictionnaire.
+Lorsque `editor.enabled` est `true`, le plugin s'exécute toujours mais **ignore le renommage des champs** : le renommage réécrit les clés de contenu que l'interpréteur parcourt, donc le `keyPath` reçu par l'éditeur visuel ne correspondrait plus aux dictionnaires non fusionnés qu'il édite. La compaction des espaces et la suppression des métadonnées de premier niveau restent actives.
 
 ## Ce qui est minifié
 

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

@@ -115,4 +115,4 @@ Lorsque l'élagage réussit, `intlayerPrune` écrit également `pruneContext.dic
 2. `build.optimize` est `true` (ou `undefined`, qui est `true` par défaut pour les builds).
 3. `build.purge` est `true` dans votre configuration Intlayer.
 
-Il est automatiquement **désactivé** quand `editor.enabled` est `true` car l'éditeur a besoin du contenu complet du dictionnaire.
+Il reste actif lorsque `editor.enabled` est `true` : l'éditeur visuel résout chaque modification via `dictionaryKey` + `keyPath` par rapport aux dictionnaires non fusionnés, que ce plugin ne touche jamais, et un champ purgé est un champ qu'aucun composant ne lit — il n'est donc jamais rendu ni sélectionnable dans la page.

package/docs/hi/agent_skills.md

@@ -1,11 +1,11 @@
 ---
 createdAt: 2026-02-09
 updatedAt: 2026-03-03
-title: एजेंट स्किल्स
-description: जानें कि Intlayer एजेंट स्किल्स का उपयोग करके अपने AI एजेंट की आपके प्रोजेक्ट की समझ कैसे बेहतर करें, जिसमें मेटाडेटा, साइटमैप और सर्वर क्रियाओं के लिए व्यापक सेटअप गाइड शामिल हैं।
+title: Agent Skills
+description: जानें कि Intlayer Agent Skills का उपयोग करके अपने AI एजेंट की आपके प्रोजेक्ट की समझ कैसे बेहतर करें, जिसमें मेटाडेटा, साइटमैप और सर्वर क्रियाओं के लिए व्यापक सेटअप गाइड शामिल हैं।
 keywords:
   - Intlayer
-  - एजेंट स्किल्स
+  - Agent Skills
   - AI एजेंट
   - Internationalization
   - डॉक्यूमेंटेशन
@@ -19,13 +19,13 @@ history:
 author: aymericzip
 ---
 
-# एजेंट स्किल्स
+# Agent Skills
 
 ## सेटअप
 
 ### CLI का उपयोग करके
 
-`intlayer init skills` कमांड आपके प्रोजेक्ट में एजेंट स्किल्स सेटअप करने का सबसे आसान तरीका है। यह आपके वातावरण का पता लगाता है और आपके पसंदीदा प्लेटफ़ॉर्म के लिए आवश्यक कॉन्फ़िगरेशन फ़ाइलें इंस्टॉल करता है।
+`intlayer init skills` कमांड आपके प्रोजेक्ट में Agent Skills सेटअप करने का सबसे आसान तरीका है। यह आपके वातावरण का पता लगाता है और आपके पसंदीदा प्लेटफ़ॉर्म के लिए आवश्यक कॉन्फ़िगरेशन फ़ाइलें इंस्टॉल करता है।
 
 ```bash packageManager="npm"
 npx intlayer init skills
@@ -54,10 +54,10 @@ npx skills add aymericzip/intlayer-skills
 1. कमांड पैलेट खोलें (Ctrl+Shift+P या Cmd+Shift+P)।
 2. `Intlayer: Setup AI Agent Skills` टाइप करें।
 3. उस प्लेटफ़ॉर्म को चुनें जिसका आप उपयोग करते हैं (उदा. `VS Code`, `Cursor`, `Windsurf`, `OpenCode`, `Claude Code`, `GitHub Copilot Workspace`, आदि)।
-4. वे स्किल्स चुनें जिन्हें आप इंस्टॉल करना चाहते हैं (उदा. `Next.js`, `React`, `Vite`, `Compiler`, `Configuration`)।
+4. वे Agent Skills चुनें जिन्हें आप इंस्टॉल करना चाहते हैं (उदा. `Next.js`, `React`, `Vite`, `Compiler`, `Configuration`)।
 5. Enter दबाएं।
 
-## स्किल्स सूची
+## Agent Skills सूची
 
 **intlayer-config**