@intlayer/docs 8.2.4 → 8.3.0-canary.0

package/docs/ja/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-02-25
+updatedAt: 2026-03-10
 title: 設定
 description: Intlayerをアプリケーション向けに設定する方法を学びます。Intlayerをニーズに合わせてカスタマイズするためのさまざまな設定やオプションについて理解しましょう。
 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: コンパイラーオプションの更新
@@ -422,7 +425,7 @@ const config: IntlayerConfig = {
    */
   compiler: {
     /**
-     * Indicates if the compiler should be enabled.
+     * コンパイラを有効にするかどうかを示します。
      */
     enabled: true,
 
@@ -440,18 +443,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.
+     * 変換後にコンポーネントを保存するかどうかを示します。
+     * これにより、コンパイラを1回だけ実行してアプリを変換し、その後削除することができます。
      */
     saveComponents: false,
   },
@@ -707,7 +715,7 @@ export default config;
 #### プロパティ
 
 - **autoFill**:
-  - _型_: `boolean | string | { [key in Locales]?: string }`
+  - _型_: `boolean | string | FilePathPattern | { [key in Locales]?: string }`
   - _デフォルト_: `undefined`
   - _説明_: コンテンツをAIを使って自動的にどのように埋めるかを示します。`intlayer.config.ts`ファイルでグローバルに宣言することができます。
   - _例_: true
@@ -850,7 +858,7 @@ export default config;
   - _デフォルト_: `'[intlayer] '`
   - _説明_: ロガーのプレフィックス。
   - _例_: `'[my custom prefix] '`
-  - _Note_: ロガーのプレフィックス。
+  - _注_: ロガーのプレフィックス。
 
 ### AI構成
 
@@ -953,10 +961,10 @@ Intlayerがアプリケーションの国際化をどのように最適化しビ
   - _注意_: 辞書のビルドを無効にするために使用できます。たとえば、Node.js環境での実行を避ける必要がある場合などです。
 
 - **checkTypes**:
-  - _Type_: `boolean`
-  - _Default_: `false`
-  - _Description_: ビルドがTypeScriptの型をチェックし、エラーをログに記録するかどうかを示します。
-  - _Note_: これにより、ビルドが遅くなる可能性があります。
+  - _タイプ_: `boolean`
+  - _デフォルト_: `false`
+  - _説明_: ビルドがTypeScriptの型をチェックし、エラーをログに記録するかどうかを示します。
+  - _注_: これにより、ビルドが遅くなる可能性があります。
 
 - **optimize**:
   - _型_: `boolean`
@@ -969,7 +977,7 @@ Intlayerがアプリケーションの国際化をどのように最適化しビ
   - _注意_: `useIntlayer`の呼び出し内で、すべてのキーが静的に宣言されていることを確認してください。例: `useIntlayer('navbar')`。
 
 - **importMode**:
-  - _Note_: **Deprecated**: Use `dictionary.importMode` instead.
+  - _注_: **Deprecated**: Use `dictionary.importMode` instead.
   - _タイプ_: `'static' | 'dynamic' | 'fetch'`
   - _デフォルト_: `'static'`
   - _説明_: 辞書のインポート方法を制御します。
@@ -1048,3 +1056,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/ja/intlayer_with_nextjs_compiler.md

@@ -20,6 +20,9 @@ slugs:
 applicationTemplate: https://github.com/aymericzip/intlayer-next-no-lolale-path-template
 youtubeVideo: https://www.youtube.com/watch?v=e_PPG7PTqGU
 history:
+  - version: 8.2.0
+    date: 2026-03-09
+    changes: Update compiler options, add FilePathPattern support
   - version: 8.1.6
     date: 2026-02-23
     changes: 初期リリース
@@ -128,23 +131,28 @@ const config: IntlayerConfig = {
   },
   compiler: {
     /**
-     * コンパイラを有効にするかどうかを指定します。
+     * コンパイラを有効にするかどうかを示します。
      */
     enabled: true,
 
     /**
      * 最適化された辞書の出力ディレクトリ。
      */
-    outputDir: "compiler",
+    output: ({ locale, key }) => `compiler/${locale}/${key}.json`,
+
+    /**
+     * キーなしで、生成されたファイルにコンテンツのみを挿入します。
+     */
+    noMetadata: false,
 
     /**
      * 辞書キーのプレフィックス
      */
-    dictionaryKeyPrefix: "", // ベースプレフィックスを削除
+    dictionaryKeyPrefix: "", // Remove base prefix
 
     /**
-     * 変換後にコンポーネントを保存するかどうかを指定します。
-     * これにより、コンパイラを 1 回実行してアプリを変換し、その後コンパイラを削除できるようになります。
+     * 変換後にコンポーネントを保存するかどうかを示します。
+     * これにより、コンパイラを1回だけ実行してアプリを変換し、その後削除することができます。
      */
     saveComponents: false,
   },

package/docs/ja/intlayer_with_vite+react_compiler.md

@@ -19,6 +19,9 @@ slugs:
 applicationTemplate: https://github.com/aymericzip/intlayer-vite-react-template
 youtubeVideo: https://www.youtube.com/watch?v=dS9L7uJeak4
 history:
+  - version: 8.2.0
+    date: 2026-03-09
+    changes: Update compiler options, add FilePathPattern support
   - version: 8.1.6
     date: 2026-02-23
     changes: 初回リリース
@@ -125,23 +128,28 @@ const config: IntlayerConfig = {
   },
   compiler: {
     /**
-     * コンパイラを有効にするかどうかを指定します。
+     * コンパイラを有効にするかどうかを示します。
      */
     enabled: true,
 
     /**
      * 最適化された辞書の出力ディレクトリ。
      */
-    outputDir: "compiler",
+    output: ({ locale, key }) => `compiler/${locale}/${key}.json`,
+
+    /**
+     * キーなしで、生成されたファイルにコンテンツのみを挿入します。
+     */
+    noMetadata: false,
 
     /**
      * 辞書キーのプレフィックス
      */
-    dictionaryKeyPrefix: "", // ベースプレフィックスを削除
+    dictionaryKeyPrefix: "", // Remove base prefix
 
     /**
-     * 変換後にコンポーネントを保存するかどうかを指定します。
-     * これにより、コンパイラを 1 回実行してアプリを変換し、その後コンパイラを削除できるようになります。
+     * 変換後にコンポーネントを保存するかどうかを示します。
+     * これにより、コンパイラを1回だけ実行してアプリを変換し、その後削除することができます。
      */
     saveComponents: false,
   },

package/docs/ko/compiler.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-09-09
-updatedAt: 2026-02-25
+updatedAt: 2026-03-10
 title: Intlayer 컴파일러 | i18n을 위한 자동화된 콘텐츠 추출
 description: Intlayer 컴파일러로 국제화 프로세스를 자동화하세요. Vite, Next.js 등에서 더 빠르고 효율적인 i18n을 위해 컴포넌트에서 직접 콘텐츠를 추출합니다.
 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: 컴파일러 옵션 업데이트
@@ -157,13 +160,12 @@ import { type IntlayerConfig, Locales } from "intlayer";
 const config: IntlayerConfig = {
   compiler: {
     /**
-     * 컴파일러를 활성화할지 여부를 나타냅니다.
-     * 개발 중에 컴파일러를 건너뛰고 시작 시간을 단축하려면 'build-only'로 설정하세요.
+     * 개발 중에 컴파일러를 건너뛰고 시작 시간을 단축하려면 'build-only'로 설정하십시오.
      */
     enabled: true,
 
     /**
-     * 최적화할 코드를 순회하는 패턴.
+     * Pattern to traverse the code to optimize.
      */
     transformPattern: [
       "**/*.{js,ts,mjs,cjs,jsx,tsx,vue,svelte}",
@@ -171,23 +173,28 @@ const config: IntlayerConfig = {
     ],
 
     /**
-     * 최적화에서 제외할 패턴.
+     * Pattern to exclude from the optimization.
      */
     excludePattern: ["**/node_modules/**"],
 
     /**
-     * 최적화된 사전의 출력 디렉토리.
+     * 최적화된 사전의 출력 디렉터리.
      */
-    outputDir: "i18n",
+    output: ({ locale, key }) => `compiler/${locale}/${key}.json`,
+
+    /**
+     * 키 없이 생성된 파일에 콘텐츠만 삽입합니다.
+     */
+    noMetadata: false,
 
     /**
      * 사전 키 접두사
      */
-    dictionaryKeyPrefix: "", // 기본 접두사 제거
+    dictionaryKeyPrefix: "", // Remove base prefix
 
     /**
-     * 컴포넌트가 변환된 후 저장되어야 하는지 여부를 나타냅니다.
-     * 그렇게 하면 컴파일러를 한 번만 실행하여 앱을 변환한 다음 나중에 제거할 수 있습니다.
+     * 변환된 후 구성 요소를 저장할지 여부를 나타냅니다.
+     * 이렇게 하면 컴파일러를 한 번만 실행하여 앱을 변환한 다음 제거할 수 있습니다.
      */
     saveComponents: false,
   },
@@ -209,3 +216,61 @@ npx intlayer fill         # 누락된 번역 채우기
 ```
 
 > 자세한 내용은 [CLI 문서](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/ci.md)를 참조하세요.
+
+### 컴파일러 구성 참조
+
+다음 속성은 `intlayer.config.ts` 파일의 `compiler` 블록에서 구성할 수 있습니다.
+
+- **enabled**:
+  - _형식_: `boolean | 'build-only'`
+  - _기본값_: `true`
+  - _설명_: 컴파일러 활성화 여부를 나타냅니다.
+- **dictionaryKeyPrefix**:
+  - _형식_: `string`
+  - _기본값_: `'comp-'`
+  - _설명_: 추출된 사전 키의 접두사.
+- **transformPattern**:
+  - _형식_: `string | string[]`
+  - _기본값_: `['**/*.{js,ts,mjs,cjs,jsx,tsx,vue,svelte}', '!**/node_modules/**']`
+  - _설명_: 최적화할 코드를 탐색하는 패턴.
+- **excludePattern**:
+  - _형식_: `string | string[]`
+  - _기본값_: `['**/node_modules/**']`
+  - _설명_: 최적화에서 제외할 패턴.
+- **outputDir** (Deprecated):
+  - _형식_: `string`
+  - _기본값_: `'compiler'`
+  - _설명_: 추출된 사전이 저장될 디렉터리.
+
+- **output**:
+  - _형식_: `FilePathPattern`
+  - _기본값_: `({ key }) => 'compiler/${key}.content.json'`
+  - _설명_: 출력 파일 경로를 정의합니다. `outputDir`을 대체합니다. `{{locale}}`, `{{key}}`, `{{fileName}}`, `{{extension}}`, `{{format}}`, `{{dirPath}}`, `{{componentFileName}}`, `{{componentExtension}}`, `{{componentFormat}}`와 같은 동적 변수를 처리합니다. `'my/{{var}}/path'` 형식을 사용하여 문자열로 설정하거나 함수로 설정할 수 있습니다.
+  - _참고_: `./**/*` 경로는 구성 요소를 기준으로 해결됩니다. `/**/*` 경로는 Intlayer `baseDir`을 기준으로 해결됩니다.
+  - _예시_: `output: ({ locale, key }) => 'compiler/${locale}/${key}.json'`
+
+- **noMetadata**:
+  - _형식_: `boolean`
+  - _기본값_: `false`
+  - _설명_: 메타데이터를 파일에 저장할지 여부를 나타냅니다. true인 경우 컴파일러는 사전의 메타데이터(키, 콘텐츠 래퍼)를 저장하지 않습니다.
+  - _참고_: `loadJSON` 플러그인과 함께 사용할 때 유용합니다.
+  - _예시_: `true`인 경우:
+    ```json
+    {
+      "key": "value"
+    }
+    ```
+    `false`인 경우:
+    ```json
+    {
+      "key": "value",
+      "content": {
+        "key": "value"
+      }
+    }
+    ```
+
+- **saveComponents**:
+  - _형식_: `boolean`
+  - _기본값_: `false`
+  - _설명_: 변환된 후 구성 요소를 저장할지 여부를 나타냅니다.

package/docs/ko/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-02-25
+updatedAt: 2026-03-10
 title: 구성
 description: 애플리케이션에 맞게 Intlayer를 구성하는 방법을 배우세요. Intlayer를 사용자 요구에 맞게 맞춤 설정할 수 있는 다양한 설정과 옵션을 이해하세요.
 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: 컴파일러 옵션 업데이트
@@ -422,7 +425,7 @@ const config: IntlayerConfig = {
    */
   compiler: {
     /**
-     * Indicates if the compiler should be enabled.
+     * 컴파일러 활성화 여부를 나타냅니다.
      */
     enabled: true,
 
@@ -440,18 +443,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 +715,7 @@ export default config;
 #### 속성
 
 - **autoFill**:
-  - _유형_: `boolean | string | { [key in Locales]?: string }`
+  - _유형_: `boolean | string | FilePathPattern | { [key in Locales]?: string }`
   - _기본값_: `undefined`
   - _설명_: AI를 사용하여 콘텐츠를 자동으로 채우는 방식을 지정합니다. `intlayer.config.ts` 파일에서 전역으로 선언할 수 있습니다.
   - _예시_: true
@@ -850,7 +858,7 @@ export default config;
   - _기본값_: `'[intlayer] '`
   - _설명_: 로거의 접두사입니다.
   - _예시_: `'[my custom prefix] '`
-  - _Note_: 로거의 접두사입니다.
+  - _참고_: 로거의 접두사입니다.
 
 ### AI 구성
 
@@ -953,10 +961,10 @@ Intlayer가 애플리케이션의 국제화를 최적화하고 빌드하는 방
   - _참고_: 사전 빌드를 비활성화하는 데 사용할 수 있습니다. 예를 들어 Node.js 환경에서 실행을 피해야 하는 경우입니다.
 
 - **checkTypes**:
-  - _Type_: `boolean`
-  - _Default_: `false`
-  - _Description_: 빌드가 TypeScript 유형을 확인하고 오류를 기록해야 하는지 여부를 나타냅니다.
-  - _Note_: 이로 인해 빌드 속도가 느려질 수 있습니다.
+  - _형식_: `boolean`
+  - _기본값_: `false`
+  - _설명_: 빌드가 TypeScript 유형을 확인하고 오류를 기록해야 하는지 여부를 나타냅니다.
+  - _참고_: 이로 인해 빌드 속도가 느려질 수 있습니다.
 
 - **optimize**:
   - _타입_: `boolean`
@@ -969,7 +977,7 @@ Intlayer가 애플리케이션의 국제화를 최적화하고 빌드하는 방
   - _참고_: `useIntlayer` 호출에서 모든 키가 정적으로 선언되어 있는지 확인하세요. 예: `useIntlayer('navbar')`.
 
 - **importMode**:
-  - _Note_: **Deprecated**: Use `dictionary.importMode` instead.
+  - _참고_: **Deprecated**: Use `dictionary.importMode` instead.
   - _유형_: `'static' | 'dynamic' | 'fetch'`
   - _기본값_: `'static'`
   - _설명_: 사전을 어떻게 가져올지 제어합니다.
@@ -1048,3 +1056,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_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",