@intlayer/docs 8.2.4 → 8.3.0-canary.1

package/docs/id/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-02-25
+updatedAt: 2026-03-11
 title: Konfigurasi
 description: Pelajari cara mengonfigurasi Intlayer untuk aplikasi Anda. Pahami berbagai pengaturan dan opsi yang tersedia untuk menyesuaikan Intlayer sesuai kebutuhan Anda.
 keywords:
@@ -14,18 +14,24 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 8.3.0
+    data: 2026-03-11
+    changes: Pindahkan 'baseDir' dari konfigurasi 'content' ke 'system'
+  - version: 8.2.0
+    date: 2026-03-09
+    changes: Perbarui opsi kompiler, tambahkan dukungan 'output' dan 'noMetadata'
   - version: 8.1.7
     date: 2026-02-25
     changes: Perbarui opsi kompiler
   - 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: Tambahkan dukungan untuk penyedia Open Router, Alibaba, Amazon, Google Vertex Bedrock, Fireworks, Groq, Hugging Face, dan Together.ai
   - version: 8.0.5
     date: 2026-02-06
     changes: Tambahkan `dataSerialization` ke konfigurasi AI
   - version: 8.0.0
     date: 2026-01-22
-    changes: Move `importMode` build configuration to `dictionary` configuration.
+    changes: Pindahkan konfigurasi build importMode ke konfigurasi kamus.
   - version: 8.0.0
     date: 2026-01-18
     changes: Pisahkan konfigurasi sistem dari konfigurasi konten. Pindahkan jalur internal ke properti `system`. Tambahkan `codeDir` untuk memisahkan file konten dari transformasi kode.
@@ -437,7 +443,7 @@ const config: IntlayerConfig = {
    */
   compiler: {
     /**
-     * Indicates if the compiler should be enabled.
+     * Menunjukkan apakah kompiler harus diaktifkan.
      */
     enabled: true,
 
@@ -455,18 +461,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,
   },
@@ -851,13 +862,6 @@ Pengaturan terkait penanganan konten dalam aplikasi, termasuk nama direktori, ek
   - _Contoh_: `['.data.ts', '.data.js', '.data.json']`
   - _Catatan_: Menyesuaikan ekstensi file dapat membantu menghindari konflik.
 
-- **baseDir**:
-  - _Tipe_: `string`
-  - _Default_: `process.cwd()`
-  - _Deskripsi_: Direktori dasar untuk proyek.
-  - _Contoh_: `'/path/to/project'`
-  - _Catatan_: Ini digunakan untuk menyelesaikan semua direktori terkait Intlayer.
-
 - **contentDir**:
   - _Tipe_: `string[]`
   - _Default_: `['.']`
@@ -914,6 +918,21 @@ Pengaturan terkait penanganan konten dalam aplikasi, termasuk nama direktori, ek
   - _Deskripsi_: Direktori yang dikecualikan dari pencarian konten.
   - _Catatan_: Pengaturan ini belum digunakan, tetapi direncanakan untuk implementasi di masa depan.
 
+---
+
+### Konfigurasi Sistem
+
+Pengaturan terkait jalur internal dan hasil output Intlayer. Pengaturan ini biasanya bersifat internal dan tidak perlu diubah oleh pengguna.
+
+#### Properti
+
+- **baseDir**:
+  - _Tipe_: `string`
+  - _Default_: `process.cwd()`
+  - _Deskripsi_: Direktori dasar untuk proyek.
+  - _Contoh_: `'/path/to/project'`
+  - _Catatan_: Ini digunakan untuk menyelesaikan semua direktori terkait Intlayer.
+
 - **formatCommand**:
   - _Tipe_: `string`
   - _Default_: `undefined`
@@ -1082,7 +1101,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 +1119,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 +1185,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_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/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/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-11
 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,18 +14,24 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 8.3.0
+    data: 2026-03-11
+    changes: Sposta 'baseDir' dalla configurazione 'content' alla configurazione 'system'
+  - version: 8.2.0
+    date: 2026-03-10
+    changes: Aggiorna le opzioni del compilatore, aggiungi il supporto per 'output' e 'noMetadata'
   - version: 8.1.7
     date: 2026-02-25
     changes: Aggiorna le opzioni del compilatore
   - 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: Aggiungi il supporto per i fornitori Open Router, Alibaba, Amazon, Google Vertex Bedrock, Fireworks, Groq, Hugging Face e Together.ai
   - version: 8.0.5
     date: 2026-02-06
     changes: Aggiungi `dataSerialization` alla configurazione AI
   - version: 8.0.0
     date: 2026-01-22
-    changes: Move `importMode` build configuration to `dictionary` configuration.
+    changes: Sposta la configurazione di build importMode nella configurazione del dizionario.
   - version: 8.0.0
     date: 2026-01-18
     changes: Separare la configurazione del sistema dalla configurazione del contenuto. Spostare i percorsi interni alla proprietà `system`. Aggiungere `codeDir` per separare i file di contenuto dalla trasformazione del codice.
@@ -419,7 +425,7 @@ const config: IntlayerConfig = {
    */
   compiler: {
     /**
-     * Indicates if the compiler should be enabled.
+     * Indica se il compilatore deve essere abilitato.
      */
     enabled: true,
 
@@ -437,18 +443,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 +715,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
@@ -727,13 +738,6 @@ Impostazioni relative alla gestione del contenuto all'interno dell'applicazione,
   - _Esempio_: `['.data.ts', '.data.js', '.data.json']`
   - _Nota_: Personalizzare le estensioni dei file può aiutare a evitare conflitti.
 
-- **baseDir**:
-  - _Tipo_: `string`
-  - _Predefinito_: `process.cwd()`
-  - _Descrizione_: La directory base per il progetto.
-  - _Esempio_: `'/path/to/project'`
-  - _Nota_: Viene utilizzata per risolvere tutte le directory relative a Intlayer.
-
 - **contentDir**:
   - _Tipo_: `string[]`
   - _Predefinito_: `['.']`
@@ -772,6 +776,13 @@ Impostazioni relative ai percorsi interni e ai risultati di output di Intlayer.
 
 #### Proprietà
 
+- **baseDir**:
+  - _Tipo_: `string`
+  - _Predefinito_: `process.cwd()`
+  - _Descrizione_: La directory base per il progetto.
+  - _Esempio_: `'/path/to/project'`
+  - _Nota_: Viene utilizzata per risolvere tutte le directory relative a Intlayer.
+
 - **dictionariesDir**:
   - _Tipo_: `string`
   - _Predefinito_: `'.intlayer/dictionary'`
@@ -832,11 +843,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 +979,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 +995,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 +1074,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_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 },
       ],
     };
   },