@intlayer/docs 8.12.5-canary.0 → 9.0.0-canary.11

package/docs/fr/compat/polyglot.md

@@ -0,0 +1,45 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migrer de Polyglot.js vers Intlayer"
+description: "Apprenez à migrer de Polyglot.js vers Intlayer en utilisant l'adaptateur de compatibilité."
+keywords:
+  - polyglot
+  - airbnb
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - polyglot
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# Migrer de Polyglot.js vers Intlayer
+
+Si vous utilisez Polyglot.js d'Airbnb, la migration vers Intlayer est extrêmement simple en utilisant la couche de compatibilité.
+
+## Que faire
+
+Exécutez simplement la commande d'initialisation dans votre projet :
+
+```bash
+npx intlayer init
+```
+
+Cela génère `intlayer.config.ts`. Vous pouvez ensuite utiliser l'alias du plugin bundler pour rediriger de manière transparente les importations Polyglot vers `@intlayer/polyglot`.
+
+## Ce qu'il fait sous le capot
+
+La syntaxe de Polyglot.js s'appuie généralement sur `polyglot.t('key', {name})` avec des interpolations `%{name}` et des pluriels `smart_count` séparés par `"singular |||| plural"`.
+
+Sous le capot :
+
+- **Interpolation :** La couche de compatibilité gère les espaces réservés `%{var}` de manière native.
+- **Pluriels :** La chaîne est divisée à `||||` et évaluée par rapport aux `Intl.PluralRules` natifs selon la locale active, en miroir de l'ordre des buckets propre de Polyglot par locale.
+- **Dictionnaires :** Vous évitez d'avoir à fournir d'énormes configurations JSON à `new Polyglot()` – Intlayer gère les dictionnaires dynamiquement et les élague automatiquement.

package/docs/fr/compat/react-i18next.md

@@ -0,0 +1,58 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migrer de react-i18next vers Intlayer"
+description: "Apprenez à migrer votre application React de react-i18next vers Intlayer en utilisant l'adaptateur de compatibilité."
+keywords:
+  - react-i18next
+  - i18next
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - react-i18next
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# Migrer de react-i18next vers Intlayer
+
+Pour un tutoriel complet et détaillé étape par étape, consultez notre [Guide de Migration react-i18next](../migration_from_react-i18next_to_intlayer.md).
+
+L'adaptateur de compatibilité d'Intlayer vous permet de migrer depuis `react-i18next` sans aucune modification de vos importations de code source.
+
+## Ce qu'il faut faire
+
+Pour initialiser le projet, exécutez :
+
+```bash
+npx intlayer init
+```
+
+Lors de l'initialisation, Intlayer installera `@intlayer/react-i18next` et créera `intlayer.config.ts`. Dans votre bundler (comme Vite), appliquez le plugin Intlayer :
+
+```typescript fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import react from "@vitejs/plugin-react";
+import { reactI18nextVitePlugin } from "@intlayer/react-i18next/plugin";
+
+export default defineConfig({
+  plugins: [react(), reactI18nextVitePlugin()],
+});
+```
+
+## Fonctionnement interne
+
+Le `reactI18nextVitePlugin` encapsule le plugin `vite-intlayer` principal et injecte des alias de résolution pour `react-i18next` et `i18next`, les redirigeant vers `@intlayer/react-i18next` et `@intlayer/i18next`.
+
+Fonctionnement interne :
+
+- **`useTranslation` & `withTranslation`:** Réécrit pour utiliser les hooks natifs d'Intlayer, vous donnant l'autocomplétion TypeScript automatique pour vos clés de dictionnaire. Il prend en charge les namespaces de manière transparente (ex. `t('namespace:key')`).
+- **Plurals & Context:** Gère la pluralisation basée sur des suffixes d'i18next (`key_one`, `key_other`) en utilisant `Intl.PluralRules` natif et les suffixes de contexte (`key_male`).
+- **`<Trans>` Component:** Ré-implémenté pour supporter la prop `components`, les formes objet et tableau, et les tags numérotés `<1>...</1>` mappant directement à vos nœuds React.
+- **`i18n` instance:** Résout les clés directement depuis Intlayer sans récupérer de gros fichiers JSON, ce qui réduit considérablement la taille du bundle.

package/docs/fr/compat/react-intl.md

