@intlayer/docs 8.3.0-canary.4 → 8.3.1

package/docs/it/intlayer_with_vite+vue.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-04-18
-updatedAt: 2025-12-30
+updatedAt: 2026-03-12
 title: Vite + Vue i18n - Come tradurre un'app Vue nel 2026
 description: Scopri come rendere il tuo sito Vite e Vue multilingue. Segui la documentazione per internazionalizzare (i18n) e tradurlo.
 keywords:
@@ -1124,6 +1124,162 @@ Per maggiori dettagli su come utilizzare l’estensione, consulta la [documentaz
 
 ---
 
+### (Opzionale) Passaggio 1 : Estrarre il contenuto dei tuoi componenti
+
+Se hai una base di codice esistente, trasformare migliaia di file può richiedere molto tempo.
+
+Per facilitare questo processo, Intlayer propone un [compilatore](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/compiler.md) / [estrattore](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/cli/extract.md) per trasformare i tuoi componenti ed estrarre il contenuto.
+
+Per configurarlo, puoi aggiungere una sezione `compiler` nel tuo file `intlayer.config.ts`:
+
+```typescript fileName="intlayer.config.ts" codeFormat="typescript"
+import { type IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  // ... Resto della tua configurazione
+  compiler: {
+    /**
+     * Indica se il compilatore deve essere abilitato.
+     */
+    enabled: true,
+
+    /**
+     * Definisce il percorso dei file di output
+     */
+    output: ({ fileName, extension }) => `./${fileName}${extension}`,
+
+    /**
+     * Indica se i componenti devono essere salvati dopo essere stati trasformati. In questo modo, il compilatore può essere eseguito solo una volta per trasformare l'app e poi rimosso.
+     */
+    saveComponents: false,
+
+    /**
+     * Prefisso chiave dizionario
+     */
+    dictionaryKeyPrefix: "",
+  },
+};
+
+export default config;
+```
+
+```javascript fileName="intlayer.config.mjs" codeFormat="esm"
+/** @type {import('intlayer').IntlayerConfig} */
+const config = {
+  // ... Resto della tua configurazione
+  compiler: {
+    /**
+     * Indica se il compilatore deve essere abilitato.
+     */
+    enabled: true,
+
+    /**
+     * Definisce il percorso dei file di output
+     */
+    output: ({ fileName, extension }) => `./${fileName}${extension}`,
+
+    /**
+     * Indica se i componenti devono essere salvati dopo essere stati trasformati. In questo modo, il compilatore può essere eseguito solo una volta per trasformare l'app e poi rimosso.
+     */
+    saveComponents: false,
+
+    /**
+     * Prefisso chiave dizionario
+     */
+    dictionaryKeyPrefix: "",
+  },
+};
+
+export default config;
+```
+
+```javascript fileName="intlayer.config.cjs" codeFormat="commonjs"
+/** @type {import('intlayer').IntlayerConfig} */
+const config = {
+  // ... Resto della tua configurazione
+  compiler: {
+    /**
+     * Indica se il compilatore deve essere abilitato.
+     */
+    enabled: true,
+
+    /**
+     * Definisce il percorso dei file di output
+     */
+    output: ({ fileName, extension }) => `./${fileName}${extension}`,
+
+    /**
+     * Indica se i componenti devono essere salvati dopo essere stati trasformati. In questo modo, il compilatore può essere eseguito solo una volta per trasformare l'app e poi rimosso.
+     */
+    saveComponents: false,
+
+    /**
+     * Prefisso chiave dizionario
+     */
+    dictionaryKeyPrefix: "",
+  },
+};
+
+module.exports = config;
+```
+
+<Tabs>
+ <Tab value='Comando di estrazione'>
+
+Esegui l'estrattore per trasformare i tuoi componenti ed estrarre il contenuto
+
+```bash packageManager="npm"
+npx intlayer extract
+```
+
+```bash packageManager="pnpm"
+pnpm intlayer extract
+```
+
+```bash packageManager="yarn"
+yarn intlayer extract
+```
+
+```bash packageManager="bun"
+bunx intlayer extract
+```
+
+ </Tab>
+ <Tab value='Compilatore Babel'>
+
+Aggiorna il tuo `vite.config.ts` per includere il plugin `intlayerCompiler`:
+
+```ts fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import { intlayer, intlayerCompiler } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [
+    intlayer(),
+    intlayerCompiler(), // Aggiunge il plugin del compilatore
+  ],
+});
+```
+
+```bash packageManager="npm"
+npm run build # Oppure npm run dev
+```
+
+```bash packageManager="pnpm"
+pnpm run build # O pnpm run dev
+```
+
+```bash packageManager="yarn"
+yarn build # O yarn dev
+```
+
+```bash packageManager="bun"
+bun run build # Or bun run dev
+```
+
+ </Tab>
+</Tabs>
+
 ### Approfondimenti
 
 Per approfondire, puoi implementare l’[editor visuale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_visual_editor.md) oppure esternalizzare i tuoi contenuti utilizzando il [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_CMS.md).

package/docs/ja/compiler.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-09-09
-updatedAt: 2026-03-10
+updatedAt: 2026-03-12
 title: Intlayer コンパイラー | i18n のための自動コンテンツ抽出
 description: Intlayer コンパイラーで国際化プロセスを自動化しましょう。コンポーネントから直接コンテンツを抽出し、Vite、Next.js などでより高速かつ効率的な i18n を実現します。
 keywords:
@@ -21,8 +21,8 @@ slugs:
   - compiler
 history:
   - version: 8.2.0
-    date: 2026-03-10
-    changes: Update compiler options, add FilePathPattern support
+    date: 2026-03-09
+    changes: コンパイラーオプションの更新、FilePathPattern のサポート追加
   - version: 8.1.7
     date: 2026-02-25
     changes: コンパイラーオプションの更新
@@ -64,7 +64,7 @@ history:
 
 ### Vite
 
-Viteベースのアプリケーション（React、Vue、Svelteなど）では、`vite-intlayer` プラグインを使うのが最も簡単な方法です。
+Viteベースのアプリケーション（React, Vue, Svelteなど）では、`vite-intlayer` プラグインを使うのが最も簡単な方法です。
 
 #### インストール
 
@@ -83,7 +83,7 @@ import { intlayer, intlayerCompiler } from "vite-intlayer";
 export default defineConfig({
   plugins: [
     intlayer(),
-    intlayerCompiler(), // コンパイラプラグインを追加
+    intlayerCompiler(), // コンパイラープラグインを追加
   ],
 });
 ```
@@ -98,7 +98,7 @@ Viteプラグインは自動的に異なるファイルタイプを検出し処
 - **Vue**: `@intlayer/vue-compiler` が必要です。
 - **Svelte**: `@intlayer/svelte-compiler` が必要です。
 
-使用しているフレームワークに応じて、適切なコンパイラパッケージをインストールしてください：
+使用しているフレームワークに応じて、適切なコンパイラーパッケージをインストールしてください：
 
 ```bash
 # Vue用
@@ -113,7 +113,7 @@ npm install @intlayer/svelte-compiler
 
 ### Next.js (Babel)
 
-Next.jsやその他のWebpackベースのBabelを使用するアプリケーションでは、`@intlayer/babel`プラグインを使ってコンパイラを設定できます。
+Next.jsやその他の Webpack ベースの Babel を使用するアプリケーションでは、`@intlayer/babel`プラグインを使ってコンパイラーを設定できます。
 
 #### インストール
 
@@ -136,9 +136,9 @@ const {
 module.exports = {
   presets: ["next/babel"],
   plugins: [
-    // Extract content from components into dictionaries
+    // コンポーネントからコンテンツを抽出して辞書に変換
     [intlayerExtractBabelPlugin, getExtractPluginOptions()],
-    // Optimize imports by replacing useIntlayer with direct dictionary imports
+    // useIntlayer を直接辞書インポートに置き換えてインポートを最適化
     [intlayerOptimizeBabelPlugin, getOptimizePluginOptions()],
   ],
 };
@@ -149,112 +149,125 @@ module.exports = {
 See complete tutorial: [Intlayer Compiler with Next.js](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_nextjs_compiler.md)
 
  </Tab>
+</Tabs>
 
 ### カスタム設定
 
-コンパイラの動作をカスタマイズするには、プロジェクトのルートにある `intlayer.config.ts` ファイルを更新します。
+コンパイラーの動作をカスタマイズするには、プロジェクトのルートにある `intlayer.config.ts` ファイルを更新します。
 
-```ts fileName="intlayer.config.ts"
+````ts fileName="intlayer.config.ts"
 import { type IntlayerConfig, Locales } from "intlayer";
 
 const config: IntlayerConfig = {
   compiler: {
     /**
-     * 開発中のコンパイラをスキップして起動時間を短縮するには、'build-only'に設定します。
+     * コンパイラーを有効にするかどうかを示します。
+     * 開発中のコンパイラーをスキップして起動時間を短縮するには、'build-only'に設定します。
      */
     enabled: true,
 
     /**
-     * Pattern to traverse the code to optimize.
+     * 出力ファイルのパスを定義します。 `outputDir` を置き換えます。
+     *
+     * - `./` で始まるパスは、コンポーネントディレクトリを基準に解決されます。
+     * - `/` で始まるパスは、プロジェクトのルート (`baseDir`) を基準に解決されます。
+     *
+     * - パスに `{{locale}}` 変数を含めると、言語ごとに分離された辞書の生成が有効になります。
+     *
+     * 例:
+     * ```ts
+     * {
+     *   // コンポーネントの隣に多言語対応の .content.ts ファイルを作成
+     *   output: ({ fileName, extension }) => `./${fileName}${extension}`,
+     *
+     *   // output: './{{fileName}}{{extension}}', // 文字列テンプレートを使用した同等の記述
+     * }
+     * ```
+     *
+     * ```ts
+     * {
+     *   // プロジェクトのルートに言語ごとに集約された JSON ファイルを作成
+     *   output: ({ key, locale }) => `/locales/${locale}/${key}.content.json`,
+     *
+     *   // output: '/locales/{{locale}}/{{key}}.content.json', // 文字列テンプレートを使用した同等の記述
+     * }
+     * ```
+     *
+     * 変数リスト:
+     *   - `fileName`: ファイル名。
+     *   - `key`: コンテンツのキー。
+     *   - `locale`: コンテンツのロケール。
+     *   - `extension`: ファイル拡張子。
+     *   - `componentFileName`: コンポーネントファイル名。
+     *   - `componentExtension`: コンポーネント拡張子。
+     *   - `format`: 辞書の形式。
+     *   - `componentFormat`: コンポーネント辞書の形式。
+     *   - `componentDirPath`: コンポーネントのディレクトリパス。
      */
-    transformPattern: [
-      "**/*.{js,ts,mjs,cjs,jsx,tsx,vue,svelte}",
-      "!**/node_modules/**",
-    ],
+    output: ({ fileName, extension }) => `./${fileName}${extension}`,
 
     /**
-     * Pattern to exclude from the optimization.
-     */
-    excludePattern: ["**/node_modules/**"],
-
-    /**
-     * 最適化された辞書の出力ディレクトリ。
+     * 変換後にコンポーネントを保存するかどうかを示します。
+     * これにより、コンパイラーを1回だけ実行してアプリを変換し、その後削除することができます。
      */
-    output: ({ locale, key }) => `compiler/${locale}/${key}.json`,
+    saveComponents: false,
 
     /**
-     * キーなしで、生成されたファイルにコンテンツのみを挿入します。
+     * 生成されたファイルにコンテンツのみを挿入します。ロケールごとの i18next または ICU MessageFormat JSON 出力に有用です。
+     *
+     * - `output: ({ locale, key }) => `./locale/${locale}/${key}.json`,`
      */
     noMetadata: false,
 
     /**
      * 辞書キーのプレフィックス
      */
-    dictionaryKeyPrefix: "", // Remove base prefix
-
-    /**
-     * 変換後にコンポーネントを保存するかどうかを示します。
-     * これにより、コンパイラを1回だけ実行してアプリを変換し、その後削除することができます。
-     */
-    saveComponents: false,
+    dictionaryKeyPrefix: "", // 抽出された辞書キーにオプションのプレフィックスを追加
   },
 };
 
 export default config;
-```
-
-### 欠落した翻訳を埋める
-
-Intlayerは、欠落した翻訳を埋めるためのCLIツールを提供しています。`intlayer`コマンドを使用して、コード内の欠落した翻訳をテストし、埋めることができます。
-
-```bash
-npx intlayer test         # 欠落した翻訳があるかテストする
-```
-
-```bash
-npx intlayer fill         # 欠落した翻訳を埋める
-```
+````
 
-> 詳細については、[CLIドキュメント](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/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/**']`
-  - _説明_: 最適化のためにコードをトラバースするパターン。
+  - _説明_: (非推奨: 代わりに `build.traversePattern` を使用) 最適化のためにコードをトラバースするパターン。
+
 - **excludePattern**:
   - _タイプ_: `string | string[]`
   - _デフォルト_: `['**/node_modules/**']`
-  - _説明_: 最適化から除外するパターン。
-- **outputDir** (Deprecated):
-  - _タイプ_: `string`
-  - _デフォルト_: `'compiler'`
-  - _説明_: 抽出された辞書が保存されるディレクトリ。
+  - _説明_: (非推奨: 代わりに `build.traversePattern` を使用) 最適化から除外するパターン。
 
 - **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の場合、コンパイラは辞書のメタデータ（キー、コンテンツラッパー）を保存しません。
+  - _説明_: メタデータをファイルに保存するかどうかを示します。trueの場合、コンパイラーは辞書のメタデータ（キー、コンテンツラッパー）を保存しません。
   - _注_: `loadJSON`プラグインを使用する場合に便利です。
-  - _例_: `true`の場合:
+  - _例_:
+    `true`の場合:
     ```json
     {
       "key": "value"
@@ -274,3 +287,26 @@ npx intlayer fill         # 欠落した翻訳を埋める
   - _タイプ_: `boolean`
   - _デフォルト_: `false`
   - _説明_: 変換後にコンポーネントを保存するかどうかを示します。
+
+### 欠落した翻訳を埋める
+
+Intlayerは、欠落した翻訳を埋めるためのCLIツールを提供しています。`intlayer`コマンドを使用して、コード内の欠落した翻訳をテストし、埋めることができます。
+
+```bash
+npx intlayer test         # 欠落した翻訳があるかテストする
+```
+
+```bash
+npx intlayer fill         # 欠落した翻訳を埋める
+```
+
+### 抽出
+
+Intlayerは、コードからコンテンツを抽出するためのCLIツールを提供しています。`intlayer extract`コマンドを使用して、コードからコンテンツを抽出できます。
+
+```bash
+npx intlayer extract
+```
+
+> 詳細については、[CLIドキュメント](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/cli/index.md)
+> を参照してください。

package/docs/ja/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-03-11
+updatedAt: 2026-03-12
 title: 設定
 description: Intlayerをアプリケーション向けに設定する方法を学びます。Intlayerをニーズに合わせてカスタマイズするためのさまざまな設定やオプションについて理解しましょう。
 keywords:
@@ -15,8 +15,8 @@ slugs:
   - configuration
 history:
   - version: 8.3.0
-    data: 2026-03-11
-    changes: 'baseDir' を 'content' 設定から 'system' 設定に移動
+    date: 2026-03-11
+    changes: "'baseDir' を 'content' 設定から 'system' 設定に移動"
   - version: 8.2.0
     date: 2026-03-10
     changes: コンパイラーオプションの更新、'output' および 'noMetadata' のサポートを追加
@@ -43,25 +43,25 @@ history:
     changes: JSON5 および JSONC ファイル形式のサポートを追加
   - version: 7.5.0
     date: 2025-12-17
-    changes: `buildMode` オプションを追加
+    changes: "`buildMode` オプションを追加"
   - version: 6.0.0
     date: 2025-09-16
-    changes: `live` インポートモードを追加
+    changes: "`live` インポートモードを追加"
   - version: 6.0.0
     date: 2025-09-16
-    changes: `live` インポートモードを追加
+    changes: "`live` インポートモードを追加"
   - version: 6.0.0
     date: 2025-09-04
-    changes: `hotReload` フィールドを `liveSync` に置き換え、`liveSyncPort` と `liveSyncURL` フィールドを追加
+    changes: "`hotReload` フィールドを `liveSync` に置き換え、`liveSyncPort` と `liveSyncURL` フィールドを追加"
   - version: 5.6.1
     date: 2025-07-25
-    changes: `activateDynamicImport` を `importMode` オプションに置き換え
+    changes: "`activateDynamicImport` を `importMode` オプションに置き換え"
   - version: 5.6.0
     date: 2025-07-13
     changes: デフォルトの contentDir を `['src']` から `['.']` に変更
   - version: 5.5.11
     date: 2025-06-29
-    changes: `docs` コマンドを追加
+    changes: "`docs` コマンドを追加"
 ---
 
 # Intlayer 設定ドキュメント
@@ -95,7 +95,7 @@ IntlayerはJSON、JS、MJS、TSの設定ファイル形式をサポートして
 
 ## 設定ファイルの例
 
-```typescript fileName="intlayer.config.ts" codeFormat="typescript"
+````typescript fileName="intlayer.config.ts" codeFormat="typescript"
 import { Locales, type IntlayerConfig } from "intlayer";
 import { nextjsRewrite } from "intlayer/routing";
 import { z } from "zod";
@@ -193,7 +193,7 @@ const config: IntlayerConfig = {
      * Options: 'cookie', 'localStorage', 'sessionStorage', 'header', or an array of these.
      * Default: ['cookie', 'header']
      */
-    storage: "cookie",
+    storage: ["cookie", "header"],
 
     /**
      * Base path for the application URLs.
@@ -330,6 +330,17 @@ const config: IntlayerConfig = {
      * Base URL for the AI API.
      */
     baseURL: "http://localhost:3000",
+
+    /**
+     * データシリアライゼーション
+     *
+     * オプション:
+     * - "json": 標準、信頼性あり。より多くのトークンを使用します。
+     * - "toon": より少ないトークンを使用しますが、JSON ほど一貫性がありません。
+     *
+     * デフォルト: "json"
+     */
+    dataSerialization: "json",
   },
 
   /**
@@ -429,42 +440,70 @@ const config: IntlayerConfig = {
   compiler: {
     /**
      * コンパイラを有効にするかどうかを示します。
+     *
+     * - false : コンパイラを無効にします。
+     * - true : コンパイラを有効にします。
+     * - "build-only" : 開発中のコンパイラをスキップして起動時間を短縮します。
+     *
+     * デフォルト : false
      */
     enabled: true,
 
     /**
-     * Pattern to traverse the code to optimize.
-     */
-    transformPattern: [
-      "**/*.{js,ts,mjs,cjs,jsx,tsx,vue,svelte}",
-      "!**/node_modules/**",
-    ],
-
-    /**
-     * Pattern to exclude from the optimization.
+     * 出力ファイルのパスを定義します。 `outputDir` を置き換えます。
+     *
+     * - `./` で始まるパスは、コンポーネントディレクトリを基準に解決されます。
+     * - `/` で始まるパスは、プロジェクトのルート (`baseDir`) を基準に解決されます。
+     *
+     * - パスに `{{locale}}` 変数を含めると、言語ごとに分離された辞書の生成が有効になります。
+     *
+     * 例:
+     * ```ts
+     * {
+     *   // コンポーネントの隣に多言語対応の .content.ts ファイルを作成
+     *   output: ({ fileName, extension }) => `./${fileName}${extension}`,
+     *
+     *   // output: './{{fileName}}{{extension}}', // 文字列テンプレートを使用した同等の記述
+     * }
+     * ```
+     *
+     * ```ts
+     * {
+     *   // プロジェクトのルートに言語ごとに集約された JSON ファイルを作成
+     *   output: ({ key, locale }) => `/locales/${locale}/${key}.content.json`,
+     *
+     *   // output: '/locales/{{locale}}/{{key}}.content.json', // 文字列テンプレートを使用した同等の記述
+     * }
+     * ```
+     *
+     * 変数リスト:
+     *   - `fileName`: ファイル名。
+     *   - `key`: コンテンツのキー。
+     *   - `locale`: コンテンツのロケール。
+     *   - `extension`: ファイル拡張子。
+     *   - `componentFileName`: コンポーネントファイル名。
+     *   - `componentExtension`: コンポーネント拡張子。
+     *   - `format`: 辞書の形式。
+     *   - `componentFormat`: コンポーネント辞書の形式。
+     *   - `componentDirPath`: コンポーネントのディレクトリパス。
      */
-    excludePattern: ["**/node_modules/**"],
+    output: ({ locale, key }) => `compiler/${locale}/${key}.json`,
 
     /**
-     * 最適化された辞書の出力ディレクトリ。
+     * 変換後にコンポーネントを保存するかどうかを示します。
+     * これにより、コンパイラを1回だけ実行してアプリを変換し、その後削除することができます。
      */
-    output: ({ locale, key }) => `compiler/${locale}/${key}.json`,
+    saveComponents: false,
 
     /**
-     * キーなしで、生成されたファイルにコンテンツのみを挿入します。
+     * 生成されたファイルにコンテンツのみを挿入します。
      */
     noMetadata: false,
 
     /**
      * 辞書キーのプレフィックス
      */
-    dictionaryKeyPrefix: "", // Remove base prefix
-
-    /**
-     * 変換後にコンポーネントを保存するかどうかを示します。
-     * これにより、コンパイラを1回だけ実行してアプリを変換し、その後削除することができます。
-     */
-    saveComponents: false,
+    dictionaryKeyPrefix: "", // すべての辞書キーにプレフィックスを設定
   },
 
   /**
@@ -483,7 +522,7 @@ const config: IntlayerConfig = {
 };
 
 export default config;
-```
+````
 
 ## 設定リファレンス
 
@@ -1039,7 +1078,7 @@ Intlayerがアプリケーションの国際化をどのように最適化しビ
 
 - **dictionaryKeyPrefix**:
   - _型_: `string`
-  - _デフォルト_: `'comp-'`
+  - _デフォルト_: `''`
   - _説明_: 抽出された辞書キーのプレフィックス。
   - _例_: `'my-key-'`
   - _注意_: 辞書が抽出される際、キーはファイル名に基づいて生成されます。このプレフィックスは、競合を防ぐために生成されたキーに追加されます。
@@ -1063,24 +1102,28 @@ Intlayerがアプリケーションの国際化をどのように最適化しビ
   - _説明_: 最適化中に除外されるファイルを定義するパターン。
   - _例_: `['**/node_modules/**', '!**/node_modules/react/**']`
 
-- **outputDir**:
-  - _型_: `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'`
+  - _デフォルト_: `undefined`
+  - _説明_: 出力ファイルのパスを定義します。 `outputDir` を置き換えます。 文字列テンプレートまたは関数を通じて動的変数をサポートします。 サポートされている変数: `{{fileName}}`, `{{key}}`, `{{locale}}`, `{{extension}}`, `{{componentFileName}}`, `{{componentExtension}}`, `{{format}}`, `{{componentFormat}}`, および `{{componentDirPath}}`。
+  - _注_: `./` で始まるパスは、コンポーネントディレクトリを基準に解決されます。 `/` で始まるパスは、プロジェクトのルート (`baseDir`) を基準に解決されます。
+  - _注_: パスに `{{locale}}` 変数を含めると、ロケールごとに分離された辞書の生成が有効になります。
+  - _例_:
+    - **コンポーネントの隣に多言語ファイルを作成**:
+    - 文字列: `'./{{fileName}}{{extension}}'`
+    - 関数: `({ fileName, extension }) => \`./${fileName}${extension}\``
+
+    - **ロケールごとに集約された JSON を出力**:
+    - 文字列: `'/locales/{{locale}}/{{key}}.content.json'`
+    - 関数: `({ key, locale }) => \`/locales/${locale}/${key}.content.json\``
 
 - **noMetadata**:
   - _タイプ_: `boolean`
   - _デフォルト_: `false`
-  - _説明_: メタデータをファイルに保存するかどうかを示します。trueの場合、コンパイラは辞書のメタデータ（キー、コンテンツラッパー）を保存しません。
-  - _注_: `loadJSON`プラグインを使用する場合に便利です。
-  - _例_: `true`の場合:
+  - _説明_: メタデータをファイルに保存するかどうかを示します。trueの場合、コンパイラーは辞書のメタデータ（キー、コンテンツラッパー）を保存しません。
+  - _注_: `loadJSON`プラグインを使用する場合に便利です。ロケールごとの i18next または ICU MessageFormat JSON 出力に有用です。
+  - _例_:
+    `true`の場合:
     ```json
     {
       "key": "value"