@intlayer/docs 8.2.4 → 8.3.0-canary.1

package/docs/ko/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-02-25
+updatedAt: 2026-03-11
 title: 구성
 description: 애플리케이션에 맞게 Intlayer를 구성하는 방법을 배우세요. Intlayer를 사용자 요구에 맞게 맞춤 설정할 수 있는 다양한 설정과 옵션을 이해하세요.
 keywords:
@@ -14,18 +14,24 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 8.3.0
+    data: 2026-03-11
+    changes: 'baseDir'을 'content' 구성에서 'system' 구성으로 이동
+  - version: 8.2.0
+    date: 2026-03-10
+    changes: 컴파일러 옵션 업데이트, 'output' 및 'noMetadata' 지원 추가
   - version: 8.1.7
     date: 2026-02-25
     changes: 컴파일러 옵션 업데이트
   - 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: Open Router, Alibaba, Amazon, Google Vertex Bedrock, Fireworks, Groq, Hugging Face, Together.ai 제공업체 지원 추가
   - version: 8.0.5
     date: 2026-02-06
     changes: AI 구성에 `dataSerialization` 추가
   - version: 8.0.0
     date: 2026-01-22
-    changes: Move `importMode` build configuration to `dictionary` configuration.
+    changes: importMode 빌드 구성을 사전 구성으로 이동.
   - version: 8.0.0
     date: 2026-01-18
     changes: 시스템 구성에서 콘텐츠 구성을 분리합니다. 내부 경로를 `system` 속성으로 이동합니다. 콘텐츠 파일과 코드 변환을 분리하기 위해 `codeDir`를 추가합니다.