@@ -0,0 +1,55 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migrer de React Intl vers Intlayer"
+description: "Apprenez comment migrer votre application React de react-intl vers Intlayer en utilisant l'adaptateur de compatibilité."
+keywords:
+  - react-intl
+  - formatjs
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - react-intl
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# Migrer de React Intl à Intlayer
+
+Si votre application React utilise `react-intl` (FormatJS), la transition vers Intlayer est très facile. Notre couche de compatibilité gère sans effort ICU MessageFormat et tous les composants `Formatted*` existants.
+
+## À faire
+
+Commencez par exécuter la commande d'initialisation dans votre projet :
+
+```bash
+npx intlayer init
+```
+
+Ensuite, configurez le plugin Intlayer Vite ou Next.js dans votre configuration. Ce plugin injecte des alias au moment de la construction pour rediriger les imports `react-intl` vers `@intlayer/react-intl`.
+
+```typescript fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import react from "@vitejs/plugin-react";
+import reactIntlVitePlugin from "@intlayer/react-intl/plugin";
+
+export default defineConfig({
+  plugins: [react(), reactIntlVitePlugin()],
+});
+```
+
+## Ce qu'il fait sous le capot
+
+Le plugin bundler alias `react-intl` à `@intlayer/react-intl`. Au lieu d'analyser manuellement de grands fichiers JSON et d'envelopper votre app dans un `IntlProvider`, le plugin Intlayer extrait statiquement les clés et utilise les dictionnaires Intlayer au runtime.
+
+Sous le capot :
+
+- **ICU MessageFormat:** Intlayer utilise le resolver `resolveMessage(..., 'icu')` qui supporte complètement les pluralisations ICU, la sélection, le formatage des dates/nombres, et les rich text tags nativement.
+- **Method & JSX callers:** `intl.formatMessage({ id: 'a.b' })` et `<FormattedMessage id="a.b">` sont identifiés par les plugins compilateurs Intlayer (`@intlayer/babel` / `@intlayer/swc`), convertissant les clés en pointillés plats de sorte que le premier segment se résout correctement à la clé du dictionnaire Intlayer.
+- **Formatters:** `<FormattedNumber>`, `<FormattedDate>`, etc., sont relayés aux `core/formatters` natifs en utilisant `Intl`.

package/docs/fr/compat/svelte-i18n.md

@@ -0,0 +1,47 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migrer de Svelte I18n vers Intlayer"
+description: "Apprenez comment migrer votre application Svelte de svelte-i18n vers Intlayer en utilisant l'adaptateur de compatibilité."
+keywords:
+  - svelte-i18n
+  - svelte
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - svelte-i18n
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# Migrer de Svelte I18n à Intlayer
+
+Migrer votre application Svelte de `svelte-i18n` à Intlayer prend juste un moment en utilisant l'adaptateur de compatibilité.
+
+## Ce qu'il faut faire
+
+Exécutez simplement la commande d'initialisation dans votre projet :
+
+```bash
+npx intlayer init
+```
+
+Cela génère `intlayer.config.ts`. Assurez-vous que vos plugins SvelteKit / Vite sont encapsulés avec le plugin alias d'Intlayer pour mapper de manière transparente `svelte-i18n` à `@intlayer/svelte-i18n`.
+
+## Ce qu'il fait sous le capot
+
+Svelte-i18n repose sur des stores largement utilisés (`$_`, `$t`, `$format`, etc.) et ICU MessageFormat.
+
+Sous le capot :
+
+- **Stores :** Intlayer proxifie les stores `svelte-i18n`. `$_` devient un store dérivé de la locale actuelle retournant un résolveur Intlayer.
+- **Keys :** Vos clés plates (par ex. `$_('home.title')`) sont évaluées de sorte que le premier segment de chemin représente le dictionnaire Intlayer.
+- **ICU Syntax :** Entièrement géré par le résolveur ICU partagé (analyse équivalente à `intl-messageformat`).
+- **Formatters :** Les appels `$date`, `$time`, `$number` sont redirigés en toute sécurité vers les formatters core natifs d'Intlayer.
+- **Babel/SWC Analysis :** L'analyseur Intlayer lit les appels aux stores Svelte (`$_`) à l'intérieur de vos fichiers sources `.svelte` avant la compilation pour construire automatiquement les chunks de dictionnaire pertinents.

package/docs/fr/compat/transloco.md

