@intlayer/docs 8.2.3 → 8.3.0-canary.0

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.

package/docs/id/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: Perbarui opsi kompiler
@@ -437,7 +440,7 @@ const config: IntlayerConfig = {
    */
   compiler: {
     /**
-     * Indicates if the compiler should be enabled.
+     * Menunjukkan apakah kompiler harus diaktifkan.
      */
     enabled: true,
 
@@ -455,18 +458,23 @@ const config: IntlayerConfig = {
     excludePattern: ["**/node_modules/**"],
 
     /**
-     * Output directory for the optimized dictionaries.
+     * Direktori output untuk kamus yang dioptimalkan.
      */
-    outputDir: "compiler",
+    output: ({ key }) => `compiler/${key}.content.json`,
 
     /**
-     * Dictionary key prefix
+     * Masukkan konten saja dalam file yang dihasilkan, tanpa kunci.
+     */
+    noMetadata: false,
+
+    /**
+     * Awalan kunci kamus
      */
     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.
+     * Menunjukkan apakah komponen harus disimpan setelah ditransformasi.
+     * Dengan begitu, kompiler hanya perlu dijalankan sekali untuk mentransformasi aplikasi, lalu dapat dihapus.
      */
     saveComponents: false,
   },
@@ -1082,7 +1090,7 @@ Opsi build berlaku untuk plugin `@intlayer/babel` dan `@intlayer/swc`.
   - _Catatan_: Pastikan semua kunci dideklarasikan secara statis dalam panggilan `useIntlayer`. Contoh: `useIntlayer('navbar')`.
 
 - **importMode**:
-  - _Note_: **Deprecated**: Use `dictionary.importMode` instead.
+  - _Catatan_: **Deprecated**: Use `dictionary.importMode` instead.
   - _Tipe_: `'static' | 'dynamic' | 'fetch'`
   - _Default_: `'static'`
   - _Deskripsi_: Mengontrol bagaimana kamus diimpor.
@@ -1100,10 +1108,10 @@ Opsi build berlaku untuk plugin `@intlayer/babel` dan `@intlayer/swc`.
   - _Catatan_: Mode live akan menggunakan API sinkronisasi live untuk mengambil kamus. Jika panggilan API gagal, kamus akan diimpor secara dinamis sebagai mode "dynamic".
   - _Catatan_: Opsi ini tidak akan memengaruhi fungsi `getIntlayer`, `getDictionary`, `useDictionary`, `useDictionaryAsync` dan `useDictionaryDynamic`.
 - **checkTypes**:
-  - _Type_: `boolean`
+  - _Tipe_: `boolean`
   - _Default_: `false`
-  - _Description_: Menunjukkan apakah build harus memeriksa tipe TypeScript dan mencatat kesalahan.
-  - _Note_: Hal ini dapat memperlambat proses build.
+  - _Deskripsi_: Menunjukkan apakah build harus memeriksa tipe TypeScript dan mencatat kesalahan.
+  - _Catatan_: Hal ini dapat memperlambat proses build.
 
 - **outputFormat**:
   - _Tipe_: `'esm' | 'cjs'`
@@ -1166,3 +1174,31 @@ Pengaturan yang mengontrol kompiler Intlayer, yang mengekstrak kamus langsung da
   - _Tipe_: `string`
   - _Default_: `'compiler'`
   - _Deskripsi_: Direktori tempat kamus yang diekstrak akan disimpan, relatif terhadap jalur dasar proyek Anda.
+
+- **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"
+      }
+    }
+    ```

package/docs/id/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: Rilis Awal
@@ -128,23 +131,28 @@ const config: IntlayerConfig = {
   },
   compiler: {
     /**
-     * Menunjukkan apakah kompilator harus diaktifkan.
+     * Menunjukkan apakah kompiler harus diaktifkan.
      */
     enabled: true,
 
     /**
      * Direktori output untuk kamus yang dioptimalkan.
      */
-    outputDir: "compiler",
+    output: ({ locale, key }) => `compiler/${locale}/${key}.json`,
+
+    /**
+     * Masukkan konten saja dalam file yang dihasilkan, tanpa kunci.
+     */
+    noMetadata: false,
 
     /**
      * Awalan kunci kamus
      */
-    dictionaryKeyPrefix: "", // Hapus awalan dasar
+    dictionaryKeyPrefix: "", // Remove base prefix
 
     /**
-     * Menunjukkan apakah komponen harus disimpan setelah diubah.
-     * Dengan begitu, kompilator dapat dijalankan satu kali saja untuk mengubah aplikasi, kemudian dapat dihapus.
+     * Menunjukkan apakah komponen harus disimpan setelah ditransformasi.
+     * Dengan begitu, kompiler hanya perlu dijalankan sekali untuk mentransformasi aplikasi, lalu dapat dihapus.
      */
     saveComponents: false,
   },

package/docs/id/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: Rilis awal
@@ -125,23 +128,28 @@ const config: IntlayerConfig = {
   },
   compiler: {
     /**
-     * Menunjukkan apakah kompilator harus diaktifkan.
+     * Menunjukkan apakah kompiler harus diaktifkan.
      */
     enabled: true,
 
     /**
      * Direktori output untuk kamus yang dioptimalkan.
      */
-    outputDir: "compiler",
+    output: ({ locale, key }) => `compiler/${locale}/${key}.json`,
+
+    /**
+     * Masukkan konten saja dalam file yang dihasilkan, tanpa kunci.
+     */
+    noMetadata: false,
 
     /**
      * Awalan kunci kamus
      */
-    dictionaryKeyPrefix: "", // Hapus awalan dasar
+    dictionaryKeyPrefix: "", // Remove base prefix
 
     /**
-     * Menunjukkan apakah komponen harus disimpan setelah diubah.
-     * Dengan begitu, kompilator dapat dijalankan satu kali saja untuk mengubah aplikasi, kemudian dapat dihapus.
+     * Menunjukkan apakah komponen harus disimpan setelah ditransformasi.
+     * Dengan begitu, kompiler hanya perlu dijalankan sekali untuk mentransformasi aplikasi, lalu dapat dihapus.
      */
     saveComponents: false,
   },

package/docs/id/per_locale_file.md

@@ -128,7 +128,7 @@ const config: IntlayerConfig = {
 export default config;
 ```
 
