@intlayer/docs 8.2.3 → 8.3.0-canary.0

package/docs/ko/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: 초기 릴리스
@@ -124,9 +127,25 @@ const config: IntlayerConfig = {
     defaultLocale: Locales.ENGLISH,
   },
   compiler: {
-    enabled: true, // 개발 모드에서의 영향을 제한하기 위해 'build-only'로 설정 가능
-    outputDir: "i18n",
-    dictionaryKeyPrefix: "", // 접두사 comp- 없음
+    /**
+     * 개발 중에 컴파일러를 건너뛰고 시작 시간을 단축하려면 'build-only'로 설정하십시오.
+     */
+    enabled: true,
+
+    /**
+     * 최적화된 사전의 출력 디렉터리.
+     */
+    output: ({ locale, key }) => `compiler/${locale}/${key}.json`,
+
+    /**
+     * 키 없이 생성된 파일에 콘텐츠만 삽입합니다.
+     */
+    noMetadata: false,
+
+    /**
+     * 사전 키 접두사
+     */
+    dictionaryKeyPrefix: "", // Remove base prefix
   },
   ai: {
     provider: "openai",

package/docs/pl/compiler.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-09-09
-updatedAt: 2026-02-25
+updatedAt: 2026-03-10
 title: Intlayer Compiler | Zautomatyzowane wydobywanie treści dla i18n
 description: Zautomatyzuj proces internacjonalizacji za pomocą Intlayer Compiler. Wydobywaj treści bezpośrednio z komponentów dla szybszego i bardziej efektywnego i18n w Vite, Next.js i innych.
 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: Aktualizacja opcji kompilatora
@@ -157,13 +160,12 @@ import { type IntlayerConfig, Locales } from "intlayer";
 const config: IntlayerConfig = {
   compiler: {
     /**
-     * Wskazuje, czy kompilator powinien być włączony.
      * Ustaw na 'build-only', aby pominąć kompilator podczas programowania i przyspieszyć czas uruchamiania.
      */
     enabled: true,
 
     /**
-     * Wzór do przeszukiwania kodu w celu optymalizacji.
+     * Pattern to traverse the code to optimize.
      */
     transformPattern: [
       "**/*.{js,ts,mjs,cjs,jsx,tsx,vue,svelte}",
@@ -171,23 +173,28 @@ const config: IntlayerConfig = {
     ],
 
     /**
-     * Wzór do wykluczenia z optymalizacji.
+     * Pattern to exclude from the optimization.
      */
     excludePattern: ["**/node_modules/**"],
 
     /**
      * Katalog wyjściowy dla zoptymalizowanych słowników.
      */
-    outputDir: "i18n",
+    output: ({ key }) => `compiler/${key}.content.json`,
+
+    /**
+     * Wstaw tylko zawartość do wygenerowanego pliku, bez klucza.
+     */
+    noMetadata: false,
 
     /**
      * Prefiks klucza słownika
      */
-    dictionaryKeyPrefix: "", // Usuń podstawowy prefiks
+    dictionaryKeyPrefix: "", // Remove base prefix
 
     /**
-     * Wskazuje, czy komponenty powinny zostać zapisane po przekształceniu.
-     * W ten sposób kompilator może zostać uruchomiony tylko raz w celu przekształcenia aplikacji, a następnie można go usunąć.
+     * Wskazuje, czy komponenty powinny być zapisywane po transformacji.
+     * W ten sposób kompilator można uruchomić tylko raz, aby przetransformować aplikację, a następnie go usunąć.
      */
     saveComponents: false,
   },
@@ -209,3 +216,61 @@ npx intlayer fill         # Uzupełnij brakujące tłumaczenia
 ```
 
 > Więcej szczegółów znajdziesz w [dokumentacji CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/cli/ci.md)
+
+### Odniesienie do konfiguracji kompilatora
+
+Następujące właściwości można skonfigurować w bloku `compiler` pliku `intlayer.config.ts`:
+
+- **enabled**:
+  - _Typ_: `boolean | 'build-only'`
+  - _Domyślny_: `true`
+  - _Opis_: Wskazuje, czy kompilator powinien być włączony.
+- **dictionaryKeyPrefix**:
+  - _Typ_: `string`
+  - _Domyślny_: `'comp-'`
+  - _Opis_: Prefiks dla wyekstrahowanych kluczy słownika.
+- **transformPattern**:
+  - _Typ_: `string | string[]`
+  - _Domyślny_: `['**/*.{js,ts,mjs,cjs,jsx,tsx,vue,svelte}', '!**/node_modules/**']`
+  - _Opis_: Wzorce do przeszukiwania kodu w celu optymalizacji.
+- **excludePattern**:
+  - _Typ_: `string | string[]`
+  - _Domyślny_: `['**/node_modules/**']`
+  - _Opis_: Wzorce do wykluczenia z optymalizacji.
+- **outputDir** (Deprecated):
+  - _Typ_: `string`
+  - _Domyślny_: `'compiler'`
+  - _Opis_: Katalog, w którym będą przechowywane wyekstrahowane słowniki.
+
+- **output**:
+  - _Typ_: `FilePathPattern`
+  - _Domyślny_: `({ key }) => 'compiler/${key}.content.json'`
+  - _Opis_: Definiuje ścieżkę plików wyjściowych. Zastępuje `outputDir`. Obsługuje zmienne dynamiczne, takie jak `{{locale}}`, `{{key}}`, `{{fileName}}`, `{{extension}}`, `{{format}}`, `{{dirPath}}`, `{{componentFileName}}`, `{{componentExtension}}`, `{{componentFormat}}`. Można ustawić jako ciąg znaków w formacie `'my/{{var}}/path'` lub jako funkcję.
+  - _Uwaga_: Ścieżki `./**/*` są rozwiązywane względem komponentu. Ścieżki `/**/*` są rozwiązywane względem `baseDir` Intlayer.
+  - _Przykład_: `output: ({ locale, key }) => 'compiler/${locale}/${key}.json'`
+
+- **noMetadata**:
+  - _Typ_: `boolean`
+  - _Domyślny_: `false`
+  - _Opis_: Wskazuje, czy metadane powinny być zapisywane w pliku. Jeśli true, kompilator nie będzie zapisywał metadanych słowników (klucza, otoczki zawartości).
+  - _Uwaga_: Przydatne w przypadku korzystania z wtyczki `loadJSON`.
+  - _Przykład_: Jeśli `true`:
+    ```json
+    {
+      "key": "value"
+    }
+    ```
+    Jeśli `false`:
+    ```json
+    {
+      "key": "value",
+      "content": {
+        "key": "value"
+      }
+    }
+    ```
+
+- **saveComponents**:
+  - _Typ_: `boolean`
+  - _Domyślny_: `false`
+  - _Opis_: Wskazuje, czy komponenty powinny być zapisywane po transformacji.

package/docs/pl/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: Aktualizacja opcji kompilatora
@@ -434,7 +437,7 @@ const config: IntlayerConfig = {
    */
   compiler: {
     /**
-     * Indicates if the compiler should be enabled.
+     * Wskazuje, czy kompilator powinien być włączony.
      */
     enabled: true,
 
@@ -452,18 +455,23 @@ const config: IntlayerConfig = {
     excludePattern: ["**/node_modules/**"],
 
     /**
-     * Output directory for the optimized dictionaries.
+     * Katalog wyjściowy dla zoptymalizowanych słowników.
      */
-    outputDir: "compiler",
+    output: ({ key }) => `compiler/${key}.content.json`,
 
     /**
-     * Dictionary key prefix
+     * Wstaw tylko zawartość do wygenerowanego pliku, bez klucza.
+     */
+    noMetadata: false,
+
+    /**
+     * Prefiks klucza słownika
      */
     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.
+     * Wskazuje, czy komponenty powinny być zapisywane po transformacji.
+     * W ten sposób kompilator można uruchomić tylko raz, aby przetransformować aplikację, a następnie go usunąć.
      */
     saveComponents: false,
   },
@@ -1070,7 +1078,7 @@ Opcje budowania dotyczą wtyczek `@intlayer/babel` oraz `@intlayer/swc`.
   - _Uwaga_: Upewnij się, że wszystkie klucze są deklarowane statycznie w wywołaniach `useIntlayer`, np. `useIntlayer('navbar')`.
 
 - **importMode**:
-  - _Note_: **Deprecated**: Use `dictionary.importMode` instead.
+  - _Uwaga_: **Deprecated**: Use `dictionary.importMode` instead.
   - _Typ_: `'static' | 'dynamic' | 'fetch'`
   - _Domyślnie_: `'static'`
   - _Opis_: Kontroluje sposób importowania słowników.
@@ -1088,10 +1096,10 @@ Opcje budowania dotyczą wtyczek `@intlayer/babel` oraz `@intlayer/swc`.
   - _Uwaga_: Tryb live będzie korzystał z API synchronizacji na żywo do pobierania słowników. Jeśli wywołanie API się nie powiedzie, słowniki zostaną zaimportowane dynamicznie w trybie "dynamic".
   - _Uwaga_: Ta opcja nie wpłynie na funkcje `getIntlayer`, `getDictionary`, `useDictionary`, `useDictionaryAsync` oraz `useDictionaryDynamic`.
 - **checkTypes**:
-  - _Type_: `boolean`
-  - _Default_: `false`
-  - _Description_: Wskazuje, czy kompilacja powinna sprawdzać typy TypeScript i rejestrować błędy.
-  - _Note_: Może to spowolnić proces kompilacji.
+  - _Typ_: `boolean`
+  - _Domyślny_: `false`
+  - _Opis_: Wskazuje, czy kompilacja powinna sprawdzać typy TypeScript i rejestrować błędy.
+  - _Uwaga_: Może to spowolnić proces kompilacji.
 
 - **outputFormat**:
   - _Typ_: `'esm' | 'cjs'`
@@ -1154,3 +1162,31 @@ Ustawienia kontrolujące kompilator Intlayer, który wyodrębnia słowniki bezpo
   - _Typ_: `string`
   - _Domyślnie_: `'compiler'`
   - _Opis_: Katalog, w którym będą przechowywane wyodrębnione słowniki, względem ścieżki bazowej projektu.
+
+- **output**:
+  - _Typ_: `FilePathPattern`
+  - _Domyślny_: `({ key }) => 'compiler/${key}.content.json'`
+  - _Opis_: Definiuje ścieżkę plików wyjściowych. Zastępuje `outputDir`. Obsługuje zmienne dynamiczne, takie jak `{{locale}}`, `{{key}}`, `{{fileName}}`, `{{extension}}`, `{{format}}`, `{{dirPath}}`, `{{componentFileName}}`, `{{componentExtension}}`, `{{componentFormat}}`. Można ustawić jako ciąg znaków w formacie `'my/{{var}}/path'` lub jako funkcję.
+  - _Uwaga_: Ścieżki `./**/*` są rozwiązywane względem komponentu. Ścieżki `/**/*` są rozwiązywane względem `baseDir` Intlayer.
+  - _Przykład_: `output: ({ locale, key }) => 'compiler/${locale}/${key}.json'`
+
+- **noMetadata**:
+  - _Typ_: `boolean`
+  - _Domyślny_: `false`
+  - _Opis_: Wskazuje, czy metadane powinny być zapisywane w pliku. Jeśli true, kompilator nie będzie zapisywał metadanych słowników (klucza, otoczki zawartości).
+  - _Uwaga_: Przydatne w przypadku korzystania z wtyczki `loadJSON`.
+  - _Przykład_: Jeśli `true`:
+    ```json
+    {
+      "key": "value"
+    }
+    ```
+    Jeśli `false`:
+    ```json
+    {
+      "key": "value",
+      "content": {
+        "key": "value"
+      }
+    }
+    ```

package/docs/pl/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: Pierwsze wydanie
@@ -128,23 +131,28 @@ const config: IntlayerConfig = {
   },
   compiler: {
     /**
-     * Określa, czy kompilator powinien być włączony.
+     * Wskazuje, czy kompilator powinien być włączony.
      */
     enabled: true,
 
     /**
      * Katalog wyjściowy dla zoptymalizowanych słowników.
      */
-    outputDir: "compiler",
+    output: ({ locale, key }) => `compiler/${locale}/${key}.json`,
+
+    /**
+     * Wstaw tylko zawartość do wygenerowanego pliku, bez klucza.
+     */
+    noMetadata: false,
 
     /**
      * Prefiks klucza słownika
      */
-    dictionaryKeyPrefix: "", // Usuń prefiks bazowy
+    dictionaryKeyPrefix: "", // Remove base prefix
 
     /**
-     * Określa, czy komponenty powinny zostać zapisane po transformacji.
-     * W ten sposób kompilator można uruchomić tylko raz, aby przekształcić aplikację, a następnie można go usunąć.
+     * Wskazuje, czy komponenty powinny być zapisywane po transformacji.
+     * W ten sposób kompilator można uruchomić tylko raz, aby przetransformować aplikację, a następnie go usunąć.
      */
     saveComponents: false,
   },

package/docs/pl/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: Pierwsze wydanie
@@ -125,23 +128,28 @@ const config: IntlayerConfig = {
   },
   compiler: {
     /**
-     * Określa, czy kompilator powinien być włączony.
+     * Wskazuje, czy kompilator powinien być włączony.
      */
     enabled: true,
 
     /**
      * Katalog wyjściowy dla zoptymalizowanych słowników.
      */
-    outputDir: "compiler",
+    output: ({ locale, key }) => `compiler/${locale}/${key}.json`,
+
+    /**
+     * Wstaw tylko zawartość do wygenerowanego pliku, bez klucza.
+     */
+    noMetadata: false,
 
     /**
      * Prefiks klucza słownika
      */
-    dictionaryKeyPrefix: "", // Usuń prefiks bazowy
+    dictionaryKeyPrefix: "", // Remove base prefix
 
     /**
-     * Określa, czy komponenty powinny zostać zapisane po transformacji.
-     * W ten sposób kompilator można uruchomić tylko raz, aby przekształcić aplikację, a następnie można go usunąć.
+     * Wskazuje, czy komponenty powinny być zapisywane po transformacji.
+     * W ten sposób kompilator można uruchomić tylko raz, aby przetransformować aplikację, a następnie go usunąć.
      */
     saveComponents: false,
   },

package/docs/pl/per_locale_file.md

@@ -126,7 +126,7 @@ const config: IntlayerConfig = {
 export default config;
 ```
 
-Korzystając z tej konfiguracji, wszystkie pliki dla poszczególnych lokali będą generowane z domyślnym lokalem ustawionym na angielski. Obejmuje to również generowanie plików `.content` za pomocą polecenia `extract` oraz kompilatora. (Zobacz [Compiler](https://intlayer.org/doc/compiler) lub [Extract](https://intlayer.org/doc/concept/cli/extract), aby uzyskać więcej informacji.)
+Korzystając z tej konfiguracji, wszystkie pliki dla poszczególnych lokali będą generowane z domyślnym lokalem ustawionym na angielski. Obejmuje to również generowanie plików `.content` za pomocą polecenia `extract` oraz kompilatora. (Zobacz [Compiler](https://intlayer.org/doc/compiler) lub [Extract](https://github.com/aymericzip/intlayer/edit/main/docs/docs/en/cli/extract.md), aby uzyskać więcej informacji.)
 
 ## Format per-locale
 

package/docs/pt/compiler.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-09-09
-updatedAt: 2026-02-25
+updatedAt: 2026-03-10
 title: Intlayer Compiler | Extração Automática de Conteúdo para i18n
 description: Automatize seu processo de internacionalização com o Intlayer Compiler. Extraia conteúdo diretamente dos seus componentes para uma i18n mais rápida e eficiente em Vite, Next.js e mais.
 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: Atualizar opções do compilador
@@ -157,13 +160,12 @@ import { type IntlayerConfig, Locales } from "intlayer";
 const config: IntlayerConfig = {
   compiler: {
     /**
-     * Indica se o compilador deve ser ativado.
-     * Defina como 'build-only' para pular o compilador durante o desenvolvimento e acelerar os tempos de inicialização.
+     * Defina como 'build-only' para ignorar o compilador durante o desenvolvimento e acelerar os tempos de inicialização.
      */
     enabled: true,
 
     /**
-     * Padrão para percorrer o código a ser otimizado.
+     * Pattern to traverse the code to optimize.
      */
     transformPattern: [
       "**/*.{js,ts,mjs,cjs,jsx,tsx,vue,svelte}",
@@ -171,23 +173,28 @@ const config: IntlayerConfig = {
     ],
 
     /**
-     * Padrão para excluir da otimização.
+     * Pattern to exclude from the optimization.
      */
     excludePattern: ["**/node_modules/**"],
 
     /**
-     * Diretório de saída para os dicionários otimizados.
+     * Diretório de saída para os dicionários optimizados.
      */
-    outputDir: "i18n",
+    output: ({ locale, key }) => `compiler/${locale}/${key}.json`,
+
+    /**
+     * Inserir apenas o conteúdo no arquivo gerado, sem chave.
+     */
+    noMetadata: false,
 
     /**
      * Prefixo da chave do dicionário
      */
-    dictionaryKeyPrefix: "", // Remover prefixo base
+    dictionaryKeyPrefix: "", // Remove base prefix
 
     /**
      * Indica se os componentes devem ser salvos após serem transformados.
-     * Dessa forma, o compilador pode ser executado apenas uma vez para transformar o app e depois pode ser removido.
+     * Dessa forma, o compilador pode ser executado apenas uma vez para transformar o app e depois removido.
      */
     saveComponents: false,
   },
@@ -209,3 +216,61 @@ npx intlayer fill         # Preencher traduções ausentes
 ```
 
 > Para mais detalhes, consulte a [documentação da CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/cli/ci.md)
+
+### Referência de configuração do compilador
+
+As seguintes propriedades podem ser configuradas no bloco `compiler` do seu arquivo `intlayer.config.ts`:
+
+- **enabled**:
+  - _Tipo_: `boolean | 'build-only'`
+  - _Padrão_: `true`
+  - _Descrição_: Indica se o compilador deve ser habilitado.
+- **dictionaryKeyPrefix**:
+  - _Tipo_: `string`
+  - _Padrão_: `'comp-'`
+  - _Descrição_: Prefixo para as chaves de dicionário extraídas.
+- **transformPattern**:
+  - _Tipo_: `string | string[]`
+  - _Padrão_: `['**/*.{js,ts,mjs,cjs,jsx,tsx,vue,svelte}', '!**/node_modules/**']`
+  - _Descrição_: Padrões para percorrer o código a ser otimizado.
+- **excludePattern**:
+  - _Tipo_: `string | string[]`
+  - _Padrão_: `['**/node_modules/**']`
+  - _Descrição_: Padrões para excluir da otimização.
+- **outputDir** (Deprecated):
+  - _Tipo_: `string`
+  - _Padrão_: `'compiler'`
+  - _Descrição_: O diretório onde os dicionários extraídos serão armazenados.
+
+- **output**:
+  - _Tipo_: `FilePathPattern`
+  - _Padrão_: `({ key }) => 'compiler/${key}.content.json'`
+  - _Descrição_: Define o caminho dos arquivos de saída. Substitui `outputDir`. Manipula variáveis dinâmicas como `{{locale}}`, `{{key}}`, `{{fileName}}`, `{{extension}}`, `{{format}}`, `{{dirPath}}`, `{{componentFileName}}`, `{{componentExtension}}`, `{{componentFormat}}`. Pode ser definido como uma string usando o formato `'my/{{var}}/path'` ou como uma função.
+  - _Nota_: `./**/*` Os caminhos são resolvidos relativamente ao componente. `/**/*` os caminhos são resolvidos relativamente ao `baseDir` do Intlayer.
+  - _Exemplo_: `output: ({ locale, key }) => 'compiler/${locale}/${key}.json'`
+
+- **noMetadata**:
+  - _Tipo_: `boolean`
+  - _Padrão_: `false`
+  - _Descrição_: Indica se os metadados devem ser salvos no arquivo. Se verdadeiro, o compilador não salvará os metadados dos dicionários (chave, wrapper de conteúdo).
+  - _Nota_: Útil se usado com o plugin `loadJSON`.
+  - _Exemplo_: Se `true`:
+    ```json
+    {
+      "key": "value"
+    }
+    ```
+    Se `false`:
+    ```json
+    {
+      "key": "value",
+      "content": {
+        "key": "value"
+      }
+    }
+    ```
+
+- **saveComponents**:
+  - _Tipo_: `boolean`
+  - _Padrão_: `false`
+  - _Descrição_: Indica se os componentes devem ser salvos após serem transformados.

package/docs/pt/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-02-25
+updatedAt: 2026-03-10
 title: Configuração
 description: Aprenda como configurar o Intlayer para sua aplicação. Entenda as várias configurações e opções disponíveis para personalizar o Intlayer conforme suas necessidades.
 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: Atualizar opções do compilador
@@ -419,7 +422,7 @@ const config: IntlayerConfig = {
    */
   compiler: {
     /**
-     * Indicates if the compiler should be enabled.
+     * Indica se o compilador deve ser habilitado.
      */
     enabled: true,
 
@@ -437,18 +440,23 @@ const config: IntlayerConfig = {
     excludePattern: ["**/node_modules/**"],
 
     /**
-     * Output directory for the optimized dictionaries.
+     * Diretório de saída para os dicionários optimizados.
      */
-    outputDir: "compiler",
+    output: ({ locale, key }) => `compiler/${locale}/${key}.json`,
 
     /**
-     * Dictionary key prefix
+     * Inserir apenas o conteúdo no arquivo gerado, sem chave.
+     */
+    noMetadata: false,
+
+    /**
+     * Prefixo da chave do dicionário
      */
     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 os componentes devem ser salvos após serem transformados.
+     * Dessa forma, o compilador pode ser executado apenas uma vez para transformar o app e depois removido.
      */
     saveComponents: false,
   },
@@ -704,7 +712,7 @@ Configurações relacionadas ao manuseio de conteúdo dentro da aplicação, inc
 #### Propriedades
 
 - **autoFill**:
-  - _Tipo_: `boolean | string | { [key in Locales]?: string }`
+  - _Tipo_: `boolean | string | FilePathPattern | { [key in Locales]?: string }`
   - _Padrão_: `undefined`
   - _Descrição_: Indica como o conteúdo deve ser preenchido automaticamente usando IA. Pode ser declarado globalmente no arquivo `intlayer.config.ts`.
   - _Exemplo_: true
@@ -722,7 +730,7 @@ Configurações relacionadas ao manuseio de conteúdo dentro da aplicação, inc
 
 - **fileExtensions**:
   - _Tipo_: `string[]`
-  - _Default_: `['.content.ts', '.content.js', '.content.cjs', '.content.mjs', '.content.json', '.content.tsx', '.content.jsx']`
+  - _Padrão_: `['.content.ts', '.content.js', '.content.cjs', '.content.mjs', '.content.json', '.content.tsx', '.content.jsx']`
   - _Descrição_: Extensões de arquivo a serem procuradas ao construir dicionários.
   - _Exemplo_: `['.data.ts', '.data.js', '.data.json']`
   - _Nota_: Personalizar extensões de arquivo pode ajudar a evitar conflitos.
@@ -962,10 +970,10 @@ As opções de build se aplicam aos plugins `@intlayer/babel` e `@intlayer/swc`.
   - _Nota_: Pode ser usado para desabilitar a build de dicionários, por exemplo quando a execução em um ambiente Node.js deve ser evitada.
 
 - **checkTypes**:
-  - _Type_: `boolean`
-  - _Default_: `false`
-  - _Description_: Indica se a compilação deve verificar os tipos do TypeScript e registrar erros.
-  - _Note_: Isso pode atrasar a compilação.
+  - _Tipo_: `boolean`
+  - _Padrão_: `false`
+  - _Descrição_: Indica se a compilação deve verificar os tipos do TypeScript e registrar erros.
+  - _Nota_: Isso pode atrasar a compilação.
 
 - **optimize**:
   - _Tipo_: `boolean`
@@ -978,7 +986,7 @@ As opções de build se aplicam aos plugins `@intlayer/babel` e `@intlayer/swc`.
   - _Nota_: Certifique-se de que todas as chaves sejam declaradas estaticamente nas chamadas de `useIntlayer`. Exemplo: `useIntlayer('navbar')`.
 
 - **importMode**:
-  - _Note_: **Deprecated**: Use `dictionary.importMode` instead.
+  - _Nota_: **Deprecated**: Use `dictionary.importMode` instead.
   - _Tipo_: `'static' | 'dynamic' | 'fetch'`
   - _Padrão_: `'static'`
   - _Descrição_: Controla como os dicionários são importados.
@@ -1057,3 +1065,31 @@ Configurações que controlan o compilador Intlayer, que extrai dicionários dir
   - _Tipo_: `string`
   - _Padrão_: `'compiler'`
   - _Descrição_: O diretório onde os dicionários extraídos serão armazenados, relativo ao caminho base do seu projeto.
+
+- **output**:
+  - _Tipo_: `FilePathPattern`
+  - _Padrão_: `({ key }) => 'compiler/${key}.content.json'`
+  - _Descrição_: Define o caminho dos arquivos de saída. Substitui `outputDir`. Manipula variáveis dinâmicas como `{{locale}}`, `{{key}}`, `{{fileName}}`, `{{extension}}`, `{{format}}`, `{{dirPath}}`, `{{componentFileName}}`, `{{componentExtension}}`, `{{componentFormat}}`. Pode ser definido como uma string usando o formato `'my/{{var}}/path'` ou como uma função.
+  - _Nota_: `./**/*` Os caminhos são resolvidos relativamente ao componente. `/**/*` os caminhos são resolvidos relativamente ao `baseDir` do Intlayer.
+  - _Exemplo_: `output: ({ locale, key }) => 'compiler/${locale}/${key}.json'`
+
+- **noMetadata**:
+  - _Tipo_: `boolean`
+  - _Padrão_: `false`
+  - _Descrição_: Indica se os metadados devem ser salvos no arquivo. Se verdadeiro, o compilador não salvará os metadados dos dicionários (chave, wrapper de conteúdo).
+  - _Nota_: Útil se usado com o plugin `loadJSON`.
+  - _Exemplo_: Se `true`:
+    ```json
+    {
+      "key": "value"
+    }
+    ```
+    Se `false`:
+    ```json
+    {
+      "key": "value",
+      "content": {
+        "key": "value"
+      }
+    }
+    ```

package/docs/pt/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: Lançamento inicial
@@ -133,18 +136,23 @@ const config: IntlayerConfig = {
     enabled: true,
 
     /**
-     * Diretório de saída para os dicionários otimizados.
+     * Diretório de saída para os dicionários optimizados.
      */
-    outputDir: "compiler",
+    output: ({ locale, key }) => `compiler/${locale}/${key}.json`,
+
+    /**
+     * Inserir apenas o conteúdo no arquivo gerado, sem chave.
+     */
+    noMetadata: false,
 
     /**
      * Prefixo da chave do dicionário
      */
-    dictionaryKeyPrefix: "", // Remover prefixo base
+    dictionaryKeyPrefix: "", // Remove base prefix
 
     /**
      * Indica se os componentes devem ser salvos após serem transformados.
-     * Dessa forma, o compilador pode ser executado apenas uma vez para transformar o aplicativo e depois pode ser removido.
+     * Dessa forma, o compilador pode ser executado apenas uma vez para transformar o app e depois removido.
      */
     saveComponents: false,
   },