@@ -0,0 +1,45 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migrer de Transloco vers Intlayer"
+description: "Apprenez comment migrer votre application Angular de Transloco vers Intlayer en utilisant l'adaptateur de compatibilité."
+keywords:
+  - transloco
+  - angular
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - transloco
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# Migrer de Transloco vers Intlayer
+
+Si votre application Angular utilise actuellement `@jsverse/transloco`, vous pouvez migrer vers Intlayer en utilisant notre adaptateur de compatibilité. Cette transition vous permet de conserver votre syntaxe de modèle existante tout en utilisant la puissante structure de dictionnaire d'Intlayer.
+
+## À faire
+
+Exécutez simplement la commande d'initialisation dans votre projet :
+
+```bash
+npx intlayer init
+```
+
+Cela générera la configuration `intlayer.config.ts` nécessaire. Vous remplacerez ensuite vos imports Transloco par des modules `@intlayer/transloco` ou utiliserez les alias de build.
+
+## Ce qu'il fait sous le capot
+
+Transloco utilise des scopes et un `TranslocoService` (`translate`, `selectTranslate`), ainsi que des directives structurelles (`*transloco="let t"`) et des pipes (`| transloco`).
+
+Sous le capot :
+
+- **Scopes :** Mappent naturellement aux clés du dictionnaire Intlayer, fournissant une excellente stratégie de pruning pour l'optimisation du bundle.
+- **Service & Directives :** L'adaptateur Angular d'Intlayer remplace de manière transparente les providers, permettant à vos pipes et directives de template existants de résoudre les chaînes de caractères par rapport aux dictionnaires Intlayer.
+- **Build time parsing :** L'analyseur TypeScript reconnaît les appels `instant/get`, et le fallback pruning assure la correction même lorsque l'utilisation du template n'est pas statiquement traçable.

package/docs/fr/compat/vue-i18n.md

@@ -0,0 +1,58 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migrer de Vue I18n vers Intlayer"
+description: "Apprenez comment migrer votre application Vue de vue-i18n vers Intlayer en utilisant l'adaptateur de compatibilité."
+keywords:
+  - vue-i18n
+  - vue
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - vue-i18n
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Initialisation de l'historique"
+author: aymericzip
+---
+
+# Migrer de Vue I18n vers Intlayer
+
+Si votre application Vue utilise actuellement `vue-i18n`, vous pouvez migrer vers Intlayer sans réécrire vos composants ou vos hooks de traduction. Intlayer fournit un adaptateur de compatibilité qui reproduit parfaitement l'API de `vue-i18n` tout en exploitant les puissantes fonctionnalités d'Intlayer sous le capot.
+
+## Que faire
+
+Pour commencer, exécutez simplement la commande d'initialisation dans votre projet :
+
+```bash
+npx intlayer init
+```
+
+Lors de l'initialisation, Intlayer configurera votre fichier de configuration (`intlayer.config.ts`) et préparera votre projet pour la migration. Vous devrez simplement ajouter le plugin Intlayer à votre configuration Vite pour créer automatiquement un alias pour les imports `vue-i18n`.
+
+```typescript fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import vue from "@vitejs/plugin-vue";
+import vueI18nVitePlugin from "@intlayer/vue-i18n/plugin";
+
+export default defineConfig({
+  plugins: [vue(), vueI18nVitePlugin()],
+});
+```
+
+## Ce qu'il fait sous le capot
+
+Le `vueI18nVitePlugin` injecte un alias de module dans votre bundler. Tout import de `vue-i18n` dans votre codebase sera transparemment redirigé vers `@intlayer/vue-i18n`.
+
+**Sous le capot, l'adaptateur gère la syntaxe complexe de `vue-i18n` nativement :**
+
+- **Interpolation & Pluriels :** Résout les interpolations `{name}` et les listes `{0}`. Les pluriels avec pipe (`"car | cars"`) sont convertis en nœuds d'énumération/pluriel Intlayer basés sur la sémantique positionnelle.
+- **Formats :** Les fonctions comme `d()` et `n()` wrappent `Intl` sous le capot, en respectant les `datetimeFormats` et `numberFormats` définis dans vos options.
+- **État Global & Local :** `global.locale` est mappé à un `WritableComputedRef` supporté par le client Intlayer, donc la réactivité se comporte exactement comme prévu (par exemple `locale.value = 'fr'`).
+- **Directives :** La directive `v-t` est enregistrée et fonctionne normalement.
+
+Votre application continue de se renderer exactement comme avant, mais le contenu est alimenté par vos dictionnaires Intlayer, vous donnant la type safety, une meilleure optimisation du bundle, et une intégration CMS transparente.

