@intlayer/docs 9.4.4 → 9.5.0

package/docs/fr/bundle_optimization.md

@@ -133,8 +133,6 @@ Pendant `next build`, `withIntlayer` analyse vos sources, réécrit les dictionn
 
 > La purge et la minification ne s'exécutent que lors de `next build` — le pipeline d'optimisation est désactivé pendant `next dev`.
 
-> Elles sont également désactivées lorsque des appelants d'adaptateurs de compatibilité sont configurés (`swcExtraCallers`, définis par les paquets de compatibilité tels que `@intlayer/next-intl` ou `@intlayer/react-i18next`) : ces sites d'appel sont invisibles pour l'analyseur d'usage, et purger supprimerait donc des champs que le code lit encore. La réécriture des imports reste active.
-
 **Les versions antérieures (avant 9.2.1)** nécessitaient `@intlayer/babel` et un `babel.config.js` déclarant `intlayerPurgeBabelPlugin` et `intlayerMinifyBabelPlugin`. Ce fichier n'est plus nécessaire et peut être supprimé.
 
  </Tab>

package/docs/fr/cli/index.md

@@ -70,14 +70,10 @@ author: aymericzip
 
 # CLI Intlayer - Toutes les commandes CLI Intlayer pour votre site multilingue
 
----
-
 ## Table des matières
 
 <TOC/>
 
----
-
 ## Installer le paquet
 
 Installez les paquets nécessaires avec npm :

package/docs/fr/cli/login.md

@@ -20,8 +20,6 @@ author: aymericzip
 
 # Commande `login` de l'Intlayer CLI
 
----
-
 ## Description
 
 La commande `login` de l'Intlayer CLI vous permet de vous authentifier auprès du CMS Intlayer. Cette commande ouvre automatiquement votre navigateur par défaut pour compléter le processus d'authentification et recevoir les identifiants nécessaires (Client ID et Client Secret) pour utiliser les services Intlayer.

package/docs/fr/compiler.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-09-09
-updatedAt: 2026-06-23
+updatedAt: 2026-09-08
 title: Compilateur Intlayer | Extraction automatique de contenu pour l'i18n
 description: Automatisez votre processus d'internationalisation avec le compilateur Intlayer. Extrayez le contenu directement de vos composants pour une i18n plus rapide et plus efficace dans Vite, Next.js, et plus encore.
 keywords:
@@ -68,7 +68,7 @@ Comme alternative, pour automatiser votre processus i18n tout en gardant un cont
 
 ## Utilisation
 
-> The quickest way to wire the compiler in is the interactive setup: run `npx intlayer init --interactive` and select **Compiler**. On Vite there is nothing to configure — the compiler is plugged in directly through the `intlayerCompiler()` plugin. On Next.js the command scaffolds the `babel.config.js` shown below. The non-interactive `intlayer init` leaves the compiler setup untouched.
+> La façon la plus rapide d'intégrer le compilateur est la configuration interactive : exécutez `npx intlayer init --interactive` et sélectionnez **Compiler**. Sur Next.js et Vite, il s'active automatiquement dès que `compiler.enabled` est défini et qu'un chemin `compiler.output` est configuré.
 
 <Tabs>
  <Tab value='vite'>
@@ -92,19 +92,13 @@ import { defineConfig } from "vite";
 import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
