@intlayer/docs 8.2.4 → 8.3.0-canary.0

package/docs/fr/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-02-25
+updatedAt: 2026-03-10
 title: Configuration
 description: Apprenez à configurer Intlayer pour votre application. Comprenez les différents paramètres et options disponibles pour personnaliser Intlayer selon vos besoins.
 keywords:
@@ -14,6 +14,9 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 8.2.0
+    date: 2026-03-10
+    changes: Update compiler options, add FilePathPattern support
   - version: 8.1.7
     date: 2026-02-25
     changes: Mise à jour des options du compilateur
@@ -422,12 +425,12 @@ const config: IntlayerConfig = {
    */
   compiler: {
     /**
-     * Indicates if the compiler should be enabled.
+     * Réglez sur 'build-only' pour ignorer le compilateur pendant le développement et accélérer les temps de démarrage.
      */
     enabled: true,
 
     /**
-     * Pattern to traverse the code to optimize.
+     * Modèle pour parcourir le code à optimiser.
      */
     transformPattern: [
       "**/*.{js,ts,mjs,cjs,jsx,tsx,vue,svelte}",
@@ -435,23 +438,28 @@ const config: IntlayerConfig = {
     ],
 
     /**
-     * Pattern to exclude from the optimization.
+     * Modèle à exclure de l'optimisation.
      */
     excludePattern: ["**/node_modules/**"],
 
     /**
-     * Output directory for the optimized dictionaries.
+     * Répertoire de sortie pour les dictionnaires optimisés.
      */
-    outputDir: "compiler",
+    output: ({ locale, key }) => `compiler/${locale}/${key}.json`,
 
     /**
-     * Dictionary key prefix
+     * Insérer uniquement le contenu dans le fichier généré, sans clé.
      */
-    dictionaryKeyPrefix: "", // Remove base prefix
+    noMetadata: false,
 
     /**
-     * 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.
+     * Préfixe de clé de dictionnaire
+     */
+    dictionaryKeyPrefix: "", // Supprimer le préfixe de base
+
+    /**
+     * Indique si les composants doivent être sauvegardés après avoir été transformés.
+     * De cette façon, le compilateur peut être exécuté une seule fois pour transformer l'application, puis il peut être supprimé.
      */
     saveComponents: false,
   },
@@ -707,7 +715,7 @@ Paramètres liés à la gestion du contenu au sein de l'application, incluant le
 #### Propriétés
 
 - **autoFill** :
-  - _Type_ : `boolean | string | { [key in Locales]?: string }`
+  - _Type_ : `boolean | string | FilePathPattern | { [key in Locales]?: string }`
   - _Défaut_ : `undefined`
   - _Description_ : Indique comment le contenu doit être automatiquement rempli à l'aide de l'IA. Peut être déclaré globalement dans le fichier `intlayer.config.ts`.
   - _Exemple_ : true
@@ -837,9 +845,9 @@ Pour plus d'informations sur les fichiers de déclaration de contenu et la faço
 - **importMode**:
   - _Note_: **Deprecated**: Use `dictionary.importMode` instead.
   - _Type_: `'static' | 'dynamic' | 'fetch'`
-  - _Default_: `'static'`
+  - _Par défaut_: `'static'`
   - _Description_: Controls how dictionaries are imported.
-  - _Example_: `'dynamic'`
+  - _Exemple_: `'dynamic'`
 - **priority**
 - **live**
 - **schema**
@@ -1061,7 +1069,35 @@ Paramètres qui contrôlent le compilateur Intlayer, qui extrait les dictionnair
   - _Description_ : Modèles qui définissent quels fichiers doivent être exclus lors de l'optimisation.
   - _Exemple_ : `['**/node_modules/**', '!**/node_modules/react/**']`
 
-- **outputDir** :
+- **outputDir** (Deprecated) :
   - _Type_ : `string`
   - _Par défaut_ : `'compiler'`
   - _Description_ : Le répertoire où les dictionnaires extraits seront stockés, relatif au chemin de base de votre projet.
+
+- **output**:
+  - _Type_: `FilePathPattern`
+  - _Par défaut_: `({ key }) => 'compiler/${key}.content.json'`
+  - _Description_: Définit le chemin des fichiers de sortie. Remplace `outputDir`. Gère les variables dynamiques telles que `{{locale}}`, `{{key}}`, `{{fileName}}`, `{{extension}}`, `{{format}}`, `{{dirPath}}`, `{{componentFileName}}`, `{{componentExtension}}`, `{{componentFormat}}`. Peut être configuré sous forme de chaîne à l'aide du format `'my/{{var}}/path'` ou sous forme de fonction.
+  - _Note_: `./**/*` Les chemins sont résolus par rapport au composant. `/**/*` les chemins sont résolus par rapport au `baseDir` d'Intlayer.
+  - _Exemple_: `output: ({ locale, key }) => 'compiler/${locale}/${key}.json'`
+
+- **noMetadata**:
+  - _Type_: `boolean`
+  - _Par défaut_: `false`
+  - _Description_: Indique si les métadonnées doivent être enregistrées dans le fichier. Si vrai, le compilateur n'enregistrera pas les métadonnées des dictionnaires (clé, enveloppe de contenu).
+  - _Note_: Utile si utilisé avec le plugin `loadJSON`.
+  - _Exemple_: Si `true` :
+    ```json
+    {
+      "key": "value"
+    }
+    ```
+    Si `false` :
+    ```json
+    {
+      "key": "value",
+      "content": {
+        "key": "value"
+      }
+    }
+    ```

package/docs/fr/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: Première version
@@ -135,7 +138,12 @@ const config: IntlayerConfig = {
     /**
      * Répertoire de sortie pour les dictionnaires optimisés.
      */
-    outputDir: "compiler",
+    output: ({ locale, key }) => `compiler/${locale}/${key}.json`,
+
+    /**
+     * Insérer uniquement le contenu dans le fichier généré, sans clé.
+     */
+    noMetadata: false,
 
     /**
      * Préfixe de clé de dictionnaire

package/docs/fr/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: Sortie initiale
@@ -132,7 +135,12 @@ const config: IntlayerConfig = {
     /**
      * Répertoire de sortie pour les dictionnaires optimisés.
      */
-    outputDir: "compiler",
+    output: ({ locale, key }) => `compiler/${locale}/${key}.json`,
+
+    /**
+     * Insérer uniquement le contenu dans le fichier généré, sans clé.
+     */
+    noMetadata: false,
 
     /**
      * Préfixe de clé de dictionnaire

package/docs/hi/compiler.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-09-09
-updatedAt: 2026-02-25
+updatedAt: 2026-03-10
 title: Intlayer Compiler | i18n के लिए स्वचालित सामग्री निष्कर्षण
 description: Intlayer Compiler के साथ अपने अंतरराष्ट्रीयकरण प्रक्रिया को स्वचालित करें। Vite, Next.js, और अन्य में तेज़, अधिक कुशल i18n के लिए सीधे अपने कंपोनेंट्स से सामग्री निकालें।
 keywords:
@@ -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: कंपाइलर विकल्पों को अपडेट करें
@@ -157,13 +160,12 @@ import { type IntlayerConfig, Locales } from "intlayer";
 const config: IntlayerConfig = {
   compiler: {
     /**
-     * इंगित करता है कि क्या कंपाइलर सक्षम होना चाहिए।
-     * विकास के दौरान कंपाइलर को छोड़ने और स्टार्टअप समय को तेज़ करने के लिए 'build-only' पर सेट करें।
+     * विकास के दौरान कंपाइलर को छोड़ने और स्टार्टअप समय को तेज करने के लिए 'build-only' पर सेट करें।
      */
     enabled: true,
 
     /**
-     * अनुकूलित करने के लिए कोड को पार करने का पैटर्न।
+     * Pattern to traverse the code to optimize.
      */
     transformPattern: [
       "**/*.{js,ts,mjs,cjs,jsx,tsx,vue,svelte}",
@@ -171,23 +173,28 @@ const config: IntlayerConfig = {
     ],
 
     /**
-     * अनुकूलन से बाहर करने का पैटर्न।
+     * Pattern to exclude from the optimization.
      */
     excludePattern: ["**/node_modules/**"],
 
     /**
      * अनुकूलित शब्दकोशों के लिए आउटपुट निर्देशिका।
      */
-    outputDir: "i18n",
+    output: ({ key }) => `compiler/${key}.content.json`,
+
+    /**
+     * उत्पन्न फ़ाइल में केवल सामग्री डालें, बिना कुंजी के।
+     */
+    noMetadata: false,
 
     /**
      * शब्दकोश कुंजी उपसर्ग
      */
-    dictionaryKeyPrefix: "", // बेस उपसर्ग हटाएँ
+    dictionaryKeyPrefix: "", // Remove base prefix
 
     /**
-     * इंगित करता है कि क्या कंपोनेंट्स को रूपांतरित होने के बाद सहेजा जाना चाहिए।
-     * इस तरह, कंपाइलर को ऐप को रूपांतरित करने के लिए केवल एक बार चलाया जा सकता है, और फिर इसे हटाया जा सकता है।
+     * इंगित करता है कि क्या घटकों को रूपांतरित होने के बाद सहेजा जाना चाहिए।
+     * इस तरह, कंपाइलer को ऐप को रूपांतरित करने के लिए केवल एक बार चलाया जा सकता है, और फिर इसे हटाया जा सकता है।
      */
     saveComponents: false,
   },
@@ -209,3 +216,61 @@ npx intlayer fill         # लापता अनुवाद भरें
 ```
 
 > अधिक विवरण के लिए, [CLI दस्तावेज़](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/cli/ci.md) देखें।
+
+### कंपाइलर कॉन्फ़िगरेशन संदर्भ
+
+निम्नलिखित गुणों को आपकी `intlayer.config.ts` फ़ाइल के `compiler` ब्लॉक में कॉन्फ़िगर किया जा सकता है:
+
+- **enabled**:
+  - _प्रकार_: `boolean | 'build-only'`
+  - _डिफ़ॉल्ट_: `true`
+  - _विवरण_: इंगित करता है कि क्या कंपाइलर सक्षम होना चाहिए।
+- **dictionaryKeyPrefix**:
+  - _प्रकार_: `string`
+  - _डिफ़ॉल्ट_: `'comp-'`
+  - _विवरण_: निकाली गई शब्दकोश कुंजियों के लिए उपसर्ग।
+- **transformPattern**:
+  - _प्रकार_: `string | string[]`
+  - _डिफ़ॉल्ट_: `['**/*.{js,ts,mjs,cjs,jsx,tsx,vue,svelte}', '!**/node_modules/**']`
+  - _विवरण_: ऑप्टिमाइज़ करने के लिए कोड को पार करने के पैटर्न।
+- **excludePattern**:
+  - _प्रकार_: `string | string[]`
+  - _डिफ़ॉल्ट_: `['**/node_modules/**']`
+  - _विवरण_: ऑप्टिमाइज़ेशन से बाहर रखने के पैटर्न।
+- **outputDir** (Deprecated):
+  - _प्रकार_: `string`
+  - _डिफ़ॉल्ट_: `'compiler'`
+  - _विवरण_: वह निर्देशिका जहाँ निकाली गई शब्दकोश सामग्री संग्रहीत की जाएगी।
+
+- **output**:
+  - _प्रकार_: `FilePathPattern`
+  - _डिफ़ॉल्ट_: `({ key }) => 'compiler/${key}.content.json'`
+  - _विवरण_: आउटपुट फ़ाइल पथ को परिभाषित करता है। `outputDir` को प्रतिस्थापित करता है। `{{locale}}`, `{{key}}`, `{{fileName}}`, `{{extension}}`, `{{format}}`, `{{dirPath}}`, `{{componentFileName}}`, `{{componentExtension}}`, और `{{componentFormat}}` जैसे गतिशील चरों को संभालता है। इसे `'my/{{var}}/path'` प्रारूप का उपयोग करके एक स्ट्रिंग के रूप में, या एक फ़ंक्शन के रूप में सेट किया जा सकता है।
+  - _नोट_: `./**/*` पथ घटक के सापेक्ष हल किए जाते हैं। `/**/*` पथ Intlayer `baseDir` के सापेक्ष हल किए जाते हैं।
+  - _उदाहरण_: `output: ({ locale, key }) => 'compiler/${locale}/${key}.json'`
+
+- **noMetadata**:
+  - _प्रकार_: `boolean`
+  - _डिफ़ॉल्ट_: `false`
+  - _विवरण_: इंगित करता है कि फ़ाइल में मेटाडेटा सहेजा जाना चाहिए या नहीं। यदि सही है, तो कंपाइलर शब्दकोशों (कुंजी, सामग्री रैपर) के मेटाडेटा को नहीं बचाएगा।
+  - _नोट_: `loadJSON` प्लगइन के साथ उपयोग किए जाने पर उपयोगी।
+  - _उदाहरण_: यदि `सही` है:
+    ```json
+    {
+      "key": "value"
+    }
+    ```
+    यदि `गलत` है:
+    ```json
+    {
+      "key": "value",
+      "content": {
+        "key": "value"
+      }
+    }
+    ```
+
+- **saveComponents**:
+  - _प्रकार_: `boolean`
+  - _डिफ़ॉल्ट_: `false`
+  - _विवरण_: इंगित करता है कि क्या घटकों को रूपांतरित होने के बाद सहेजा जाना चाहिए।

package/docs/hi/configuration.md

@@ -14,6 +14,9 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 8.2.0
+    date: 2026-03-09
+    changes: Update compiler options, add 'output' and 'noMetadata' support
   - version: 8.1.7
     date: 2026-02-25
     changes: कंपाइलर विकल्पों को अपडेट करें
@@ -419,7 +422,7 @@ const config: IntlayerConfig = {
    */
   compiler: {
     /**
-     * Indicates if the compiler should be enabled.
+     * इंगित करता है कि क्या कंपाइलर सक्षम होना चाहिए।
      */
     enabled: true,
 
@@ -437,18 +440,23 @@ const config: IntlayerConfig = {
     excludePattern: ["**/node_modules/**"],
 
     /**
-     * Output directory for the optimized dictionaries.
+     * अनुकूलित शब्दकोशों के लिए आउटपुट निर्देशिका।
      */
-    outputDir: "compiler",
+    output: ({ key }) => `compiler/${key}.content.json`,
 
     /**
-     * Dictionary key prefix
+     * उत्पन्न फ़ाइल में केवल सामग्री डालें, बिना कुंजी के।
+     */
+    noMetadata: false,
+
+    /**
+     * शब्दकोश कुंजी उपसर्ग
      */
     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.
+     * इंगित करता है कि क्या घटकों को रूपांतरित होने के बाद सहेजा जाना चाहिए।
+     * इस तरह, कंपाइलer को ऐप को रूपांतरित करने के लिए केवल एक बार चलाया जा सकता है, और फिर इसे हटाया जा सकता है।
      */
     saveComponents: false,
   },
@@ -704,7 +712,7 @@ export default config;
 #### गुण
 
 - **autoFill**:
-  - _प्रकार_: `boolean | string | { [key in Locales]?: string }`
+  - _प्रकार_: `boolean | string | FilePathPattern | { [key in Locales]?: string }`
   - _डिफ़ॉल्ट_: `undefined`
   - _विवरण_: यह संकेत करता है कि सामग्री को AI का उपयोग करके स्वचालित रूप से कैसे भरा जाना चाहिए। इसे वैश्विक रूप से `intlayer.config.ts` फ़ाइल में घोषित किया जा सकता है।
   - _उदाहरण_: true
@@ -847,7 +855,7 @@ export default config;
   - _डिफ़ॉल्ट_: `'[intlayer] '`
   - _विवरण_: लॉगर का उपसर्ग।
   - _उदाहरण_: `'[my custom prefix] '`
-  - _Note_: लॉगर का उपसर्ग।
+  - _नोट_: लॉगर का उपसर्ग।
 
 ### एआई कॉन्फ़िगरेशन
 
@@ -950,10 +958,10 @@ Intlayer बेहतर लचीलापन और विकल्प के
   - _नोट_: शब्दकोश बिल्ड को अक्षम करने के लिए उपयोग किया जा सकता है, उदाहरण के लिए जब Node.js वातावरण में निष्पादन से बचना चाहिए।
 
 - **checkTypes**:
-  - _Type_: `boolean`
-  - _Default_: `false`
-  - _Description_: इंगित करता है कि क्या बिल्ड को TypeScript प्रकारों की जांच करनी चाहिए और त्रुटियों को लॉग करना चाहिए।
-  - _Note_: यह बिल्ड को धीमा कर सकता है।
+  - _प्रकार_: `boolean`
+  - _डिफ़ॉल्ट_: `false`
+  - _विवरण_: इंगित करता है कि क्या बिल्ड को TypeScript प्रकारों की जांच करनी चाहिए और त्रुटियों को लॉग करना चाहिए।
+  - _नोट_: यह बिल्ड को धीमा कर सकता है।
 
 - **optimize**:
   - _प्रकार_: `boolean`
@@ -966,7 +974,7 @@ Intlayer बेहतर लचीलापन और विकल्प के
   - _नोट_: सुनिश्चित करें कि सभी कुंजियाँ `useIntlayer` कॉल्स में स्थैतिक रूप से घोषित हों। उदाहरण के लिए `useIntlayer('navbar')`।
 
 - **importMode**:
-  - _Note_: **Deprecated**: Use `dictionary.importMode` instead.
+  - _नोट_: **Deprecated**: Use `dictionary.importMode` instead.
   - _प्रकार_: `'static' | 'dynamic' | 'fetch'`
   - _डिफ़ॉल्ट_: `'static'`
   - _विवरण_: नियंत्रित करता है कि शब्दकोश कैसे आयात किए जाते हैं।
@@ -1045,3 +1053,31 @@ Intlayer बेहतर लचीलापन और विकल्प के
   - _प्रकार_: `string`
   - _डिफ़ॉल्ट_: `'compiler'`
   - _विवरण_: वह निर्देशिका जहाँ निकाले गए शब्दकोश संग्रहीत किए जाएंगे, आपके प्रोजेक्ट बेस पाथ के सापेक्ष।
+
+- **output**:
+  - _प्रकार_: `FilePathPattern`
+  - _डिफ़ॉल्ट_: `({ key }) => 'compiler/${key}.content.json'`
+  - _विवरण_: आउटपुट फ़ाइल पथ को परिभाषित करता है। `outputDir` को प्रतिस्थापित करता है। `{{locale}}`, `{{key}}`, `{{fileName}}`, `{{extension}}`, `{{format}}`, `{{dirPath}}`, `{{componentFileName}}`, `{{componentExtension}}`, और `{{componentFormat}}` जैसे गतिशील चरों को संभालता है। इसे `'my/{{var}}/path'` प्रारूप का उपयोग करके एक स्ट्रिंग के रूप में, या एक फ़ंक्शन के रूप में सेट किया जा सकता है।
+  - _नोट_: `./**/*` पथ घटक के सापेक्ष हल किए जाते हैं। `/**/*` पथ Intlayer `baseDir` के सापेक्ष हल किए जाते हैं।
+  - _उदाहरण_: `output: ({ locale, key }) => 'compiler/${locale}/${key}.json'`
+
+- **noMetadata**:
+  - _प्रकार_: `boolean`
+  - _डिफ़ॉल्ट_: `false`
+  - _विवरण_: इंगित करता है कि फ़ाइल में मेटाडेटा सहेजा जाना चाहिए या नहीं। यदि सही है, तो कंपाइलर शब्दकोशों (कुंजी, सामग्री रैपर) के मेटाडेटा को नहीं बचाएगा।
+  - _नोट_: `loadJSON` प्लगइन के साथ उपयोग किए जाने पर उपयोगी।
+  - _उदाहरण_: यदि `सही` है:
+    ```json
+    {
+      "key": "value"
+    }
+    ```
+    यदि `गलत` है:
+    ```json
+    {
+      "key": "value",
+      "content": {
+        "key": "value"
+      }
+    }
+    ```

package/docs/hi/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`,
 
     /**
-     * डिक्शनरी कुंजी उपसर्ग (प्रीफ़िक्स)
+     * उत्पन्न फ़ाइल में केवल सामग्री डालें, बिना कुंजी के।
      */
-    dictionaryKeyPrefix: "", // बेस प्रीफ़िक्स हटाएँ
+    noMetadata: false,
 
     /**
-     * इंगित करता है कि क्या ट्रांसफ़ॉर्म होने के बाद कंपोनेंट्स को सहेजा जाना चाहिए।
-     * इस तरह, ऐप को ट्रांसफ़ॉर्म करने के लिए कंपाइलर को केवल एक बार चलाया जा सकता है, और फिर इसे हटाया जा सकता है।
+     * शब्दकोश कुंजी उपसर्ग
+     */
+    dictionaryKeyPrefix: "", // Remove base prefix
+
+    /**
+     * इंगित करता है कि क्या घटकों को रूपांतरित होने के बाद सहेजा जाना चाहिए।
+     * इस तरह, कंपाइलer को ऐप को रूपांतरित करने के लिए केवल एक बार चलाया जा सकता है, और फिर इसे हटाया जा सकता है।
      */
     saveComponents: false,
   },

package/docs/hi/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`,
 
     /**
-     * डिक्शनरी कुंजी उपसर्ग (प्रीफ़िक्स)
+     * उत्पन्न फ़ाइल में केवल सामग्री डालें, बिना कुंजी के।
      */
-    dictionaryKeyPrefix: "", // बेस प्रीफ़िक्स हटाएँ
+    noMetadata: false,
 
     /**
-     * इंगित करता है कि क्या ट्रांसफ़ॉर्म होने के बाद कंपोनेंट्स को सहेजा जाना चाहिए।
-     * इस तरह, ऐप को ट्रांसफ़ॉर्म करने के लिए कंपाइलर को केवल एक बार चलाया जा सकता है, और फिर इसे हटाया जा सकता है।
+     * शब्दकोश कुंजी उपसर्ग
+     */
+    dictionaryKeyPrefix: "", // Remove base prefix
+
+    /**
+     * इंगित करता है कि क्या घटकों को रूपांतरित होने के बाद सहेजा जाना चाहिए।
+     * इस तरह, कंपाइलer को ऐप को रूपांतरित करने के लिए केवल एक बार चलाया जा सकता है, और फिर इसे हटाया जा सकता है।
      */
     saveComponents: false,
   },

package/docs/id/compiler.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-09-09
-updatedAt: 2026-02-25
+updatedAt: 2026-03-10
 title: Intlayer Compiler | Ekstraksi Konten Otomatis untuk i18n
 description: Otomatiskan proses internasionalisasi Anda dengan Intlayer Compiler. Ekstrak konten langsung dari komponen Anda untuk i18n yang lebih cepat dan efisien di Vite, Next.js, dan lainnya.
 keywords:
@@ -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: Perbarui opsi kompiler
@@ -157,13 +160,12 @@ import { type IntlayerConfig, Locales } from "intlayer";
 const config: IntlayerConfig = {
   compiler: {
     /**
-     * Menunjukkan apakah compiler harus diaktifkan.
-     * Atur ke 'build-only' untuk melewatkan compiler selama pengembangan dan mempercepat waktu startup.
+     * Atur ke 'build-only' untuk melewatkan kompiler selama pengembangan dan mempercepat waktu mulai.
      */
     enabled: true,
 
     /**
-     * Pola untuk menelusuri kode yang akan dioptimalkan.
+     * Pattern to traverse the code to optimize.
      */
     transformPattern: [
       "**/*.{js,ts,mjs,cjs,jsx,tsx,vue,svelte}",
@@ -171,23 +173,28 @@ const config: IntlayerConfig = {
     ],
 
     /**
-     * Pola untuk dikecualikan dari pengoptimalan.
+     * Pattern to exclude from the optimization.
      */
     excludePattern: ["**/node_modules/**"],
 
     /**
      * Direktori output untuk kamus yang dioptimalkan.
      */
-    outputDir: "i18n",
+    output: ({ key }) => `compiler/${key}.content.json`,
+
+    /**
+     * Masukkan konten saja dalam file yang dihasilkan, tanpa kunci.
+     */
+    noMetadata: false,
 
     /**
      * Awalan kunci kamus
      */
-    dictionaryKeyPrefix: "", // Hapus awalan basis
+    dictionaryKeyPrefix: "", // Remove base prefix
 
     /**
      * Menunjukkan apakah komponen harus disimpan setelah ditransformasi.
-     * Dengan begitu, compiler hanya dapat dijalankan sekali untuk mentransformasi aplikasi, dan kemudian dapat dihapus.
+     * Dengan begitu, kompiler hanya perlu dijalankan sekali untuk mentransformasi aplikasi, lalu dapat dihapus.
      */
     saveComponents: false,
   },
@@ -209,3 +216,61 @@ npx intlayer fill         # Isi terjemahan yang hilang
 ```
 
 > Untuk rincian lebih lanjut, silakan merujuk ke [dokumentasi CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/cli/ci.md)
+
+### Referensi Konfigurasi Kompiler
+
+Properti berikut dapat dikonfigurasi dalam blok `compiler` pada file `intlayer.config.ts` Anda:
+
+- **enabled**:
+  - _Tipe_: `boolean | 'build-only'`
+  - _Default_: `true`
+  - _Deskripsi_: Menunjukkan apakah kompiler harus diaktifkan.
+- **dictionaryKeyPrefix**:
+  - _Tipe_: `string`
+  - _Default_: `'comp-'`
+  - _Deskripsi_: Awalan untuk kunci kamus yang diekstrak.
+- **transformPattern**:
+  - _Tipe_: `string | string[]`
+  - _Default_: `['**/*.{js,ts,mjs,cjs,jsx,tsx,vue,svelte}', '!**/node_modules/**']`
+  - _Deskripsi_: Pola untuk menelusuri kode yang ingin dioptimalkan.
+- **excludePattern**:
+  - _Tipe_: `string | string[]`
+  - _Default_: `['**/node_modules/**']`
+  - _Deskripsi_: Pola yang harus dikecualikan dari optimasi.
+- **outputDir** (Deprecated):
+  - _Tipe_: `string`
+  - _Default_: `'compiler'`
+  - _Deskripsi_: Direktori tempat kamus yang diekstrak akan disimpan.
+
+- **output**:
+  - _Tipe_: `FilePathPattern`
+  - _Default_: `({ key }) => 'compiler/${key}.content.json'`
+  - _Deskripsi_: Mendefinisikan jalur file output. Menggantikan `outputDir`. Menangani variabel dinamis seperti `{{locale}}`, `{{key}}`, `{{fileName}}`, `{{extension}}`, `{{format}}`, `{{dirPath}}`, `{{componentFileName}}`, `{{componentExtension}}`, dan `{{componentFormat}}`. Dapat diatur sebagai string menggunakan format `'my/{{var}}/path'`, atau sebagai fungsi.
+  - _Catatan_: Jalur `./**/*` diselesaikan relatif terhadap komponen. Jalur `/**/*` diselesaikan relatif terhadap `baseDir` Intlayer.
+  - _Contoh_: `output: ({ locale, key }) => 'compiler/${locale}/${key}.json'`
+
+- **noMetadata**:
+  - _Tipe_: `boolean`
+  - _Default_: `false`
+  - _Deskripsi_: Menunjukkan apakah metadata harus disimpan dalam file. Jika benar, kompiler tidak akan menyimpan metadata kamus (kunci, pembungkus konten).
+  - _Catatan_: Berguna jika digunakan dengan plugin `loadJSON`.
+  - _Contoh_: Jika `true`:
+    ```json
+    {
+      "key": "value"
+    }
+    ```
+    Jika `false`:
+    ```json
+    {
+      "key": "value",
+      "content": {
+        "key": "value"
+      }
+    }
+    ```
+
+- **saveComponents**:
+  - _Tipe_: `boolean`
+  - _Default_: `false`
+  - _Deskripsi_: Menunjukkan apakah komponen harus disimpan setelah ditransformasi.