package/docs/fr/compiler.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-09-09
-updatedAt: 2026-03-12
+updatedAt: 2026-06-23
 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:
@@ -60,6 +60,8 @@ 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.
+
 <Tabs>
  <Tab value='vite'>
 
@@ -79,12 +81,15 @@ Mettez à jour votre `vite.config.ts` pour inclure le plugin `intlayerCompiler`
 
 ```ts fileName="vite.config.ts"
 import { defineConfig } from "vite";
-import { intlayer, intlayerCompiler } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
   plugins: [
-    intlayer(),
-    intlayerCompiler(), // Ajoute le plugin du compilateur
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
   ],
 });
 ```

package/docs/fr/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-05-12
+updatedAt: 2026-06-23
 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,12 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 9.0.0
+    date: 2026-06-24
+    changes: "Add `enableProxy` option to the routing configuration"
+  - version: 8.10.0
+    date: 2026-06-17
+    changes: "Ajout de l'option `format` à la configuration du dictionnaire"
   - version: 8.9.4
     date: 2026-05-12
     changes: "Ajout du support pour le fournisseur LM Studio"
@@ -135,6 +141,7 @@ Intlayer accepte les formats de fichiers de configuration JSON, JS, MJS et TS :
 ````typescript fileName="intlayer.config.ts" codeFormat="typescript"
 import { Locales, type IntlayerConfig } from "intlayer";
 import { nextjsRewrite } from "intlayer/routing";
+import { syncJSON } from "@intlayer/sync-json-plugin";
 import { z } from "zod";
 
 /**
@@ -585,10 +592,38 @@ const config: IntlayerConfig = {
     }),
   },
 
+  /**
+   * Configuration du dictionnaire.
+   */
+  dictionary: {
+    /**
+     * Contrôle la manière dont les dictionnaires sont importés.
+     * - "static": Importé statiquement à la compilation.
+     * - "dynamic": Importé dynamiquement avec Suspense.
+     * - "fetch": Récupéré dynamiquement via l'API de synchronisation en direct.
+     */
+    importMode: "static",
+
+    /**
+     * Le format de message par défaut pour tous les dictionnaires du projet.
+     * - 'intlayer': Format intlayer natif (par défaut).
+     * - 'icu': Format de message ICU.
+     * - 'i18next': Format i18next.
+     * - 'vue-i18n': Format Vue I18n.
+     * - 'po': Format GNU Gettext PO.
+     */
+    format: "icu",
+  },
+
   /**
    * Configuration des plugins.
    */
-  plugins: [],
+  plugins: [
+    syncJSON({
+      format: "icu",
+      source: ({ locale }) => `./messages/${locale}.json`,
+    }),
+  ],
 };
 
 export default config;
@@ -853,24 +888,41 @@ Paramètres relatifs au traitement du contenu dans l'application (noms de réper
 
 ---
 
+### Configuration Système (System Configuration)
+
+Ces paramètres sont destinés aux cas d'utilisation avancés et à la configuration interne d'Intlayer.
+
+| Champ                     | Description                                        | Type     | Par défaut                        | Exemple | Note |
+| ------------------------- | -------------------------------------------------- | -------- | --------------------------------- | ------- | ---- |
+| `dictionariesDir`         | Répertoire des dictionnaires compilés.             | `string` | `'.intlayer/dictionary'`          |         |      |
+| `moduleAugmentationDir`   | Répertoire d'augmentation de modules TypeScript.   | `string` | `'.intlayer/types'`               |         |      |
+| `unmergedDictionariesDir` | Répertoire des dictionnaires non fusionnés.        | `string` | `'.intlayer/unmerged_dictionary'` |         |      |
+| `typesDir`                | Répertoire des types générés.                      | `string` | `'.intlayer/types'`               |         |      |
+| `mainDir`                 | Répertoire du fichier principal d'Intlayer.        | `string` | `'.intlayer/main'`                |         |      |
+| `configDir`               | Répertoire des fichiers de configuration compilés. | `string` | `'.intlayer/config'`              |         |      |
+| `cacheDir`                | Répertoire des fichiers de cache.                  | `string` | `'.intlayer/cache'`               |         |      |
+
+---
+
 ### Configuration du Dictionnaire (Dictionary Configuration)
 
 Paramètres contrôlant les opérations de dictionnaire, y compris le comportement de remplissage automatique et la génération de contenu.
 