-  plugins: [
-    intlayer({
-      proxy: {
-        ignore: (req) => req.url?.startsWith("/api"),
-      },
-    }),
-  ],
+  plugins: [intlayer()],
 });
 ```
 
 > Le plugin autonome `intlayerCompiler()` est toujours exporté pour les configurations avancées. L'enregistrer aux côtés de `intlayer()` est sûr — le compilateur se déduplique lui-même et s'exécute une seule fois.
 
-See complete tutorial: [Intlayer Compiler with Vite+React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_vite+react_compiler.md)
+See complete tutorial: [Translate Vite and React with Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_vite+react.md)
 
 #### Support des frameworks
 
@@ -131,9 +125,35 @@ npm install @intlayer/svelte-compiler
  </Tab>
  <Tab value='nextjs'>
 
-### Next.js (Babel)
+### Next.js
 
-Pour Next.js ou d'autres applications basées sur Webpack utilisant Babel, vous pouvez configurer le compilateur en utilisant le plugin `@intlayer/babel`.
+Sur Next.js, le compilateur fonctionne comme un bundler loader, `next-intlayer/extractor-loader`. `withIntlayer` l'enregistre pour vous sur **à la fois** Turbopack et webpack, il n'y a aucun fichier `babel.config.js` à écrire.
+
+#### Installation
+
+```bash
+npm install @intlayer/babel
+```
+
+#### Configuration
+
+Rien à configurer. Tant que votre `next.config.ts` passe par `withIntlayer`, installer `@intlayer/babel` suffit pour que le loader soit enregistré :
+
+```ts fileName="next.config.ts"
+import { withIntlayer } from "next-intlayer/server";
+
+export default withIntlayer({});
+```
+
+Le loader s'exécute sur les fichiers `.tsx` et `.jsx`, avant `next-swc-loader`, il lit donc votre JSX d'origine. Le contenu déclaré dans vos composants est extrait dans des fichiers `.content` et compilé dans `.intlayer` lors de la compilation du fichier.
+
+ </Tab>
+
+ <Tab value="Babel">
+
+### Babel
+
+Pour les applications basées sur Webpack utilisant Babel, vous pouvez configurer le compilateur en utilisant le plugin `@intlayer/babel`.
 
 #### Installation
 
@@ -166,8 +186,6 @@ module.exports = {
 
 Cette configuration garantit que le contenu déclaré dans vos composants est automatiquement extrait et utilisé pour générer les dictionnaires lors de votre processus de build.
 
-See complete tutorial: [Intlayer Compiler with Next.js](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_nextjs_compiler.md)
-
  </Tab>
 </Tabs>
 

package/docs/fr/configuration.md

@@ -122,14 +122,10 @@ author: aymericzip
 
 Les fichiers de configuration Intlayer vous permettent de personnaliser divers aspects du plugin, tels que l'internationalisation (internationalization), le middleware et la gestion du contenu. Cette documentation fournit une description détaillée de chaque propriété de la configuration.
 
----
-
 ## Table des Matières
 
 <TOC/>
 
----
-
 ## Formats de fichiers de configuration supportés
 
 Intlayer accepte les formats de fichiers de configuration JSON, JS, MJS et TS :
@@ -143,8 +139,6 @@ Intlayer accepte les formats de fichiers de configuration JSON, JS, MJS et TS :
 - `intlayer.config.mjs`
 - `.intlayerrc`
 
----
-
 ## Exemple de fichier de configuration
 
 ````typescript fileName="intlayer.config.ts" codeFormat="typescript"
@@ -699,14 +693,10 @@ const config: IntlayerConfig = {
 export default config;
 ````
 
----
-
 ## Référence de Configuration
 
 Les sections suivantes décrivent les différents paramètres de configuration disponibles dans Intlayer.
 
----
-
 ### Configuration de l'Internationalisation (Internationalization Configuration)
 
 Définit les paramètres liés à l'internationalisation, y compris les locales disponibles et la locale par défaut de l'application.
@@ -718,8 +708,6 @@ Définit les paramètres liés à l'internationalisation, y compris les 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.                                                                                                                                                                                                                        |
 
----
-
 ### Configuration de l'Éditeur (Editor Configuration)
 
 Définit les paramètres liés à l'éditeur intégré, y compris le port du serveur et l'état d'activité.
@@ -751,8 +739,6 @@ Les analytics sont désactivables (opt-out) : elles sont activées par défaut e
 | `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).                                             |
 
----
-
 ### 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.
@@ -954,8 +940,6 @@ const config: IntlayerConfig = {
 export default config;
 ```
 
----
-
 ### Configuration du Contenu (Content Configuration)
 
 Paramètres relatifs au traitement du contenu dans l'application (noms de répertoires, extensions de fichiers et configurations dérivées).
@@ -969,8 +953,6 @@ Paramètres relatifs au traitement du contenu dans l'application (noms de réper
 | `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).                              |
 
----
-
 ### Configuration Système (System Configuration)
 
 Ces paramètres sont destinés aux cas d'utilisation avancés et à la configuration interne d'Intlayer.
