@intlayer/docs 8.2.4 → 8.3.0-canary.1

package/docs/ar/intlayer_with_nextjs_compiler.md

@@ -20,6 +20,9 @@ slugs:
 applicationTemplate: https://github.com/aymericzip/intlayer-next-no-lolale-path-template
 youtubeVideo: https://www.youtube.com/watch?v=e_PPG7PTqGU
 history:
+  - version: 8.2.0
+    date: 2026-03-09
+    changes: Update compiler options, add FilePathPattern support
   - version: 8.1.6
     date: 2026-02-23
     changes: الإصدار الأولي
@@ -128,23 +131,28 @@ const config: IntlayerConfig = {
   },
   compiler: {
     /**
-     * يحدد ما إذا كان يجب تمكين المترجم.
+     * يشير إلى ما إذا كان يجب تمكين المجمّع.
      */
     enabled: true,
 
     /**
      * دليل الإخراج للقواميس المحسنة.
      */
-    outputDir: "compiler",
+    output: ({ locale, key }) => `compiler/${locale}/${key}.json`,
+
+    /**
+     * أدخل المحتوى فقط في الملف الذي تم إنشاؤه، بدون مفتاح.
+     */
+    noMetadata: false,
 
     /**
      * بادئة مفتاح القاموس
      */
-    dictionaryKeyPrefix: "", // إزالة البادئة الأساسية
+    dictionaryKeyPrefix: "", // Remove base prefix
 
     /**
-     * يحدد ما إذا كان يجب حفظ المكونات بعد تحويلها.
-     * بهذه الطريقة، يمكن تشغيل المترجم مرة واحدة فقط لتحويل التطبيق، ثم يمكن إزالته.
+     * يشير إلى ما إذا كان يجب حفظ المكونات بعد تحويلها.
+     * بهذه الطريقة، يمكن تشغيل المجمّع مرة واحدة فقط لتحويل التطبيق، ثم يمكن إزالته.
      */
     saveComponents: false,
   },

package/docs/ar/intlayer_with_tanstack.md