-| Champ                       | Description                                                                                                                                                      | Type                                                                                                            | Par défaut  | Exemple                                                                                     | Note                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
-| --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `fill`                      | Contrôle la manière dont les fichiers de sortie de remplissage automatique (traduction par IA) sont générés.                                                     | `boolean` &#124; <br/> `FilePathPattern` &#124; <br/> `Partial<Record<Locale, boolean &#124; FilePathPattern>>` | `true`      | `{ en: '/locales/en/{{key}}.json', fr: ({ key }) => '/locales/fr/${key}.json', es: false }` | • `true`: chemin par défaut (même fichier que la source).<br/>• `false`: désactiver.<br/>• Le modèle string/fonction génère des fichiers par locale.<br/>• Objet par locale : chaque locale correspond à son propre modèle ; `false` ignore cette locale.<br/>• L'inclusion de `{{locale}}` déclenche la génération par locale.<br/>• Le `fill` au niveau du dictionnaire a toujours la priorité sur cette configuration globale.                                                               |
-| `description`               | Aide à comprendre l'objectif du dictionnaire dans l'éditeur et le CMS. Également utilisé comme contexte pour la génération de traductions par IA.                | `string`                                                                                                        | `undefined` | `'User profile section'`                                                                    |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
-| `locale`                    | Transforme le dictionnaire en un format par locale. Chaque champ déclaré devient un nœud de traduction. Si absent, le dictionnaire est traité comme multilingue. | `LocalesValues`                                                                                                 | `undefined` | `'en'`                                                                                      | Utilisez ceci lorsque le dictionnaire est spécifique à une seule locale plutôt que de contenir des traductions pour plusieurs locales.                                                                                                                                                                                                                                                                                                                                                          |
-| `contentAutoTransformation` | Transforme automatiquement les chaînes de contenu en nœuds typés (markdown, HTML ou insertion).                                                                  | `boolean` &#124; <br/> `{ markdown?: boolean; html?: boolean; insertion?: boolean }`                            | `false`     | `true`                                                                                      | • Markdown : `### Title` → `md('### Title')`.<br/>• HTML : `<div>Title</div>` → `html('<div>Title</div>')`.<br/>• Insertion : `Hello {{name}}` → `insert('Hello {{name}}')`.                                                                                                                                                                                                                                                                                                                    |
-| `location`                  | Indique où les fichiers de dictionnaire sont stockés et leur mode de synchronisation avec le CMS.                                                                | `'local'` &#124; <br/> `'remote'` &#124; <br/> `'hybrid'` &#124; <br/> `'plugin'` &#124; <br/> `string`         | `'local'`   | `'hybrid'`                                                                                  | • `'local'` : géré localement uniquement.<br/>• `'remote'` : géré à distance uniquement (CMS).<br/>• `'hybrid'` : géré à la fois localement et à distance.<br/>• `'plugin'` ou chaîne personnalisée : géré par un plugin ou une source personnalisée.                                                                                                                                                                                                                                           |
-| `importMode`                | Contrôle la manière dont les dictionnaires sont importés.                                                                                                        | `'static'` &#124; <br/> `'dynamic'` &#124; <br/> `'fetch'`                                                      | `'static'`  | `'dynamic'`                                                                                 | • `'static'`: importé statiquement (remplace `useIntlayer` par `useDictionary`).<br/>• `'dynamic'`: importé dynamiquement via Suspense (remplace par `useDictionaryDynamic`).<br/>• `'fetch'`: récupéré via l'API live sync ; retombe sur `'dynamic'` en cas d'échec.<br/>• Repose sur les plugins `@intlayer/babel` et `@intlayer/swc`.<br/>• Les clés doivent être déclarées statiquement.<br/>• Ignoré si `optimize` est désactivé.<br/>• N'affecte pas `getIntlayer`, `getDictionary`, etc. |
-| `priority`                  | Priorité du dictionnaire. Les valeurs les plus élevées l'emportent sur les plus basses lors de la résolution des conflits entre dictionnaires.                   | `number`                                                                                                        | `undefined` | `1`                                                                                         |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
-| `live`                      | Déprécié - utilisez plutôt `importMode: 'fetch'`. Indiquait si le contenu du dictionnaire était récupéré dynamiquement via l'API live sync.                      | `boolean`                                                                                                       | `undefined` |                                                                                             | Renommé en `importMode: 'fetch'` dans la v8.0.0.                                                                                                                                                                                                                                                                                                                                                                                                                                                |
-| `schema`                    | Généré automatiquement par Intlayer pour la validation du schéma JSON.                                                                                           | `'https://intlayer.org/schema.json'`                                                                            | auto-généré |                                                                                             | Ne pas modifier manuellement.                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
-| `title`                     | Aide à identifier le dictionnaire dans l'éditeur et le CMS.                                                                                                      | `string`                                                                                                        | `undefined` | `'User Profile'`                                                                            |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
-| `tags`                      | Catégorise les dictionnaires et fournit du contexte ou des instructions pour l'éditeur et l'IA.                                                                  | `string[]`                                                                                                      | `undefined` | `['user', 'profile']`                                                                       |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
-| `version`                   | Version du dictionnaire distant ; aide à suivre la version actuellement utilisée.                                                                                | `string`                                                                                                        | `undefined` | `'1.0.0'`                                                                                   | • Gérable sur le CMS.<br/>• Ne pas modifier localement.                                                                                                                                                                                                                                                                                                                                                                                                                                         |
+| Champ                       | Description                                                                                                                                                      | Type                                                                                                            | Par défaut   | Exemple                                                                                     | Note                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
+| --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | ------------ | ------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `fill`                      | Contrôle la manière dont les fichiers de sortie de remplissage automatique (traduction par IA) sont générés.                                                     | `boolean` &#124; <br/> `FilePathPattern` &#124; <br/> `Partial<Record<Locale, boolean &#124; FilePathPattern>>` | `true`       | `{ en: '/locales/en/{{key}}.json', fr: ({ key }) => '/locales/fr/${key}.json', es: false }` | • `true`: chemin par défaut (même fichier que la source).<br/>• `false`: désactiver.<br/>• Le modèle string/fonction génère des fichiers par locale.<br/>• Objet par locale : chaque locale correspond à son propre modèle ; `false` ignore cette locale.<br/>• L'inclusion de `{{locale}}` déclenche la génération par locale.<br/>• Le `fill` au niveau du dictionnaire a toujours la priorité sur cette configuration globale.                                                               |
+| `description`               | Aide à comprendre l'objectif du dictionnaire dans l'éditeur et le CMS. Également utilisé comme contexte pour la génération de traductions par IA.                | `string`                                                                                                        | `undefined`  | `'User profile section'`                                                                    |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
+| `locale`                    | Transforme le dictionnaire en un format par locale. Chaque champ déclaré devient un nœud de traduction. Si absent, le dictionnaire est traité comme multilingue. | `LocalesValues`                                                                                                 | `undefined`  | `'en'`                                                                                      | Utilisez ceci lorsque le dictionnaire est spécifique à une seule locale plutôt que de contenir des traductions pour plusieurs locales.                                                                                                                                                                                                                                                                                                                                                          |
+| `contentAutoTransformation` | Transforme automatiquement les chaînes de contenu en nœuds typés (markdown, HTML ou insertion).                                                                  | `boolean` &#124; <br/> `{ markdown?: boolean; html?: boolean; insertion?: boolean }`                            | `false`      | `true`                                                                                      | • Markdown : `### Title` → `md('### Title')`.<br/>• HTML : `<div>Title</div>` → `html('<div>Title</div>')`.<br/>• Insertion : `Hello {{name}}` → `insert('Hello {{name}}')`.                                                                                                                                                                                                                                                                                                                    |
+| `location`                  | Indique où les fichiers de dictionnaire sont stockés et leur mode de synchronisation avec le CMS.                                                                | `'local'` &#124; <br/> `'remote'` &#124; <br/> `'hybrid'` &#124; <br/> `'plugin'` &#124; <br/> `string`         | `'local'`    | `'hybrid'`                                                                                  | • `'local'` : géré localement uniquement.<br/>• `'remote'` : géré à distance uniquement (CMS).<br/>• `'hybrid'` : géré à la fois localement et à distance.<br/>• `'plugin'` ou chaîne personnalisée : géré par un plugin ou une source personnalisée.                                                                                                                                                                                                                                           |
+| `importMode`                | Contrôle la manière dont les dictionnaires sont importés.                                                                                                        | `'static'` &#124; <br/> `'dynamic'` &#124; <br/> `'fetch'`                                                      | `'static'`   | `'dynamic'`                                                                                 | • `'static'`: importé statiquement (remplace `useIntlayer` par `useDictionary`).<br/>• `'dynamic'`: importé dynamiquement via Suspense (remplace par `useDictionaryDynamic`).<br/>• `'fetch'`: récupéré via l'API live sync ; retombe sur `'dynamic'` en cas d'échec.<br/>• Repose sur les plugins `@intlayer/babel` et `@intlayer/swc`.<br/>• Les clés doivent être déclarées statiquement.<br/>• Ignoré si `optimize` est désactivé.<br/>• N'affecte pas `getIntlayer`, `getDictionary`, etc. |
+| `format`                    | Le format de message par défaut pour tous les dictionnaires du projet.                                                                                           | `'intlayer'` &#124; <br/> `'icu'` &#124; <br/> `'i18next'` &#124; <br/> `'vue-i18n'` &#124; <br/> `'po'`        | `'intlayer'` | `'icu'`                                                                                     | • `'intlayer'`: Format intlayer natif.<br/>• `'icu'`: Format de message ICU.<br/>• `'i18next'`: Format i18next.<br/>• `'vue-i18n'`: Format Vue I18n.<br/>• `'po'`: Format GNU Gettext PO.                                                                                                                                                                                                                                                                                                       |
+| `priority`                  | Priorité du dictionnaire. Les valeurs les plus élevées l'emportent sur les plus basses lors de la résolution des conflits entre dictionnaires.                   | `number`                                                                                                        | `undefined`  | `1`                                                                                         |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
+| `live`                      | Déprécié - utilisez plutôt `importMode: 'fetch'`. Indiquait si le contenu du dictionnaire était récupéré dynamiquement via l'API live sync.                      | `boolean`                                                                                                       | `undefined`  |                                                                                             | Renommé en `importMode: 'fetch'` dans la v8.0.0.                                                                                                                                                                                                                                                                                                                                                                                                                                                |
+| `schema`                    | Généré automatiquement par Intlayer pour la validation du schéma JSON.                                                                                           | `'https://intlayer.org/schema.json'`                                                                            | auto-généré  |                                                                                             | Ne pas modifier manuellement.                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
+| `title`                     | Aide à identifier le dictionnaire dans l'éditeur et le CMS.                                                                                                      | `string`                                                                                                        | `undefined`  | `'User Profile'`                                                                            |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
+| `tags`                      | Catégorise les dictionnaires et fournit du contexte ou des instructions pour l'éditeur et l'IA.                                                                  | `string[]`                                                                                                      | `undefined`  | `['user', 'profile']`                                                                       |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
+| `version`                   | Version du dictionnaire distant ; aide à suivre la version actuellement utilisée.                                                                                | `string`                                                                                                        | `undefined`  | `'1.0.0'`                                                                                   | • Gérable sur le CMS.<br/>• Ne pas modifier localement.                                                                                                                                                                                                                                                                                                                                                                                                                                         |
 
 **Exemple de `fill`** :
 