-Dengan menggunakan konfigurasi ini, semua file per-locale akan dibuat dengan locale default yang diatur ke bahasa Inggris. Ini juga mencakup pembuatan file `.content` menggunakan perintah `extract`, dan compiler. (Lihat [Compiler](https://intlayer.org/doc/compiler) atau [Extract](https://intlayer.org/doc/concept/cli/extract) untuk informasi lebih lanjut.)
+Dengan menggunakan konfigurasi ini, semua file per-locale akan dibuat dengan locale default yang diatur ke bahasa Inggris. Ini juga mencakup pembuatan file `.content` menggunakan perintah `extract`, dan compiler. (Lihat [Compiler](https://intlayer.org/doc/compiler) atau [Extract](https://github.com/aymericzip/intlayer/edit/main/docs/docs/en/cli/extract.md) untuk informasi lebih lanjut.)
 
 ## Format Per-Locale
 

package/docs/it/compiler.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-09-09
-updatedAt: 2026-02-25
+updatedAt: 2026-03-10
 title: Compiler Intlayer | Estrazione automatica dei contenuti per i18n
 description: Automatizza il tuo processo di internazionalizzazione con il compilatore Intlayer. Estrai contenuti direttamente dai tuoi componenti per un i18n più veloce ed efficiente in Vite, Next.js e altro.
 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: Aggiorna le opzioni del compilatore
@@ -157,13 +160,12 @@ import { type IntlayerConfig, Locales } from "intlayer";
 const config: IntlayerConfig = {
   compiler: {
     /**
-     * Indica se il compiler deve essere abilitato.
-     * Imposta su 'build-only' per saltare il compiler durante lo sviluppo e velocizzare i tempi di avvio.
+     * Imposta su 'build-only' per saltare il compilatore durante lo sviluppo e accelerare i tempi di avvio.
      */
     enabled: true,
 
     /**
-     * Pattern per attraversare il codice da ottimizzare.
+     * Pattern to traverse the code to optimize.
      */
     transformPattern: [
       "**/*.{js,ts,mjs,cjs,jsx,tsx,vue,svelte}",
@@ -171,23 +173,28 @@ const config: IntlayerConfig = {
     ],
 
     /**
-     * Pattern da escludere dall'ottimizzazione.
+     * Pattern to exclude from the optimization.
      */
     excludePattern: ["**/node_modules/**"],
 
     /**
      * Directory di output per i dizionari ottimizzati.
      */
-    outputDir: "i18n",
+    output: ({ locale, key }) => `compiler/${locale}/${key}.json`,
+
+    /**
+     * Inserisci solo il contenuto nel file generato, senza chiave.
+     */
+    noMetadata: false,
 
     /**
      * Prefisso chiave dizionario
      */
-    dictionaryKeyPrefix: "", // Rimuovi prefisso di base
+    dictionaryKeyPrefix: "", // Remove base prefix
 
     /**
      * Indica se i componenti devono essere salvati dopo essere stati trasformati.
-     * In questo modo, il compiler può essere eseguito solo una volta per trasformare l'app, e poi può essere rimosso.
+     * In questo modo, il compilatore può essere eseguito una sola volta per trasformare l'app e poi rimosso.
      */
     saveComponents: false,
   },
@@ -209,3 +216,61 @@ npx intlayer fill         # Riempi le traduzioni mancanti
 ```
 
 > Per maggiori dettagli, fare riferimento alla [documentazione CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/cli/ci.md)
+
+### Riferimento alla configurazione del compilatore
+
+Le seguenti proprietà possono essere configurate nel blocco `compiler` del file `intlayer.config.ts`:
+
+- **enabled**:
+  - _Tipo_: `boolean | 'build-only'`
+  - _Predefinito_: `true`
+  - _Descrizione_: Indica se il compilatore deve essere abilitato.
+- **dictionaryKeyPrefix**:
+  - _Tipo_: `string`
+  - _Predefinito_: `'comp-'`
+  - _Descrizione_: Prefisso per le chiavi del dizionario estratte.
+- **transformPattern**:
+  - _Tipo_: `string | string[]`
+  - _Predefinito_: `['**/*.{js,ts,mjs,cjs,jsx,tsx,vue,svelte}', '!**/node_modules/**']`
+  - _Descrizione_: Modelli per attraversare il codice da ottimizzare.
+- **excludePattern**:
+  - _Tipo_: `string | string[]`
+  - _Predefinito_: `['**/node_modules/**']`
+  - _Descrizione_: Modelli da escludere dall'ottimizzazione.
+- **outputDir** (Deprecated):
+  - _Tipo_: `string`
+  - _Predefinito_: `'compiler'`
+  - _Descrizione_: La directory in cui verranno memorizzati i dizionari estratti.
+
+- **output**:
+  - _Type_: `FilePathPattern`
+  - _Default_: `({ key }) => 'compiler/${key}.content.json'`
+  - _Descrizione_: Definisce il percorso dei file di output. Sostituisce `outputDir`. Gestisce variabili dinamiche come `{{locale}}`, `{{key}}`, `{{fileName}}`, `{{extension}}`, `{{format}}`, `{{dirPath}}`, `{{componentFileName}}`, `{{componentExtension}}`, `{{componentFormat}}`. Può essere impostato come stringa utilizzando il formato `'my/{{var}}/path'` o come funzione.
+  - _Nota_: `./**/*` I percorsi sono risolti relativamente al componente. `/**/*` i percorsi sono risolti relativamente al `baseDir` di Intlayer.
+  - _Esempio_: `output: ({ locale, key }) => 'compiler/${locale}/${key}.json'`
+
+- **noMetadata**:
+  - _Tipo_: `boolean`
+  - _Predefinito_: `false`
+  - _Descrizione_: Indica se i metadati devono essere salvati nel file. Se vero, il compilatore non salverà i metadatati dei dizionari (chiave, contenitore del contenuto).
+  - _Nota_: Utile se utilizzato con il plugin `loadJSON`.
+  - _Esempio_: Se `true`:
+    ```json
+    {
+      "key": "value"
+    }
+    ```
+    Se `false`:
+    ```json
+    {
+      "key": "value",
+      "content": {
+        "key": "value"
+      }
+    }
+    ```
+
+- **saveComponents**:
+  - _Tipo_: `boolean`
+  - _Predefinito_: `false`
+  - _Descrizione_: Indica se i componenti devono essere salvati dopo essere stati trasformati.

package/docs/it/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-02-25
+updatedAt: 2026-03-10
 title: Configurazione
 description: Scopri come configurare Intlayer per la tua applicazione. Comprendi le varie impostazioni e opzioni disponibili per personalizzare Intlayer secondo le tue esigenze.
 keywords:
@@ -14,6 +14,9 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 8.2.0
+    date: 2026-03-10
+    changes: Update compiler options, add 'output' and 'noMetadata' support
   - version: 8.1.7
     date: 2026-02-25
     changes: Aggiorna le opzioni del compilatore
@@ -419,7 +422,7 @@ const config: IntlayerConfig = {
    */
   compiler: {
     /**
-     * Indicates if the compiler should be enabled.
+     * Indica se il compilatore deve essere abilitato.
      */
     enabled: true,
 
@@ -437,18 +440,23 @@ const config: IntlayerConfig = {
     excludePattern: ["**/node_modules/**"],
 
     /**
-     * Output directory for the optimized dictionaries.
+     * Directory di output per i dizionari ottimizzati.
      */
-    outputDir: "compiler",
+    output: ({ locale, key }) => `compiler/${locale}/${key}.json`,
 
     /**
-     * Dictionary key prefix
+     * Inserisci solo il contenuto nel file generato, senza chiave.
+     */
+    noMetadata: false,
+
+    /**
+     * Prefisso chiave dizionario
      */
     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.
+     * Indica se i componenti devono essere salvati dopo essere stati trasformati.
+     * In questo modo, il compilatore può essere eseguito una sola volta per trasformare l'app e poi rimosso.
      */
     saveComponents: false,
   },
@@ -704,7 +712,7 @@ Impostazioni relative alla gestione del contenuto all'interno dell'applicazione,
 #### Proprietà
 
 - **autoFill**:
-  - _Tipo_: `boolean | string | { [key in Locales]?: string }`
+  - _Tipo_: `boolean | string | FilePathPattern | { [key in Locales]?: string }`
   - _Predefinito_: `undefined`
   - _Descrizione_: Indica come il contenuto dovrebbe essere compilato automaticamente usando l'IA. Può essere dichiarato globalmente nel file `intlayer.config.ts`.
   - _Esempio_: true
@@ -832,11 +840,11 @@ Per ulteriori informazioni sui file di dichiarazione del contenuto e su come ven
 - **locale**
 - **location**
 - **importMode**:
-  - _Note_: **Deprecated**: Use `dictionary.importMode` instead.
-  - _Type_: `'static' | 'dynamic' | 'fetch'`
-  - _Default_: `'static'`
-  - _Description_: Controls how dictionaries are imported.
-  - _Example_: `'dynamic'`
+  - _Nota_: **Deprecated**: Use `dictionary.importMode` instead.
+  - _Tipo_: `'static' | 'dynamic' | 'fetch'`
+  - _Predefinito_: `'static'`
+  - _Descrizione_: Controls how dictionaries are imported.
+  - _Esempio_: `'dynamic'`
 - **priority**
 - **live**
 - **schema**
@@ -968,10 +976,10 @@ Le opzioni di build si applicano ai plugin `@intlayer/babel` e `@intlayer/swc`.
   - _Nota_: Può essere utilizzato per disabilitare la build dei dizionari, ad esempio quando l'esecuzione in un ambiente Node.js dovrebbe essere evitata.
 
 - **checkTypes**:
-  - _Type_: `boolean`
-  - _Default_: `false`
-  - _Description_: Indica se la build deve controllare i tipi TypeScript e registrare gli errori.
-  - _Note_: Questo può rallentare la build.
+  - _Tipo_: `boolean`
+  - _Predefinito_: `false`
+  - _Descrizione_: Indica se la build deve controllare i tipi TypeScript e registrare gli errori.
+  - _Nota_: Questo può rallentare la build.
 
 - **optimize**:
   - _Tipo_: `boolean`
@@ -984,7 +992,7 @@ Le opzioni di build si applicano ai plugin `@intlayer/babel` e `@intlayer/swc`.
   - _Nota_: Assicurarsi che tutte le chiavi siano dichiarate staticamente nelle chiamate a `useIntlayer`. Es. `useIntlayer('navbar')`.
 
 - **importMode**:
-  - _Note_: **Deprecated**: Use `dictionary.importMode` instead.
+  - _Nota_: **Deprecated**: Use `dictionary.importMode` instead.
   - _Tipo_: `'static' | 'dynamic' | 'fetch'`
   - _Predefinito_: `'static'`
   - _Descrizione_: Controlla come vengono importati i dizionari.
@@ -1063,3 +1071,31 @@ Impostazioni che controllano il compilatore Intlayer, che estrae i dizionari dir
   - _Tipo_: `string`
   - _Predefinito_: `'compiler'`
   - _Descrizione_: La directory in cui verranno memorizzati i dizionari estratti, relativa al percorso di base del progetto.
+
+- **output**:
+  - _Type_: `FilePathPattern`
+  - _Default_: `({ key }) => 'compiler/${key}.content.json'`
+  - _Descrizione_: Definisce il percorso dei file di output. Sostituisce `outputDir`. Gestisce variabili dinamiche come `{{locale}}`, `{{key}}`, `{{fileName}}`, `{{extension}}`, `{{format}}`, `{{dirPath}}`, `{{componentFileName}}`, `{{componentExtension}}`, `{{componentFormat}}`. Può essere impostato come stringa utilizzando il formato `'my/{{var}}/path'` o come funzione.
+  - _Nota_: `./**/*` I percorsi sono risolti relativamente al componente. `/**/*` i percorsi sono risolti relativamente al `baseDir` di Intlayer.
+  - _Esempio_: `output: ({ locale, key }) => 'compiler/${locale}/${key}.json'`
+
+- **noMetadata**:
+  - _Tipo_: `boolean`
+  - _Predefinito_: `false`
+  - _Descrizione_: Indica se i metadati devono essere salvati nel file. Se vero, il compilatore non salverà i metadatati dei dizionari (chiave, contenitore del contenuto).
+  - _Nota_: Utile se utilizzato con il plugin `loadJSON`.
+  - _Esempio_: Se `true`:
+    ```json
+    {
+      "key": "value"
+    }
+    ```
+    Se `false`:
+    ```json
+    {
+      "key": "value",
+      "content": {
+        "key": "value"
+      }
+    }
+    ```

package/docs/it/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: Rilascio iniziale
@@ -135,16 +138,21 @@ const config: IntlayerConfig = {
     /**
      * Directory di output per i dizionari ottimizzati.
      */
-    outputDir: "compiler",
+    output: ({ locale, key }) => `compiler/${locale}/${key}.json`,
 
     /**
-     * Prefisso della chiave del dizionario
+     * Inserisci solo il contenuto nel file generato, senza chiave.
      */
-    dictionaryKeyPrefix: "", // Rimuovi il prefisso di base
+    noMetadata: false,
+
+    /**
+     * Prefisso chiave dizionario
+     */
+    dictionaryKeyPrefix: "", // Remove base prefix
 
     /**
      * Indica se i componenti devono essere salvati dopo essere stati trasformati.
-     * In questo modo, il compilatore può essere eseguito una sola volta per trasformare l'app e può quindi essere rimosso.
+     * In questo modo, il compilatore può essere eseguito una sola volta per trasformare l'app e poi rimosso.
      */
     saveComponents: false,
   },

package/docs/it/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: Rilascio iniziale
@@ -137,16 +140,21 @@ const config: IntlayerConfig = {
     /**
      * Directory di output per i dizionari ottimizzati.
      */
-    outputDir: "compiler",
+    output: ({ locale, key }) => `compiler/${locale}/${key}.json`,
 
     /**
-     * Prefisso della chiave del dizionario
+     * Inserisci solo il contenuto nel file generato, senza chiave.
      */
-    dictionaryKeyPrefix: "", // Rimuovi il prefisso di base
+    noMetadata: false,
+
+    /**
+     * Prefisso chiave dizionario
+     */
+    dictionaryKeyPrefix: "", // Remove base prefix
 
     /**
      * Indica se i componenti devono essere salvati dopo essere stati trasformati.
-     * In questo modo, il compilatore può essere eseguito una sola volta per trasformare l'app e può quindi essere rimosso.
+     * In questo modo, il compilatore può essere eseguito una sola volta per trasformare l'app e poi rimosso.
      */
     saveComponents: false,
   },