@@ -1024,8 +1006,6 @@ dictionary: {
 };
 ```
 
----
-
 ### Configuration du Logger (Logger Configuration)
 
 Paramètres pour personnaliser la sortie des logs d'Intlayer.
@@ -1096,8 +1076,6 @@ Les options de build s'appliquent aux plugins `@intlayer/babel` et `@intlayer/sw
 | `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
 
 Paramètres qui contrôlent le compilateur Intlayer, qui extrait les dictionnaires directement de vos composants.
@@ -1117,8 +1095,6 @@ Paramètres qui contrôlent le compilateur Intlayer, qui extrait les dictionnair
 | --------- | --------------------------------------------------------------------------------- | --------------------------- |
 | `schemas` | Permet de définir des schémas Zod pour valider la structure de vos dictionnaires. | `Record<string, ZodSchema>` |
 
----
-
 ### Plugins
 
 | Champ     | Description                           | Type               |
@@ -1134,25 +1110,21 @@ Paramètres qui contrôlent le compilateur Intlayer, qui extrait les dictionnair
 À la racine de votre projet, à côté de `package.json`. Intlayer accepte aussi `intlayer.config.js`, `intlayer.config.mjs`, `intlayer.config.cjs` et le JSON, afin que le fichier corresponde au système de modules utilisé par votre projet.
 
 </Question>
-
 <Question title="Quel poids l'i18n ajoute-t-elle à la taille de mon bundle ?">
 
 Bien moins qu'une configuration basée sur des espaces de noms, car une page ne télécharge jamais un catalogue qu'elle n'affiche pas. Le balisage rendu côté serveur résout son contenu sur le serveur, et le compilateur au moment du build remplace les appels `useIntlayer` par les entrées de dictionnaire exactes qu'un composant utilise, si bien que les clés inutilisées et les langues inutilisées sont éliminées. Les [dictionnaires dynamiques](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/dynamic_dictionaries/index.md) répartissent le reste par locale. Mesuré face aux alternatives habituelles, Intlayer réduit la taille du bundle et des pages jusqu'à 50 %. Voir l'[optimisation du bundle](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/bundle_optimization.md) et le [benchmark](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/benchmark/index.md).
 
 </Question>
-
 <Question title="Puis-je migrer depuis `i18next`, `next-intl` ou `react-i18next` sans réécrire mes composants ?">
 
 Oui, et il existe deux voies. Vous pouvez migrer le contenu progressivement avec le [guide de migration i18next](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/migration_from_i18next_to_intlayer.md) ou le [guide de migration next-intl](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/migration_from_next-intl_to_intlayer.md). Ou vous pouvez conserver entièrement votre API actuelle : les [adaptateurs de compatibilité](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/compat/index.md) exposent exactement la même API que `i18next`, `react-i18next`, `next-intl`, `next-i18next`, `react-intl`, `use-intl`, `vue-i18n` et `Lingui`, mais servie par des dictionnaires Intlayer : seuls les imports changent, pas le code des composants.
 
 </Question>
-
 <Question title="Puis-je conserver mes fichiers de traduction JSON existants ?">
 
 Oui. Le [plugin de synchronisation JSON](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/plugins/sync-json.md) conserve vos fichiers `/messages/{locale}/{namespace}.json` comme source de vérité et génère les dictionnaires Intlayer à partir d'eux, dans les deux sens. Un [plugin de synchronisation PO](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/plugins/sync-po.md) fait de même pour les catalogues gettext, et les [fichiers par locale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/per_locale_file.md) permettent de séparer le contenu par langue au lieu de regrouper les locales dans un seul fichier.
 
 </Question>
-
 <Question title="Dois-je déplacer mon contenu clé par clé ?">
 
 Non. Lancez `npx intlayer extract` et Intlayer lit vos fichiers source, en extrait les chaînes destinées aux utilisateurs et écrit un fichier `.content` à côté de chacun, de sorte que vous relisez un diff plutôt que de copier des chaînes dans un catalogue une par une. Voir la [commande extract](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/cli/extract.md).
@@ -1160,7 +1132,6 @@ Non. Lancez `npx intlayer extract` et Intlayer lit vos fichiers source, en extra
 Pour un pipeline entièrement automatisé, le [compilateur Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/compiler.md) fait la même chose au moment du build sur du code source JSX, TSX, Vue et Svelte, en générant les dictionnaires à chaque changement, de sorte qu'il n'y a aucune clé à maintenir à la main. Il fonctionne par analyse statique : les chaînes qui n'existent qu'à l'exécution restent hors de portée, et il a besoin de quelques annotations pour distinguer le texte destiné aux utilisateurs de la logique applicative.
 
 </Question>
-
 <Question title="Quels outils d'éditeur et d'agent IA sont disponibles ?">
 
 Cinq éléments, tous optionnels :
@@ -1172,49 +1143,41 @@ Cinq éléments, tous optionnels :
 - **[Plugin ESLint](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/eslint.md)** : `no-raw-text` signale les chaînes codées en dur, avec d'autres règles pour les clés de dictionnaire statiques et le contenu inutilisé.
 
 </Question>
-
 <Question title="Comment ajouter une nouvelle langue à mon application ?">
 
 Ajoutez la locale à `internationalization.locales`, puis lancez `npx intlayer fill` pour traduire le contenu existant vers celle-ci. Les types générés se mettent à jour en même temps, si bien que tout fichier de contenu auquel il manque la nouvelle locale devient une erreur de type plutôt qu'un repli silencieux.
 
 </Question>
-
 <Question title="Comment retirer le préfixe de locale de mes URL ?">
 
 Définissez `routing.mode`. La valeur par défaut `"prefix-no-default"` donne `/about` pour la locale par défaut et `/fr/about` pour les autres. `"prefix-all"` préfixe toutes les locales. `"no-prefix"` maintient la locale entièrement hors du chemin et la résout à partir d'un cookie, d'un en-tête ou d'un domaine. `"search-params"` la place dans la chaîne de requête sous la forme `/about?locale=fr`.
 
 </Question>
-
 <Question title="Puis-je servir chaque langue depuis son propre domaine ?">
 
 Oui. `routing.domains` associe une locale à un nom d'hôte, par exemple `{ fr: 'example.fr', en: 'example.com' }`. Le domaine identifie la locale, donc aucun préfixe n'est ajouté au chemin, et `getLocalizedUrl` renvoie une URL absolue sur le bon domaine.
 
 </Question>
-
 <Question title="Comment la langue de l'utilisateur est-elle détectée ?">
 
 Via `routing.storage`, qui liste les sources à lire dans l'ordre, généralement l'URL, puis un cookie, puis l'en-tête `Accept-Language`. Un choix explicite de l'utilisateur est persisté afin qu'il l'emporte à la visite suivante.
 
 </Question>
-
 <Question title="Que fait routing.enableProxy ?">
 
 Il contrôle le proxy de routage de locale, le middleware qui résout les préfixes et effectue les redirections. Laissé non défini, le proxy s'exécute mais les serveurs de développement et de prévisualisation ignorent la locale stockée comme source de redirection, ce qui évite d'être renvoyé vers une langue que vous ne testez pas ; la production se comporte comme si sa valeur était `true`. Réglez-le sur `false` pour gérer vous-même le routage de locale.
 
 </Question>
-
 <Question title="Quelle est la différence entre importMode static, dynamic et fetch ?">
 
 `"static"`, la valeur par défaut, importe les dictionnaires de manière statique afin qu'ils soient inclus dans le bundle et lus de manière synchrone. `"dynamic"` les importe via Suspense, si bien qu'une locale n'est téléchargée que lorsqu'un composant l'affiche, ce qui est ce que vous voulez pour de grands ensembles de contenu. `"fetch"` les récupère depuis l'API de synchronisation en direct et se replie sur `"dynamic"` en cas d'échec. Voir l'[optimisation du bundle](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/bundle_optimization.md) et les [dictionnaires dynamiques](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/dynamic_dictionaries/index.md).
 
 </Question>
-
 <Question title="Où définir le fournisseur d'IA et la clé d'API pour la traduction automatique ?">
 
 Soit dans le fichier de configuration, soit en ligne de commande avec `--provider`, `--model` et `--api-key`. La clé reste la vôtre : les appels de traduction partent de votre machine ou de votre runner CI vers le fournisseur que vous avez choisi, si bien que rien ne transite par un tiers. Voir la [commande fill](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/cli/fill.md).
 
 </Question>
-
 <Question title="Dois-je redémarrer le serveur de développement après avoir changé la configuration ?">
 
 En général non. Le watcher d'Intlayer surveille `intlayer.config.ts` lui-même : à l'enregistrement, il recharge la configuration et prépare de nouveau les dictionnaires, si bien qu'ajouter une locale ou changer un mode de routage est pris en compte comme un changement de contenu. Cependant, la configuration peut être mise en cache par les systèmes. Redémarrer votre application peut être une bonne solution.

package/docs/fr/dictionary/html.md

@@ -119,8 +119,6 @@ const myContent = html(
 
 Lors de l'utilisation de la méthode `.use()` sur un nœud HTML, les composants que vous fournissez seront vérifiés par rapport à la définition fournie dans la fonction `html()` (si disponible).
 
----
-
 ## Rendu du HTML
 
 Le rendu peut être géré automatiquement par le système de contenu d'Intlayer ou manuellement à l'aide d'outils spécialisés.
@@ -474,8 +472,6 @@ Vous pouvez configurer le rendu HTML globalement pour l'ensemble de votre applic
   </Tab>
 </Tabs>
 
----
-
 ### Rendu Manuel et Outils Avancés
 
 Si vous avez besoin de rendre des chaînes HTML brutes ou si vous voulez plus de contrôle sur le mappage des composants, utilisez les outils suivants.
@@ -648,8 +644,6 @@ Si vous avez besoin de rendre des chaînes HTML brutes ou si vous voulez plus de
   </Tab>
 </Tabs>
 
----
-
 ## Référence des Options
 
 Ces options peuvent être passées à `HTMLProvider`, `HTMLRenderer`, `useHTMLRenderer` et `renderHTML`.

package/docs/fr/dictionary/markdown.md

@@ -1172,8 +1172,6 @@ export class MyComponent {
   </Tab>
 </Tabs>
 
----
-
 ## Rendu Côté Serveur (SSR) et Hydratation
 
 En comparaison avec d'autres parseurs Markdown tels que remark / rehype, Intlayer Markdown est sans dépendance et s'exécute aussi bien côté client que côté serveur.

package/docs/fr/how_works_intlayer.md

@@ -267,25 +267,21 @@ Le package `@intlayer/backend` exporte des types backend et proposera éventuell
 Au moment du build. Le plugin du bundler, ou `npx intlayer build`, analyse vos fichiers `.content.ts`, les résout en dictionnaires dans le dossier `.intlayer`, et génère les types TypeScript correspondants. À l'exécution, vos composants ne font que lire le résultat, si bien qu'aucune analyse ni chargement de fichier ne se produit sur le chemin de la requête.
 
 </Question>
-
 <Question title="Quel poids l'i18n ajoute-t-elle à la taille de mon bundle ?">
 
 Bien moins qu'une configuration basée sur des espaces de noms, car une page ne télécharge jamais un catalogue qu'elle n'affiche pas. Le balisage rendu côté serveur résout son contenu sur le serveur, et le compilateur au moment du build remplace les appels `useIntlayer` par les entrées de dictionnaire exactes qu'un composant utilise, si bien que les clés inutilisées et les langues inutilisées sont éliminées. Les [dictionnaires dynamiques](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/dynamic_dictionaries/index.md) répartissent le reste par locale. Mesuré face aux alternatives habituelles, Intlayer réduit la taille du bundle et des pages jusqu'à 50 %. Voir l'[optimisation du bundle](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/bundle_optimization.md) et le [benchmark](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/benchmark/index.md).
 
 </Question>
-
 <Question title="Puis-je migrer depuis `i18next`, `next-intl` ou `react-i18next` sans réécrire mes composants ?">
 
 Oui, et il existe deux voies. Vous pouvez migrer le contenu progressivement avec le [guide de migration i18next](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/migration_from_i18next_to_intlayer.md) ou le [guide de migration next-intl](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/migration_from_next-intl_to_intlayer.md). Ou vous pouvez conserver entièrement votre API actuelle : les [adaptateurs de compatibilité](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/compat/index.md) exposent exactement la même API que `i18next`, `react-i18next`, `next-intl`, `next-i18next`, `react-intl`, `use-intl`, `vue-i18n` et `Lingui`, mais servie par des dictionnaires Intlayer : seuls les imports changent, pas le code des composants.
 
 </Question>
-
 <Question title="Puis-je conserver mes fichiers de traduction JSON existants ?">
 
 Oui. Le [plugin de synchronisation JSON](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/plugins/sync-json.md) conserve vos fichiers `/messages/{locale}/{namespace}.json` comme source de vérité et génère les dictionnaires Intlayer à partir d'eux, dans les deux sens. Un [plugin de synchronisation PO](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/plugins/sync-po.md) fait de même pour les catalogues gettext, et les [fichiers par locale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/per_locale_file.md) permettent de séparer le contenu par langue au lieu de regrouper les locales dans un seul fichier.
 
 </Question>
-
 <Question title="Dois-je déplacer mon contenu clé par clé ?">
 
 Non. Lancez `npx intlayer extract` et Intlayer lit vos fichiers source, en extrait les chaînes destinées aux utilisateurs et écrit un fichier `.content` à côté de chacun, de sorte que vous relisez un diff plutôt que de copier des chaînes dans un catalogue une par une. Voir la [commande extract](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/cli/extract.md).
@@ -293,7 +289,6 @@ Non. Lancez `npx intlayer extract` et Intlayer lit vos fichiers source, en extra
 Pour un pipeline entièrement automatisé, le [compilateur Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/compiler.md) fait la même chose au moment du build sur du code source JSX, TSX, Vue et Svelte, en générant les dictionnaires à chaque changement, de sorte qu'il n'y a aucune clé à maintenir à la main. Il fonctionne par analyse statique : les chaînes qui n'existent qu'à l'exécution restent hors de portée, et il a besoin de quelques annotations pour distinguer le texte destiné aux utilisateurs de la logique applicative.
 
 </Question>
-
 <Question title="Quels outils d'éditeur et d'agent IA sont disponibles ?">
 
 Cinq éléments, tous optionnels :
@@ -305,43 +300,36 @@ Cinq éléments, tous optionnels :
 - **[Plugin ESLint](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/eslint.md)** : `no-raw-text` signale les chaînes codées en dur, avec d'autres règles pour les clés de dictionnaire statiques et le contenu inutilisé.
 
 </Question>
-
 <Question title="Qu'est-ce que le dossier .intlayer et dois-je le versionner ?">
 
 C'est la sortie générée : les dictionnaires compilés et les types générés. Il est dérivé de vos fichiers de contenu, il doit donc figurer dans `.gitignore` et être reconstruit par votre étape de build, exactement comme un dossier `dist`.
 
 </Question>
-
 <Question title="Comment la locale active est-elle déterminée ?">
 
 À partir des sources listées dans `routing.storage`, dans l'ordre : le préfixe d'URL lorsque `routing.mode` en utilise un, puis un cookie, puis l'en-tête `Accept-Language`, puis votre locale par défaut. Une locale que l'utilisateur choisit explicitement est persistée, elle survit donc à la visite suivante. Voir la [référence de configuration](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/configuration.md).
 
 </Question>
-
 <Question title="Quelle est la différence entre les dictionnaires locaux et distants ?">
 
 Un dictionnaire local est déclaré dans votre base de code et compilé avec votre application. Un dictionnaire distant est géré dans le [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/intlayer_CMS.md) et résolu à l'exécution, il peut donc changer sans déploiement. Les deux sont lus via les mêmes hooks, et le contenu distant se replie sur la déclaration locale lorsqu'il est indisponible.
 
 </Question>
-
 <Question title="Intlayer fonctionne-t-il sans TypeScript ?">
 
 Oui. Les fichiers de contenu peuvent être écrits en TypeScript, JavaScript, ESM, CommonJS ou JSON. C'est TypeScript qui débloque les types générés et l'autocomplétion, c'est donc la configuration recommandée, mais elle n'est pas obligatoire.
 
 </Question>
-
 <Question title="Comment le rendu serveur et le rendu client partagent-ils le même contenu ?">
 
 Le serveur résout directement le contenu des composants rendus côté serveur, si bien qu'aucun dictionnaire n'est envoyé au client pour ce balisage. Les composants client lisent les mêmes dictionnaires via le provider, qui reçoit la locale résolue sur le serveur, si bien que le premier rendu client correspond au HTML du serveur et n'affiche pas brièvement une autre langue.
 
 </Question>
-
 <Question title="Comment Intlayer évite-t-il une incohérence d'hydratation sur la locale ?">
 
 La locale est résolue une seule fois sur le serveur et transmise au provider, plutôt que d'être à nouveau détectée dans le navigateur. Comme le client part de la même locale que celle rendue par le serveur, le balisage correspond, ce qui est justement ce qui casse habituellement avec la détection de locale côté client.
 
 </Question>
-
 <Question title="Dois-je reconstruire lorsque j'ajoute une traduction ?">
 
 En développement, non : le plugin surveille vos fichiers de contenu et reconstruit les dictionnaires affectés à l'enregistrement. En production, les dictionnaires font partie du build, sauf si le contenu est distant, auquel cas le [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/intlayer_CMS.md) et la [synchronisation en direct](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/cli/live.md) appliquent le changement sans déploiement.

package/docs/fr/interest_of_intlayer.md

@@ -44,43 +44,36 @@ Par rapport aux solutions principales telles que `next-intl` ou `i18next`, Intla
 Au lieu de charger de lourds fichiers JSON dans vos pages, ne chargez que le contenu strictement nécessaire. Intlayer vous aide à **réduire la taille de votre bundle et de vos pages jusqu'à 50 %**.
 
 </Accordion>
-
 <Accordion header="Maintenabilité">
 
 Déclarer le contenu directement au plus près de vos composants **facilite la maintenance** des applications de grande envergure. Vous pouvez dupliquer ou supprimer le dossier d'une fonctionnalité sans le fardeau mental de devoir passer en revue toute votre base de code de contenu. De plus, Intlayer est **entièrement typé** pour garantir l'exactitude de vos traductions.
 
 </Accordion>
-
 <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/fr/lsp.md)**, un **[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)**, afin de rendre l'expérience développeur (DX) encore plus fluide pour les agents IA.
 
 </Accordion>
-
 <Accordion header="Fonctionnalité">
 
 Intlayer offre un ensemble de fonctionnalités supplémentaires que les autres solutions i18n n'ont pas, telles que le [support de Markdown](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/dictionary/markdown.md), la [récupération de contenu externe](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/dictionary/function_fetching.md), le [chargement de contenu de fichiers](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/dictionary/file.md), la [mise à jour en direct du contenu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/cli/live.md), l'[éditeur visuel](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/intlayer_visual_editor.md) et plus encore.
 
 </Accordion>
-
 <Accordion header="Automatisation">
 
 Automatisez les traductions dans votre pipeline CI/CD en utilisant le LLM de votre choix au coût de votre propre fournisseur d'IA. Intlayer propose également un **compilateur** pour automatiser l'extraction de contenu, ainsi qu'une [plateforme web](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/intlayer_CMS.md) pour vous aider à **traduire en arrière-plan**.
 
 </Accordion>
-
 <Accordion header="Performances">
 
 Associer de gros fichiers JSON à vos composants peut ralentir les performances et impacter la réactivité. Intlayer optimise le chargement du contenu directement au moment du **build**.
 
 </Accordion>
-
 <Accordion header="Collaboration avec les non-développeurs">
 
 Bien plus qu'une simple solution i18n, Intlayer propose un **[éditeur visuel](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/intlayer_visual_editor.md)** auto-hébergé et un **[CMS complet](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/intlayer_CMS.md)** pour gérer votre contenu multilingue en **temps réel**. Cela rend la collaboration avec les traducteurs, concepteurs-rédacteurs et autres membres de l'équipe extrêmement simple. Le contenu peut être stocké localement et/ou à distance.
 
 </Accordion>
-
 <Accordion header="Conception multi-cadre">
 
 Si vous utilisez différents frameworks pour différentes parties de votre application (par exemple, React, React-native, Vue, Angular, Svelte, etc.), Intlayer fournit un moyen d'**utiliser une syntaxe et une implémentation communes dans tous les principaux frameworks frontaux**. Vous pourrez également partager votre déclaration de contenu sur votre système de conception, vos applications, votre backend, etc.
@@ -282,8 +275,6 @@ Les étoiles GitHub sont un indicateur fort de la popularité d'un projet, de la
 
 [![Star History Chart](https://api.star-history.com/chart?repos=aymericzip/intlayer%2Cformatjs/formatjs%2Ci18next/react-i18next%2Ci18next/i18next%2Ci18next/next-i18next%2Clingui/js-lingui%2Camannn/next-intl%2Cintlify/vue-i18n%2Ccodingcommons/typesafe-i18n%2Copral/paraglide-js&type=date&legend=top-left)](https://www.star-history.com/#aymericzip/intlayer&formatjs/formatjs&i18next/react-i18next&i18next/i18next&i18next/next-i18next&lingui/js-lingui&amannn/next-intl&intlify/vue-i18n&codingcommons/typesafe-i18n&opral/paraglide-js)
 
----
-
 ## Interopérabilité
 
 `intlayer` peut également aider à gérer vos espaces de noms `react-intl`, `react-i18next`, `next-intl`, `next-i18next` et `vue-i18n`.
@@ -305,25 +296,21 @@ Trois générations coexistent :
 - **Bibliothèques à couche de contenu** : `Intlayer`. Le contenu est déclaré et compilé par composant, si bien que le typage, le tree shaking, les outils d'édition et la traduction par IA proviennent tous des mêmes déclarations.
 
 </Question>
-
 <Question title="Quel poids l'i18n ajoute-t-elle à la taille de mon bundle ?">
 
 Bien moins qu'une configuration basée sur des espaces de noms, car une page ne télécharge jamais un catalogue qu'elle n'affiche pas. Le balisage rendu côté serveur résout son contenu sur le serveur, et le compilateur au moment du build remplace les appels `useIntlayer` par les entrées de dictionnaire exactes qu'un composant utilise, si bien que les clés inutilisées et les langues inutilisées sont éliminées. Les [dictionnaires dynamiques](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/dynamic_dictionaries/index.md) répartissent le reste par locale. Mesuré face aux alternatives habituelles, Intlayer réduit la taille du bundle et des pages jusqu'à 50 %. Voir l'[optimisation du bundle](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/bundle_optimization.md) et le [benchmark](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/benchmark/index.md).
 
 </Question>
-
 <Question title="Puis-je migrer depuis `i18next`, `next-intl` ou `react-i18next` sans réécrire mes composants ?">
 
 Oui, et il existe deux voies. Vous pouvez migrer le contenu progressivement avec le [guide de migration i18next](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/migration_from_i18next_to_intlayer.md) ou le [guide de migration next-intl](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/migration_from_next-intl_to_intlayer.md). Ou vous pouvez conserver entièrement votre API actuelle : les [adaptateurs de compatibilité](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/compat/index.md) exposent exactement la même API que `i18next`, `react-i18next`, `next-intl`, `next-i18next`, `react-intl`, `use-intl`, `vue-i18n` et `Lingui`, mais servie par des dictionnaires Intlayer : seuls les imports changent, pas le code des composants.
 
 </Question>
-
 <Question title="Puis-je conserver mes fichiers de traduction JSON existants ?">
 
 Oui. Le [plugin de synchronisation JSON](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/plugins/sync-json.md) conserve vos fichiers `/messages/{locale}/{namespace}.json` comme source de vérité et génère les dictionnaires Intlayer à partir d'eux, dans les deux sens. Un [plugin de synchronisation PO](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/plugins/sync-po.md) fait de même pour les catalogues gettext, et les [fichiers par locale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/per_locale_file.md) permettent de séparer le contenu par langue au lieu de regrouper les locales dans un seul fichier.
 
 </Question>
-
 <Question title="Dois-je déplacer mon contenu clé par clé ?">
 
 Non. Lancez `npx intlayer extract` et Intlayer lit vos fichiers source, en extrait les chaînes destinées aux utilisateurs et écrit un fichier `.content` à côté de chacun, de sorte que vous relisez un diff plutôt que de copier des chaînes dans un catalogue une par une. Voir la [commande extract](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/cli/extract.md).
@@ -331,7 +318,6 @@ Non. Lancez `npx intlayer extract` et Intlayer lit vos fichiers source, en extra
 Pour un pipeline entièrement automatisé, le [compilateur Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/compiler.md) fait la même chose au moment du build sur du code source JSX, TSX, Vue et Svelte, en générant les dictionnaires à chaque changement, de sorte qu'il n'y a aucune clé à maintenir à la main. Il fonctionne par analyse statique : les chaînes qui n'existent qu'à l'exécution restent hors de portée, et il a besoin de quelques annotations pour distinguer le texte destiné aux utilisateurs de la logique applicative.
 
 </Question>
-
 <Question title="Quels outils d'éditeur et d'agent IA sont disponibles ?">
 
 Cinq éléments, tous optionnels :
@@ -343,43 +329,36 @@ Cinq éléments, tous optionnels :
 - **[Plugin ESLint](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/eslint.md)** : `no-raw-text` signale les chaînes codées en dur, avec d'autres règles pour les clés de dictionnaire statiques et le contenu inutilisé.
 
 </Question>
-
 <Question title="En quoi Intlayer est-il différent de next-intl ?">
 
 `next-intl` est une couche de messages pour Next.js : vous conservez des fichiers de messages JSON par locale et vous les lisez via `useTranslations`. Intlayer est une couche de contenu : les déclarations vivent à côté du composant, sont typées à partir de la déclaration elle-même, et sont compilées par composant, si bien qu'une page ne livre que ce qu'elle affiche. Intlayer couvre aussi ce que `next-intl` vous laisse faire, à savoir la traduction par IA, un éditeur visuel, un CMS et la vérification des traductions manquantes en CI. Si vous voulez conserver l'API de `next-intl`, l'[adaptateur de compatibilité](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/compat/index.md) la sert à partir des dictionnaires Intlayer.
 
 </Question>
-
 <Question title="En quoi Intlayer est-il différent de i18next et react-i18next ?">
 
 `i18next` résout des clés de chaînes contre des espaces de noms à l'exécution, ce qui signifie qu'une clé renommée ou mal orthographiée échoue silencieusement et que chaque espace de noms qu'une page touche est téléchargé en entier. Intlayer résout le contenu au moment du build contre des types générés, si bien qu'une mauvaise clé est une erreur de compilation, et que seules les entrées qu'un composant affiche atteignent le bundle. `i18next` a le plus grand écosystème de plugins et un historique plus long ; Intlayer a le typage, la taille du bundle, et les outils d'édition et d'automatisation. Voir le [guide de migration i18next](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/migration_from_i18next_to_intlayer.md) ou l'[adaptateur de compatibilité](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/compat/index.md).
 
 </Question>
-
 <Question title="Intlayer est-il plus rapide ou plus léger que les alternatives ?">
 
 Sur la taille du bundle et des pages, oui : ne pas charger les catalogues qu'une page n'affiche pas réduit la taille du bundle et des pages jusqu'à 50 % face aux configurations basées sur des espaces de noms. Le [benchmark](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/benchmark/index.md) publie la méthode et les chiffres par framework, dont [Next.js](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/benchmark/nextjs.md), [TanStack Start](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/benchmark/tanstack.md), [Vue](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/benchmark/vue.md) et [Svelte](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/benchmark/svelte.md), afin que vous puissiez les reproduire plutôt que de croire l'affirmation sur parole.
 
 </Question>
-
 <Question title="Vaut-il la peine de migrer une application existante ?">
 
 Cela dépend de ce qui fait mal aujourd'hui. Si votre douleur est la taille du bundle, les traductions manquantes silencieuses, ou des traducteurs qui ne peuvent pas travailler sans un développeur, la migration se rentabilise. Si vos catalogues sont petits et stables, le gain est plus faible. Dans tous les cas, la migration n'a pas à être une réécriture : les [adaptateurs de compatibilité](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/compat/index.md) conservent votre API actuelle, et le [plugin de synchronisation JSON](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/plugins/sync-json.md) conserve vos fichiers JSON existants comme source de vérité pendant que les deux couches coexistent.
 
 </Question>
-
 <Question title="Qu'offre Intlayer que les autres bibliothèques d'i18n n'offrent pas ?">
 
 Du [contenu Markdown](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/dictionary/markdown.md), du [contenu récupéré depuis une source externe](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/dictionary/content_file.md), le chargement de contenu de fichier, des [mises à jour de contenu en direct](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/cli/live.md), un [éditeur visuel](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/intlayer_visual_editor.md), un [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/intlayer_CMS.md), un [compilateur](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/compiler.md) qui extrait le contenu des composants existants, des [variantes de contenu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/dynamic_dictionaries/variants.md) pour les tests A/B, des [analyses](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/analytics.md) sur l'exposition du contenu, un [serveur MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/mcp_server.md), un [LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/lsp.md) et des [compétences d'agent](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/agent_skills.md).
 
 </Question>
-
 <Question title="Puis-je utiliser Intlayer uniquement comme gestionnaire de traductions et conserver ma bibliothèque actuelle ?">
 
 Oui. Intlayer peut générer vos espaces de noms dans le format et à l'emplacement attendus par votre bibliothèque actuelle, par exemple `/messages/{locale}/{namespace}.json`, si bien que vous obtenez la traduction par IA, l'éditeur et les vérifications CI tandis que le code de votre application continue d'utiliser sa bibliothèque d'i18n existante.
 
 </Question>
-
 <Question title="Intlayer est-il gratuit et open source ?">
 
 Oui, sous licence Apache 2.0, usage commercial inclus. Le CMS hébergé est un service payant optionnel qui peut aussi être [auto-hébergé](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/self_hosting.md).