@@ -960,22 +1012,6 @@ Les options de build s'appliquent aux plugins `@intlayer/babel` et `@intlayer/sw
 
 ---
 
-### Configuration Système (System Configuration)
-
-Ces paramètres sont destinés aux cas d'utilisation avancés et à la configuration interne d'Intlayer.
-
-| Champ                     | Description                                        | Type     | Par défaut                        | Exemple | Note |
-| ------------------------- | -------------------------------------------------- | -------- | --------------------------------- | ------- | ---- |
-| `dictionariesDir`         | Répertoire des dictionnaires compilés.             | `string` | `'.intlayer/dictionary'`          |         |      |
-| `moduleAugmentationDir`   | Répertoire d'augmentation de modules TypeScript.   | `string` | `'.intlayer/types'`               |         |      |
-| `unmergedDictionariesDir` | Répertoire des dictionnaires non fusionnés.        | `string` | `'.intlayer/unmerged_dictionary'` |         |      |
-| `typesDir`                | Répertoire des types générés.                      | `string` | `'.intlayer/types'`               |         |      |
-| `mainDir`                 | Répertoire du fichier principal d'Intlayer.        | `string` | `'.intlayer/main'`                |         |      |
-| `configDir`               | Répertoire des fichiers de configuration compilés. | `string` | `'.intlayer/config'`              |         |      |
-| `cacheDir`                | Répertoire des fichiers de cache.                  | `string` | `'.intlayer/cache'`               |         |      |
-
----
-
 ### Configuration du Compilateur
 
 Paramètres qui contrôlent le compilateur Intlayer, qui extrait les dictionnaires directement de vos composants.