@@ -422,7 +428,7 @@ const config: IntlayerConfig = {
    */
   compiler: {
     /**
-     * Indicates if the compiler should be enabled.
+     * 컴파일러 활성화 여부를 나타냅니다.
      */
     enabled: true,
 
@@ -440,18 +446,23 @@ const config: IntlayerConfig = {
     excludePattern: ["**/node_modules/**"],
 
     /**
-     * Output directory for the optimized dictionaries.
+     * 최적화된 사전의 출력 디렉터리.
      */
-    outputDir: "compiler",
+    output: ({ locale, key }) => `compiler/${locale}/${key}.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.
+     * 변환된 후 구성 요소를 저장할지 여부를 나타냅니다.
+     * 이렇게 하면 컴파일러를 한 번만 실행하여 앱을 변환한 다음 제거할 수 있습니다.
      */
     saveComponents: false,
   },
@@ -707,7 +718,7 @@ export default config;
 #### 속성
 
 - **autoFill**:
-  - _유형_: `boolean | string | { [key in Locales]?: string }`
+  - _유형_: `boolean | string | FilePathPattern | { [key in Locales]?: string }`
   - _기본값_: `undefined`
   - _설명_: AI를 사용하여 콘텐츠를 자동으로 채우는 방식을 지정합니다. `intlayer.config.ts` 파일에서 전역으로 선언할 수 있습니다.
   - _예시_: true
@@ -730,13 +741,6 @@ export default config;
   - _예시_: `['.data.ts', '.data.js', '.data.json']`
   - _참고_: 파일 확장자를 사용자 정의하면 충돌을 방지할 수 있습니다.
 
-- **baseDir**:
-  - _유형_: `string`
-  - _기본값_: `process.cwd()`
-  - _설명_: 프로젝트의 기본 디렉토리입니다.
-  - _예시_: `'/path/to/project'`
-  - _참고_: 모든 Intlayer 관련 디렉토리를 해석하는 데 사용됩니다.
-
 - **dictionaryOutput**:
   - _유형_: `string[]`
   - _기본값_: `['intlayer']`
@@ -805,6 +809,21 @@ export default config;
   - _설명_: 콘텐츠 검색에서 제외할 디렉토리 목록입니다.
   - _참고_: 이 설정은 아직 사용되지 않았으며, 향후 구현될 예정입니다.
 
+---
+
+### 시스템 구성
+
+Intlayer의 내부 경로 및 출력 결과와 관련된 설정입니다. 이러한 설정은 일반적으로 내부적이며 사용자가 수정할 필요가 없습니다.
+
+#### 속성
+
+- **baseDir**:
+  - _유형_: `string`
+  - _기본값_: `process.cwd()`
+  - _설명_: 프로젝트의 기본 디렉토리입니다.
+  - _예시_: `'/path/to/project'`
+  - _참고_: 모든 Intlayer 관련 디렉토리를 해석하는 데 사용됩니다.
+
 ### 사전 구성
 
 자동 채우기 동작 및 콘텐츠 생성을 포함하여 사전 작업을 제어하는 설정입니다.
@@ -850,7 +869,7 @@ export default config;
   - _기본값_: `'[intlayer] '`
   - _설명_: 로거의 접두사입니다.
   - _예시_: `'[my custom prefix] '`
-  - _Note_: 로거의 접두사입니다.
+  - _참고_: 로거의 접두사입니다.
 
 ### AI 구성
 
@@ -953,10 +972,10 @@ Intlayer가 애플리케이션의 국제화를 최적화하고 빌드하는 방
   - _참고_: 사전 빌드를 비활성화하는 데 사용할 수 있습니다. 예를 들어 Node.js 환경에서 실행을 피해야 하는 경우입니다.
 
 - **checkTypes**:
-  - _Type_: `boolean`
-  - _Default_: `false`
-  - _Description_: 빌드가 TypeScript 유형을 확인하고 오류를 기록해야 하는지 여부를 나타냅니다.
-  - _Note_: 이로 인해 빌드 속도가 느려질 수 있습니다.
+  - _형식_: `boolean`
+  - _기본값_: `false`
+  - _설명_: 빌드가 TypeScript 유형을 확인하고 오류를 기록해야 하는지 여부를 나타냅니다.
+  - _참고_: 이로 인해 빌드 속도가 느려질 수 있습니다.
 
 - **optimize**:
   - _타입_: `boolean`
@@ -969,7 +988,7 @@ Intlayer가 애플리케이션의 국제화를 최적화하고 빌드하는 방
   - _참고_: `useIntlayer` 호출에서 모든 키가 정적으로 선언되어 있는지 확인하세요. 예: `useIntlayer('navbar')`.
 
 - **importMode**:
-  - _Note_: **Deprecated**: Use `dictionary.importMode` instead.
+  - _참고_: **Deprecated**: Use `dictionary.importMode` instead.
   - _유형_: `'static' | 'dynamic' | 'fetch'`
   - _기본값_: `'static'`
   - _설명_: 사전을 어떻게 가져올지 제어합니다.
@@ -1048,3 +1067,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`
+  - _설명_: 메타데이터를 파일에 저장할지 여부를 나타냅니다. true인 경우 컴파일러는 사전의 메타데이터(키, 콘텐츠 래퍼)를 저장하지 않습니다.
+  - _참고_: `loadJSON` 플러그인과 함께 사용할 때 유용합니다.
+  - _예시_: `true`인 경우:
+    ```json
+    {
+      "key": "value"
+    }
+    ```
+    `false`인 경우:
+    ```json
+    {
+      "key": "value",
+      "content": {
+        "key": "value"
+      }
+    }
+    ```

package/docs/ko/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: 최초 릴리스
@@ -127,9 +130,25 @@ const config: IntlayerConfig = {
     mode: "search-params",
   },
   compiler: {
-    enabled: true, // dev 모드 영향을 줄이려면 '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/ko/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/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

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-02-25
+updatedAt: 2026-03-11
 title: Konfiguracja
 description: Dowiedz się, jak skonfigurować Intlayer dla swojej aplikacji. Zrozum różne ustawienia i opcje dostępne do dostosowania Intlayer do Twoich potrzeb.
 keywords:
@@ -14,18 +14,24 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 8.3.0
+    data: 2026-03-11
+    changes: Przenieś 'baseDir' z konfiguracji 'content' do konfiguracji 'system'
+  - version: 8.2.0
+    date: 2026-03-09
+    changes: Zaktualizuj opcje kompilatora, dodaj obsługę 'output' i 'noMetadata'
   - version: 8.1.7
     date: 2026-02-25
     changes: Aktualizacja opcji kompilatora
   - 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: Dodaj obsługę dostawców Open Router, Alibaba, Amazon, Google Vertex Bedrock, Fireworks, Groq, Hugging Face i Together.ai
   - version: 8.0.5
     date: 2026-02-06
     changes: Dodano `dataSerialization` do konfiguracji AI
   - version: 8.0.0
     date: 2026-01-22
-    changes: Move `importMode` build configuration to `dictionary` configuration.
+    changes: Przenieś konfigurację budowania importMode do konfiguracji słownika.
   - version: 8.0.0
     date: 2026-01-18
     changes: Oddziel konfigurację systemu od konfiguracji treści. Przenieś wewnętrzne ścieżki do właściwości `system`. Dodaj `codeDir`, aby oddzielić pliki treści od transformacji kodu.
@@ -434,7 +440,7 @@ const config: IntlayerConfig = {
    */
   compiler: {
     /**
-     * Indicates if the compiler should be enabled.
+     * Wskazuje, czy kompilator powinien być włączony.
      */
     enabled: true,
 
@@ -452,18 +458,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,
   },
@@ -839,13 +850,6 @@ Ustawienia związane z obsługą treści w aplikacji, w tym nazwy katalogów, ro
   - _Przykład_: `['.data.ts', '.data.js', '.data.json']`
   - _Uwaga_: Dostosowanie rozszerzeń plików może pomóc uniknąć konfliktów.
 
-- **baseDir**:
-  - _Typ_: `string`
-  - _Domyślnie_: `process.cwd()`
-  - _Opis_: Katalog bazowy projektu.
-  - _Przykład_: `'/path/to/project'`
-  - _Uwaga_: Jest używany do rozwiązywania wszystkich katalogów związanych z Intlayer.
-
 - **contentDir**:
   - _Typ_: `string[]`
   - _Domyślnie_: `['.']`
@@ -860,10 +864,26 @@ Ustawienia związane z obsługą treści w aplikacji, w tym nazwy katalogów, ro
   - _Opis_: Ścieżka katalogu, w którym przechowywany jest kod, względem katalogu bazowego.
   - _Uwaga_: Jest używany do monitorowania plików kodu w celu transformacji (przycinanie, optymalizacja). Utrzymanie tego oddzielnie od `contentDir` może poprawić wydajność kompilacji, unikając niepotrzebnego skanowania plików treści.
 
+---
+
+### Konfiguracja systemu
+
+Ustawienia związane z wewnętrznymi ścieżkami oraz wynikami wyjściowymi Intlayer. Te ustawienia są zazwyczaj wewnętrzne i nie powinny być modyfikowane przez użytkownika.
+
+#### Właściwości
+
+- **baseDir**:
+  - _Typ_: `string`
+  - _Domyślnie_: `process.cwd()`
+  - _Opis_: Katalog bazowy projektu.
+  - _Przykład_: `'/path/to/project'`
+  - _Uwaga_: Jest używany do rozwiązywania wszystkich katalogów związanych z Intlayer.
+
 - **dictionariesDir**:
   - _Typ_: `string`
-  - _Domyślnie_: `'.intlayer/dictionaries'`
-  - _Opis_: Ścieżka katalogu do przechowywania wyników pośrednich lub wyjściowych.
+  - _Domyślnie_: `'.intlayer/dictionary'`
+  - _Opis_: Ścieżka katalogu do przechowywania słowników lokalizacyjnych.
+  - _Przykład_: `'translations'`
 
 - **moduleAugmentationDir**:
   - _Typ_: `string`
@@ -878,12 +898,6 @@ Ustawienia związane z obsługą treści w aplikacji, w tym nazwy katalogów, ro
   - _Opis_: Katalog do przechowywania niepołączonych słowników.
   - _Przykład_: `'translations'`
 
-- **dictionariesDir**:
-  - _Typ_: `string`
-  - _Domyślnie_: `'.intlayer/dictionary'`
-  - _Opis_: Katalog do przechowywania słowników lokalizacyjnych.
-  - _Przykład_: `'translations'`
-
 - **typesDir**:
   - _Typ_: `string`
   - _Domyślnie_: `'types'`
@@ -1070,7 +1084,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 +1102,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 +1168,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,
   },