@@ -437,12 +437,33 @@ export const Route = createFileRoute("/{-$locale}/")({
   component: RouteComponent,
   head: ({ params }) => {
     const { locale } = params;
+    const path = "/"; // The path for this route
+
     const metaContent = getIntlayer("app", locale);
 
     return {
+      links: [
+        // Canonical link: Points to the current localized page
+        { rel: "canonical", href: getLocalizedUrl(path, locale) },
+
+        // Hreflang: Tell Google about all localized versions
+        ...localeMap(({ locale: mapLocale }) => ({
+          rel: "alternate",
+          hrefLang: mapLocale,
+          href: getLocalizedUrl(path, mapLocale),
+        })),
+
+        // x-default: For users in unmatched languages
+        // Define the default fallback locale (usually your primary language)
+        {
+          rel: "alternate",
+          hrefLang: "x-default",
+          href: getLocalizedUrl(path, defaultLocale),
+        },
+      ],
       meta: [
         { title: metaContent.title },
-        { content: metaContent.meta.description, name: "description" },
+        { name: "description", content: metaContent.meta.description },
       ],
     };
   },

package/docs/ar/intlayer_with_vite+react_compiler.md

@@ -19,6 +19,9 @@ slugs:
 applicationTemplate: https://github.com/aymericzip/intlayer-vite-react-template
 youtubeVideo: https://www.youtube.com/watch?v=dS9L7uJeak4
 history:
+  - version: 8.2.0
+    date: 2026-03-09
+    changes: Update compiler options, add FilePathPattern support
   - version: 8.1.6
     date: 2026-02-23
     changes: الإصدار الأولي
@@ -125,23 +128,28 @@ const config: IntlayerConfig = {
   },
   compiler: {
     /**
-     * يحدد ما إذا كان يجب تمكين المترجم.
+     * يشير إلى ما إذا كان يجب تمكين المجمّع.
      */
     enabled: true,
 
     /**
      * دليل الإخراج للقواميس المحسنة.
      */
-    outputDir: "compiler",
+    output: ({ locale, key }) => `compiler/${locale}/${key}.json`,
+
+    /**
+     * أدخل المحتوى فقط في الملف الذي تم إنشاؤه، بدون مفتاح.
+     */
+    noMetadata: false,
 
     /**
      * بادئة مفتاح القاموس
      */
-    dictionaryKeyPrefix: "", // إزالة البادئة الأساسية
+    dictionaryKeyPrefix: "", // Remove base prefix
 
     /**
-     * يحدد ما إذا كان يجب حفظ المكونات بعد تحويلها.
-     * بهذه الطريقة، يمكن تشغيل المترجم مرة واحدة فقط لتحويل التطبيق، ثم يمكن إزالته.
+     * يشير إلى ما إذا كان يجب حفظ المكونات بعد تحويلها.
+     * بهذه الطريقة، يمكن تشغيل المجمّع مرة واحدة فقط لتحويل التطبيق، ثم يمكن إزالته.
      */
     saveComponents: false,
   },

package/docs/de/compiler.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-09-09
-updatedAt: 2026-02-25
+updatedAt: 2026-03-10
 title: Intlayer Compiler | Automatisierte Inhaltsextraktion für i18n
 description: Automatisieren Sie Ihren Internationalisierungsprozess mit dem Intlayer Compiler. Extrahieren Sie Inhalte direkt aus Ihren Komponenten für schnellere und effizientere i18n in Vite, Next.js und mehr.
 keywords:
@@ -20,6 +20,9 @@ slugs:
   - doc
   - compiler
 history:
+  - version: 8.2.0
+    date: 2026-03-10
+    changes: Update compiler options, add FilePathPattern support
   - version: 8.1.7
     date: 2026-02-25
     changes: Compiler-Optionen aktualisieren
@@ -157,13 +160,12 @@ import { type IntlayerConfig, Locales } from "intlayer";
 const config: IntlayerConfig = {
   compiler: {
     /**
-     * Gibt an, ob der Compiler aktiviert sein soll.
-     * Auf 'build-only' setzen, um den Compiler während der Entwicklung zu überspringen und die Startzeiten zu beschleunigen.
+     * Stellen Sie build-only ein, um den Compiler während der Entwicklung zu überspringen und die Startzeiten zu beschleunigen.
      */
     enabled: true,
 
     /**
-     * Muster zum Durchlaufen des zu optimierenden Codes.
+     * Pattern to traverse the code to optimize.
      */
     transformPattern: [
       "**/*.{js,ts,mjs,cjs,jsx,tsx,vue,svelte}",
@@ -171,23 +173,28 @@ const config: IntlayerConfig = {
     ],
 
     /**
-     * Muster, das von der Optimierung ausgeschlossen werden soll.
+     * Pattern to exclude from the optimization.
      */
     excludePattern: ["**/node_modules/**"],
 
     /**
      * Ausgabeverzeichnis für die optimierten Wörterbücher.
      */
-    outputDir: "i18n",
+    output: ({ locale, key }) => `compiler/${locale}/${key}.json`,
 
     /**
-     * Wörterbuch-Schlüsselpräfix
+     * Fügen Sie nur den Inhalt in die generierte Datei ein, ohne Schlüssel.
      */
-    dictionaryKeyPrefix: "", // Basis-Präfix entfernen
+    noMetadata: false,
+
+    /**
+     * Wörterbuch-Präfix
+     */
+    dictionaryKeyPrefix: "", // Remove base prefix
 
     /**
      * Gibt an, ob die Komponenten nach der Transformation gespeichert werden sollen.
-     * Auf diese Weise kann der Compiler nur einmal ausgeführt werden, um die App zu transformieren, und kann dann entfernt werden.
+     * Auf diese Weise kann der Compiler nur einmal ausgeführt werden, um die App zu transformieren, und dann entfernt werden.
      */
     saveComponents: false,
   },
@@ -209,3 +216,61 @@ npx intlayer fill         # Fehlende Übersetzungen ausfüllen
 ```
 
 > Weitere Informationen finden Sie in der [CLI-Dokumentation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/cli/ci.md)
+
+### Compiler-Konfigurationsreferenz
+
+Die folgenden Eigenschaften können im Block `compiler` Ihrer Datei `intlayer.config.ts` konfiguriert werden:
+
+- **enabled**:
+  - _Typ_: `boolean | 'build-only'`
+  - _Standard_: `true`
+  - _Beschreibung_: Gibt an, ob der Compiler aktiviert werden soll.
+- **dictionaryKeyPrefix**:
+  - _Typ_: `string`
+  - _Standard_: `'comp-'`
+  - _Beschreibung_: Präfix für die extrahierten Wörterbuchschlüssel.
+- **transformPattern**:
+  - _Typ_: `string | string[]`
+  - _Standard_: `['**/*.{js,ts,mjs,cjs,jsx,tsx,vue,svelte}', '!**/node_modules/**']`
+  - _Beschreibung_: Muster zum Durchlaufen des zu optimierenden Codes.
+- **excludePattern**:
+  - _Typ_: `string | string[]`
+  - _Standard_: `['**/node_modules/**']`
+  - _Beschreibung_: Muster, die von der Optimierung ausgeschlossen werden sollen.
+- **outputDir** (Deprecated):
+  - _Typ_: `string`
+  - _Standard_: `'compiler'`
+  - _Beschreibung_: Das Verzeichnis, in dem die extrahierten Wörterbücher gespeichert werden.
+
+- **output**:
+  - _Typ_: `FilePathPattern`
+  - _Standard_: `({ key }) => 'compiler/${key}.content.json'`
+  - _Beschreibung_: Definiert den Pfad der Ausgabedateien. Ersetzt `outputDir`. Verarbeitet dynamische Variablen wie `{{locale}}`, `{{key}}`, `{{fileName}}`, `{{extension}}`, `{{format}}`, `{{dirPath}}`, `{{componentFileName}}`, `{{componentExtension}}`, `{{componentFormat}}`. Kann als String im Format `'my/{{var}}/path'` oder als Funktion festgelegt werden.
+  - _Hinweis_: `./**/*` Pfade werden relativ zur Komponente aufgelöst. `/**/*` Pfade werden relativ zum Intlayer `baseDir` aufgelöst.
+  - _Beispiel_: `output: ({ locale, key }) => 'compiler/${locale}/${key}.json'`
+
+- **noMetadata**:
+  - _Typ_: `boolean`
+  - _Standard_: `false`
+  - _Beschreibung_: Gibt an, ob die Metadaten in der Datei gespeichert werden sollen. Wenn true, speichert der Compiler nicht die Metadaten der Wörterbücher (Schlüssel, Content-Wrapper).
+  - _Hinweis_: Nützlich bei Verwendung mit dem `loadJSON`-Plugin.
+  - _Beispiel_: Wenn `true`:
+    ```json
+    {
+      "key": "value"
+    }
+    ```
+    Wenn `false`:
+    ```json
+    {
+      "key": "value",
+      "content": {
+        "key": "value"
+      }
+    }
+    ```
+
+- **saveComponents**:
+  - _Typ_: `boolean`
+  - _Standard_: `false`
+  - _Beschreibung_: Gibt an, ob die Komponenten nach der Transformation gespeichert werden sollen.

package/docs/de/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-02-25
+updatedAt: 2026-03-11
 title: Konfiguration
 description: Erfahren Sie, wie Sie Intlayer für Ihre Anwendung konfigurieren. Verstehen Sie die verschiedenen Einstellungen und Optionen, um Intlayer an Ihre Bedürfnisse anzupassen.
 keywords:
@@ -14,18 +14,24 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 8.3.0
+    data: 2026-03-11
+    changes: Verschiebe 'baseDir' von 'content' nach 'system' Konfiguration
+  - version: 8.2.0
+    date: 2026-03-10
+    changes: Compiler-Optionen aktualisieren, Unterstützung für 'output' und 'noMetadata' hinzufügen
   - version: 8.1.7
     date: 2026-02-25
     changes: Compiler-Optionen aktualisieren
   - version: 8.0.6
     date: 2026-02-12
-    changes: Add support for Open Router, Alibaba, Amazon, Google Vertex Bedrock, Fireworks, Groq, Hugging Face, and Together.ai providers
+    changes: Unterstützung für Open Router, Alibaba, Amazon, Google Vertex Bedrock, Fireworks, Groq, Hugging Face und Together.ai Provider hinzufügen
   - version: 8.0.5
     date: 2026-02-06
     changes: Hinzufügen von `dataSerialization` zur KI-Konfiguration
   - version: 8.0.0
     date: 2026-01-22
-    changes: Move `importMode` build configuration to `dictionary` configuration.
+    changes: Build-Konfiguration für importMode in die Wörterbuch-Konfiguration verschoben.
   - version: 8.0.0
     date: 2026-01-18
     changes: Systemkonfiguration von der Inhaltskonfiguration trennen. Interne Pfade zur Eigenschaft `system` verschieben. `codeDir` hinzufügen, um Inhaltsdateien von der Codetransformation zu trennen.
@@ -419,7 +425,7 @@ const config: IntlayerConfig = {
    */
   compiler: {
     /**
-     * Indicates if the compiler should be enabled.
+     * Gibt an, ob der Compiler aktiviert werden soll.
      */
     enabled: true,
 
@@ -437,18 +443,23 @@ const config: IntlayerConfig = {
     excludePattern: ["**/node_modules/**"],
 
     /**
-     * Output directory for the optimized dictionaries.
+     * Ausgabeverzeichnis für die optimierten Wörterbücher.
      */
-    outputDir: "compiler",
+    output: ({ locale, key }) => `compiler/${locale}/${key}.json`,
 
     /**
-     * Dictionary key prefix
+     * Fügen Sie nur den Inhalt in die generierte Datei ein, ohne Schlüssel.
+     */
+    noMetadata: false,
+
+    /**
+     * Wörterbuch-Präfix
      */
     dictionaryKeyPrefix: "", // Remove base prefix
 
     /**
-     * Indicates if the components should be saved after being transformed.
-     * That way, the compiler can be run only once to transform the app, and then it can be removed.
+     * Gibt an, ob die Komponenten nach der Transformation gespeichert werden sollen.
+     * Auf diese Weise kann der Compiler nur einmal ausgeführt werden, um die App zu transformieren, und dann entfernt werden.
      */
     saveComponents: false,
   },
@@ -704,7 +715,7 @@ Einstellungen im Zusammenhang mit der Inhaltsverwaltung innerhalb der Anwendung,
 #### Eigenschaften
 
 - **autoFill**:
-  - _Typ_: `boolean | string | { [key in Locales]?: string }`
+  - _Typ_: `boolean | string | FilePathPattern | { [key in Locales]?: string }`
   - _Standard_: `undefined`
   - _Beschreibung_: Gibt an, wie der Inhalt automatisch mit KI ausgefüllt werden soll. Kann global in der Datei `intlayer.config.ts` deklariert werden.
   - _Beispiel_: true
@@ -727,13 +738,6 @@ Einstellungen im Zusammenhang mit der Inhaltsverwaltung innerhalb der Anwendung,
   - _Beispiel_: `['.data.ts', '.data.js', '.data.json']`
   - _Hinweis_: Die Anpassung der Dateierweiterungen kann helfen, Konflikte zu vermeiden.
 
-- **baseDir**:
-  - _Typ_: `string`
-  - _Standard_: `process.cwd()`
-  - _Beschreibung_: Das Basisverzeichnis für das Projekt.
-  - _Beispiel_: `'/path/to/project'`
-  - _Hinweis_: Dies wird verwendet, um alle Intlayer-bezogenen Verzeichnisse aufzulösen.
-
 - **contentDir**:
   - _Typ_: `string[]`
   - _Standard_: `['.']`
@@ -772,6 +776,13 @@ Einstellungen im Zusammenhang mit internen Pfaden und Ausgabeergebnissen von Int
 
 #### Eigenschaften
 
+- **baseDir**:
+  - _Typ_: `string`
+  - _Standard_: `process.cwd()`
+  - _Beschreibung_: Das Basisverzeichnis für das Projekt.
+  - _Beispiel_: `'/path/to/project'`
+  - _Hinweis_: Dies wird verwendet, um alle Intlayer-bezogenen Verzeichnisse aufzulösen.
+
 - **dictionariesDir**:
   - _Typ_: `string`
   - _Standard_: `'.intlayer/dictionary'`
@@ -962,10 +973,10 @@ Build-Optionen gelten für die Plugins `@intlayer/babel` und `@intlayer/swc`.
   - _Hinweis_: Kann verwendet werden, um die Erstellung von Wörterbüchern zu deaktivieren, z.B. wenn die Ausführung in einer Node.js-Umgebung vermieden werden sollte.
 
 - **checkTypes**:
-  - _Type_: `boolean`
-  - _Default_: `false`
-  - _Description_: Gibt an, ob der Build TypeScript-Typen überprüfen und Fehler protokollieren soll.
-  - _Note_: Dies kann den Build-Vorgang verlangsamen.
+  - _Typ_: `boolean`
+  - _Standard_: `false`
+  - _Beschreibung_: Gibt an, ob der Build TypeScript-Typen überprüfen und Fehler protokollieren soll.
+  - _Hinweis_: Dies kann den Build-Vorgang verlangsamen.
 
 - **optimize**:
   - _Typ_: `boolean`
@@ -978,7 +989,7 @@ Build-Optionen gelten für die Plugins `@intlayer/babel` und `@intlayer/swc`.
   - _Hinweis_: Stellen Sie sicher, dass alle Schlüssel statisch in den `useIntlayer`-Aufrufen deklariert sind, z.B. `useIntlayer('navbar')`.
 
 - **importMode**:
-  - _Note_: **Deprecated**: Use `dictionary.importMode` instead.
+  - _Hinweis_: **Deprecated**: Use `dictionary.importMode` instead.
   - _Typ_: `'static' | 'dynamic' | 'fetch'`
   - _Standard_: `'static'`
   - _Beschreibung_: Steuert, wie Wörterbücher importiert werden.
@@ -1057,3 +1068,31 @@ Einstellungen zur Steuerung des Intlayer-Compilers, der Wörterbücher direkt au
   - _Typ_: `string`
   - _Standard_: `'compiler'`
   - _Beschreibung_: Das Verzeichnis, in dem die extrahierten Wörterbücher gespeichert werden, relativ zum Basispfad Ihres Projekts.
+
+- **output**:
+  - _Typ_: `FilePathPattern`
+  - _Standard_: `({ key }) => 'compiler/${key}.content.json'`
+  - _Beschreibung_: Definiert den Pfad der Ausgabedateien. Ersetzt `outputDir`. Verarbeitet dynamische Variablen wie `{{locale}}`, `{{key}}`, `{{fileName}}`, `{{extension}}`, `{{format}}`, `{{dirPath}}`, `{{componentFileName}}`, `{{componentExtension}}`, `{{componentFormat}}`. Kann als String im Format `'my/{{var}}/path'` oder als Funktion festgelegt werden.
+  - _Hinweis_: `./**/*` Pfade werden relativ zur Komponente aufgelöst. `/**/*` Pfade werden relativ zum Intlayer `baseDir` aufgelöst.
+  - _Beispiel_: `output: ({ locale, key }) => 'compiler/${locale}/${key}.json'`
+
+- **noMetadata**:
+  - _Typ_: `boolean`
+  - _Standard_: `false`
+  - _Beschreibung_: Gibt an, ob die Metadaten in der Datei gespeichert werden sollen. Wenn true, speichert der Compiler nicht die Metadaten der Wörterbücher (Schlüssel, Content-Wrapper).
+  - _Hinweis_: Nützlich bei Verwendung mit dem `loadJSON`-Plugin.
+  - _Beispiel_: Wenn `true`:
+    ```json
+    {
+      "key": "value"
+    }
+    ```
+    Wenn `false`:
+    ```json
+    {
+      "key": "value",
+      "content": {
+        "key": "value"
+      }
+    }
+    ```

package/docs/de/intlayer_with_nextjs_compiler.md

@@ -20,6 +20,9 @@ slugs:
 applicationTemplate: https://github.com/aymericzip/intlayer-next-no-lolale-path-template
 youtubeVideo: https://www.youtube.com/watch?v=e_PPG7PTqGU
 history:
+  - version: 8.2.0
+    date: 2026-03-09
+    changes: Update compiler options, add FilePathPattern support
   - version: 8.1.6
     date: 2026-02-23
     changes: Erstveröffentlichung
@@ -135,16 +138,21 @@ const config: IntlayerConfig = {
     /**
      * Ausgabeverzeichnis für die optimierten Wörterbücher.
      */
-    outputDir: "compiler",
+    output: ({ locale, key }) => `compiler/${locale}/${key}.json`,
 
     /**
-     * Wörterbuch-Schlüsselpräfix
+     * Fügen Sie nur den Inhalt in die generierte Datei ein, ohne Schlüssel.
      */
-    dictionaryKeyPrefix: "", // Basispräfix entfernen
+    noMetadata: false,
+
+    /**
+     * Wörterbuch-Präfix
+     */
+    dictionaryKeyPrefix: "", // Remove base prefix
 
     /**
      * Gibt an, ob die Komponenten nach der Transformation gespeichert werden sollen.
-     * Auf diese Weise kann der Compiler nur einmal ausgeführt werden, um die App zu transformieren, und kann dann entfernt werden.
+     * Auf diese Weise kann der Compiler nur einmal ausgeführt werden, um die App zu transformieren, und dann entfernt werden.
      */
     saveComponents: false,
   },

package/docs/de/intlayer_with_tanstack.md

@@ -437,12 +437,33 @@ export const Route = createFileRoute("/{-$locale}/")({
   component: RouteComponent,
   head: ({ params }) => {
     const { locale } = params;
+    const path = "/"; // The path for this route
+
     const metaContent = getIntlayer("app", locale);
 
     return {
+      links: [
+        // Canonical link: Points to the current localized page
+        { rel: "canonical", href: getLocalizedUrl(path, locale) },
+
+        // Hreflang: Tell Google about all localized versions
+        ...localeMap(({ locale: mapLocale }) => ({
+          rel: "alternate",
+          hrefLang: mapLocale,
+          href: getLocalizedUrl(path, mapLocale),
+        })),
+
+        // x-default: For users in unmatched languages
+        // Define the default fallback locale (usually your primary language)
+        {
+          rel: "alternate",
+          hrefLang: "x-default",
+          href: getLocalizedUrl(path, defaultLocale),
+        },
+      ],
       meta: [
         { title: metaContent.title },
-        { content: metaContent.meta.description, name: "description" },
+        { name: "description", content: metaContent.meta.description },
       ],
     };
   },

package/docs/de/intlayer_with_vite+react_compiler.md

@@ -19,6 +19,9 @@ slugs:
 applicationTemplate: https://github.com/aymericzip/intlayer-vite-react-template
 youtubeVideo: https://www.youtube.com/watch?v=dS9L7uJeak4
 history:
+  - version: 8.2.0
+    date: 2026-03-09
+    changes: Update compiler options, add FilePathPattern support
   - version: 8.1.6
     date: 2026-02-23
     changes: Erstveröffentlichung
@@ -132,16 +135,21 @@ const config: IntlayerConfig = {
     /**
      * Ausgabeverzeichnis für die optimierten Wörterbücher.
      */
-    outputDir: "compiler",
+    output: ({ locale, key }) => `compiler/${locale}/${key}.json`,
 
     /**
-     * Wörterbuch-Schlüsselpräfix
+     * Fügen Sie nur den Inhalt in die generierte Datei ein, ohne Schlüssel.
      */
-    dictionaryKeyPrefix: "", // Basispräfix entfernen
+    noMetadata: false,
+
+    /**
+     * Wörterbuch-Präfix
+     */
+    dictionaryKeyPrefix: "", // Remove base prefix
 
     /**
      * Gibt an, ob die Komponenten nach der Transformation gespeichert werden sollen.
-     * Auf diese Weise kann der Compiler nur einmal ausgeführt werden, um die App zu transformieren, und kann dann entfernt werden.
+     * Auf diese Weise kann der Compiler nur einmal ausgeführt werden, um die App zu transformieren, und dann entfernt werden.
      */
     saveComponents: false,
   },

package/docs/en/compiler.md

@@ -20,6 +20,9 @@ slugs:
   - doc
   - compiler
 history:
+  - version: 8.2.0
+    date: 2026-03-09
+    changes: Update compiler options, add FilePathPattern support
   - version: 8.1.7
     date: 2026-02-25
     changes: Update compiler options
@@ -37,8 +40,11 @@ The **Intlayer Compiler** is a powerful tool designed to automate the process of
 ## Why Use the Intlayer Compiler?
 
 - **Automation**: Eliminates manual copy-pasting of content into dictionaries.
+
 - **Speed**: Optimized content extraction ensuring your build process remains fast.
+
 - **Developer Experience**: Keep content declarations right where they are used, improving maintainability.
+
 - **Live Updates**: Supports Hot Module Replacement (HMR) for instant feedback during development.
 
 See the [Compiler vs. Declarative i18n](https://github.com/aymericzip/intlayer/blob/main/docs/blog/en/compiler_vs_declarative_i18n.md) blog post for a deeper comparison.
@@ -48,6 +54,7 @@ See the [Compiler vs. Declarative i18n](https://github.com/aymericzip/intlayer/b
 While the compiler offers an excellent "just works" experience, it also introduces some trade-offs you should be aware of:
 
 - **Heuristic ambiguity**: The compiler must guess what is user-facing content vs. application logic (e.g., `className="active"`, status codes, product IDs). In complex codebases, this can lead to false positives or missed strings that require manual annotations and exceptions.
+
 - **Static-only extraction**: Compiler-based extraction relies on static analysis. Strings that only exist at runtime (API error codes, CMS fields, etc.) cannot be discovered or translated by the compiler alone, so you still need a complementary runtime i18n strategy.
 
 For a deeper architectural comparison, see the blog post [Compiler vs. Declarative i18n](https://github.com/aymericzip/intlayer/blob/main/docs/blog/en/compiler_vs_declarative_i18n.md).
@@ -92,7 +99,9 @@ See complete tutorial: [Intlayer Compiler with Vite+React](https://github.com/ay
 The Vite plugin automatically detects and handles different file types:
 
 - **React / JSX / TSX**: Handled natively.
+
 - **Vue**: Requires `@intlayer/vue-compiler`.
+
 - **Svelte**: Requires `@intlayer/svelte-compiler`.
 
 Make sure to install the appropriate compiler package for your framework:
@@ -179,7 +188,12 @@ const config: IntlayerConfig = {
     /**
      * Output directory for the optimized dictionaries.
      */
-    outputDir: "i18n",
+    output: ({ locale, key }) => `compiler/${locale}/${key}.json`,
+
+    /**
+     * Inset only content in generated file, without key.
+     */
+    noMetadata: false,
 
     /**
      * Dictionary key prefix
@@ -197,6 +211,70 @@ const config: IntlayerConfig = {
 export default config;
 ```
 
+### Compiler Configuration Reference
+
+The following properties can be configured in the `compiler` block of your `intlayer.config.ts` file:
+
+- **enabled**:
+  - _Type_: `boolean | 'build-only'`
+  - _Default_: `true`
+  - _Description_: Indicates if the compiler should be enabled.
+
+- **dictionaryKeyPrefix**:
+  - _Type_: `string`
+  - _Default_: `'comp-'`
+  - _Description_: Prefix for the extracted dictionary keys.
+
+- **transformPattern**:
+  - _Type_: `string | string[]`
+  - _Default_: `['**/*.{js,ts,mjs,cjs,jsx,tsx,vue,svelte}', '!**/node_modules/**']`
+  - _Description_: Patterns to traverse the code to optimize.
+
+- **excludePattern**:
+  - _Type_: `string | string[]`
+  - _Default_: `['**/node_modules/**']`
+  - _Description_: Patterns to exclude from the optimization.
+
+- **outputDir** (Deprecated):
+  - _Type_: `string`
+  - _Default_: `'compiler'`
+  - _Description_: The directory where the extracted dictionaries will be stored.
+
+- **output**:
+  - _Type_: `FilePathPattern`
+  - _Default_: `({ key }) => 'compiler/${key}.content.json'`
+  - _Description_: Defines the output files path. Replaces `outputDir`. Handles dynamic variables like `{{locale}}`, `{{key}}`, `{{fileName}}`, `{{extension}}`, `{{format}}`, `{{dirPath}}`, `{{componentFileName}}`, `{{componentExtension}}`, `{{componentFormat}}`. Can be set as a string using `'my/{{var}}/path'` format, or as a function.
+  - _Note_: `./**/*` Path are resolved relatively to the component. `/**/*` path are resolved relatively to the Intlayer `baseDir`.
+  - _Note_: If locale is set in the path, it will generate per-locale dictionaries.
+  - _Example_: `output: ({ locale, key }) => 'compiler/${locale}/${key}.json'`
+
+- **noMetadata**:
+  - _Type_: `boolean`
+  - _Default_: `false`
+  - _Description_: Indicates if the metadata should be saved in the file. If true, the compiler will not save the metadata of the dictionaries (key, content wrapper).
+  - _Note_: Useful if used with `loadJSON` plugin.
+  - _Example_:
+    If `true`:
+    ```json
+    {
+      "key": "value"
+    }
+    ```
+    If `false`:
+    ```json
+    {
+      "key": "value",
+      "content": {
+        "key": "value"
+      }
+    }
+    ```
+
+- **saveComponents**:
+  - _Type_: `boolean`
+  - _Default_: `false`
+  - _Description_: Indicates if the components should be saved after being transformed.
+
 ### Fill missing translation
 
 Intlayer provide a CLI tool to help you fill missing translations. You can use the `intlayer` command to test and fill missing translations from your code.