package/docs/fr/custom_domains.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-04-02
-updatedAt: 2026-04-02
+updatedAt: 2026-06-23
 title: Domaines personnalisés
 description: Apprenez à configurer le routage par domaine dans Intlayer pour servir différentes locales à partir de noms d'hôte dédiés.
 keywords:
@@ -172,10 +172,16 @@ Le plugin Vite `intlayerProxy` applique la même logique pendant le développeme
 
 ```typescript fileName="vite.config.ts"
 import { defineConfig } from "vite";
-import { intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
-  plugins: [intlayerProxy()],
+  plugins: [
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
+  ],
 });
 ```
 

package/docs/fr/custom_url_rewrites.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-01-26
+updatedAt: 2026-06-23
 title: Réécritures d'URL personnalisées
 description: Découvrez comment configurer et utiliser des réécritures d'URL personnalisées dans Intlayer pour définir des chemins spécifiques à une locale.
 keywords:
@@ -228,19 +228,19 @@ Intlayer fournit des formatters pour tous les frameworks populaires :
 - `reactRouterRewrite`: Pour React Router. Prend en charge `:slug` et `*` (0+).
 - `vueRouterRewrite`: Pour Vue Router 4. Prend en charge `:slug`, `:slug?` (0-1), `:slug*` (0+), et `:slug+` (1+).
 - `solidRouterRewrite`: Pour Solid Router. Prend en charge `:slug` et `*slug` (0+).
-  /// `tanstackRouterRewrite` : Pour TanStack Router. Prend en charge `$slug` et `*` (0+).
-  /// `nuxtRewrite` : Pour Nuxt 3. Prend en charge `[slug]` et `[...slug]` (0+).
-  /// `viteRewrite` : Formateur générique pour tout projet basé sur Vite. Normalise la syntaxe pour le proxy Vite.
-  ///
-  /// ### Modèles avancés
-  ///
-  /// Intlayer normalise en interne ces modèles vers une syntaxe unifiée, permettant des correspondances et une génération de chemins sophistiquées :
-  ///
-  /// - **Segments optionnels** : `[[optional]]` (SvelteKit) ou `:slug?` (Vue/React) sont pris en charge.
-  /// - **Catch-all (zéro ou plusieurs)** : `[[...slug]]` (Next.js), `[...path]` (SvelteKit/Nuxt), ou `*` (React/TanStack) permettent de matcher plusieurs segments.
-  /// - **Catch-all obligatoire (un ou plusieurs)** : `[...slug]` (Next.js) ou `:slug+` (Vue) garantissent qu'au moins un segment est présent.
-  ///
-  /// ## Correction d'URL côté client : `useRewriteURL`
+- `tanstackRouterRewrite` : Pour TanStack Router. Prend en charge `$slug` et `*` (0+).
+- `nuxtRewrite` : Pour Nuxt 3. Prend en charge `[slug]` et `[...slug]` (0+).
+- `viteRewrite` : Formateur générique pour tout projet basé sur Vite. Normalise la syntaxe pour le proxy Vite.
+
+### Modèles avancés
+
+Intlayer normalise en interne ces modèles vers une syntaxe unifiée, permettant des correspondances et une génération de chemins sophistiquées :
+
+- **Segments optionnels** : `[[optional]]` (SvelteKit) ou `:slug?` (Vue/React) sont pris en charge.
+- **Catch-all (zéro ou plusieurs)** : `[[...slug]]` (Next.js), `[...path]` (SvelteKit/Nuxt), ou `*` (React/TanStack) permettent de matcher plusieurs segments.
+- **Catch-all obligatoire (un ou plusieurs)** : `[...slug]` (Next.js) ou `:slug+` (Vue) garantissent qu'au moins un segment est présent.
+
+## Correction d'URL côté client : `useRewriteURL`
 
 Pour faire en sorte que la barre d'adresse du navigateur reflète toujours l'URL localisée "propre", Intlayer fournit le hook `useRewriteURL`. Ce hook met à jour silencieusement l'URL en utilisant `window.history.replaceState` lorsqu'un utilisateur arrive sur un chemin canonique.
 
@@ -342,10 +342,16 @@ Pour SolidJS, Vue et Svelte, le plugin Vite `intlayerProxy` gère les réécritu
 
 ```typescript fileName="vite.config.ts"
 import { defineConfig } from "vite";
-import { intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
-  plugins: [intlayerProxy()],
+  plugins: [
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
+  ],
 });
 ```