@intlayer/docs 9.0.0-canary.6 → 9.0.0-canary.8

package/docs/ja/intlayer_with_tanstack+solid.md

@@ -211,11 +211,15 @@ export default defineConfig({
     tanstackStart({
       router: {
         routeFileIgnorePattern:
-          ".content.(ts|tsx|js|mjs|cjs|jsx|json|jsonc|json5)$",
+          ".content.(ts|tsx|js|mjs|cjs|jsx|json|jsonc|json5|md|mdx|yaml|yml)$",
       },
     }),
     solidPlugin({ ssr: true }),
-    intlayer(),
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
   ],
 });
 ```
@@ -551,22 +555,25 @@ const RootComponent: ParentComponent = (props) => {
 
 > 本番環境で `intlayerProxy` を使用するには、`vite-intlayer` パッケージを `devDependencies` から `dependencies` に切り替える必要があることに注意してください。
 
-```typescript {7,14-17} fileName="vite.config.ts"
+```typescript fileName="vite.config.ts"
 import { tanstackStart } from "@tanstack/solid-start/plugin/vite";
 import solid from "vite-plugin-solid";
 import { nitro } from "nitro/vite";
 import { defineConfig } from "vite";
-import { intlayer, intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
   plugins: [
-    intlayerProxy(), // Nitroを使用する場合、プロキシはサーバーの前に配置する必要があります
     nitro(),
-    intlayer(),
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
     tanstackStart({
       router: {
         routeFileIgnorePattern:
-          ".content.(ts|tsx|js|mjs|cjs|jsx|json|jsonc|json5)$",
+          ".content.(ts|tsx|js|mjs|cjs|jsx|json|jsonc|json5|md|mdx|yaml|yml)$",
       },
     }),
     solid(),
@@ -809,9 +816,9 @@ bun x intlayer extract
  </Tab>
  <Tab value='Babel compiler'>
 
-`intlayerCompiler` プラグインを含めるように `vite.config.ts` を更新します：
+> Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
 
-> Intlayer v9以降、コンパイラは直接 `intlayer()` プラグインにバンドルされ、`compiler.enabled` が設定され `compiler.output` パスが構成されると自動的に有効になります。以下に示すように `intlayerCompiler()` を個別に登録することは現在オプションです — 追加された場合でも自動的に重複を排除します。[v9 リリースノート](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/releases/v9.md) を参照してください。
+`intlayerCompiler` プラグインを含めるように `vite.config.ts` を更新します：
 
 ```ts fileName="vite.config.ts"
 import { intlayer, intlayerCompiler } from "vite-intlayer";
@@ -826,12 +833,12 @@ export default defineConfig({
     tanstackStart({
       router: {
         routeFileIgnorePattern:
-          ".content.(ts|tsx|js|mjs|cjs|jsx|json|jsonc|json5)$",
+          ".content.(ts|tsx|js|mjs|cjs|jsx|json|jsonc|json5|md|mdx|yaml|yml)$",
       },
     }),
     solidPlugin({ ssr: true }),
     intlayer(),
-    intlayerCompiler(),
+    intlayerCompiler(), // Adds the compiler plugin
   ],
 });
 ```

package/docs/ja/intlayer_with_tanstack.md

@@ -228,11 +228,15 @@ import { intlayer } from "vite-intlayer";
 const config = defineConfig({
   plugins: [
     nitro(),
-    intlayer(),
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
     tanstackStart({
       router: {
         routeFileIgnorePattern:
-          ".content.(ts|tsx|js|mjs|cjs|jsx|json|jsonc|json5)$",
+          ".content.(ts|tsx|js|mjs|cjs|jsx|json|jsonc|json5|md|mdx|yaml|yml)$",
       },
     }),
     viteReact(),
@@ -677,22 +681,25 @@ function RootDocument({ children }: { children: ReactNode }) {
 
 > `intlayerProxy`を本番環境で使用するには、`vite-intlayer`パッケージを`devDependencies`から`dependencies`に切り替える必要があることに注意してください。
 
-```typescript {7,14-17} fileName="vite.config.ts"
+```typescript fileName="vite.config.ts"
 import { tanstackStart } from "@tanstack/react-start/plugin/vite";
 import viteReact from "@vitejs/plugin-react";
 import { nitro } from "nitro/vite";
 import { defineConfig } from "vite";
-import { intlayer, intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
   plugins: [
-    intlayerProxy(), // Nitroを使用する場合、プロキシをサーバーの前に配置する必要があります
     nitro(),
-    intlayer(),
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
     tanstackStart({
       router: {
         routeFileIgnorePattern:
-          ".content.(ts|tsx|js|mjs|cjs|jsx|json|jsonc|json5)$",
+          ".content.(ts|tsx|js|mjs|cjs|jsx|json|jsonc|json5|md|mdx|yaml|yml)$",
       },
     }),
     viteReact(),
@@ -937,9 +944,9 @@ bun x intlayer extract
  </Tab>
  <Tab value='Babelコンパイラ'>
 
-`vite.config.ts` を更新して `intlayerCompiler` プラグインを含めます：
+> Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
 
-> Intlayer v9以降、コンパイラは直接 `intlayer()` プラグインにバンドルされ、`compiler.enabled` が設定され `compiler.output` パスが構成されると自動的に有効になります。以下に示すように `intlayerCompiler()` を個別に登録することは現在オプションです — 追加された場合でも自動的に重複を排除します。[v9 リリースノート](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/releases/v9.md) を参照してください。
+`vite.config.ts` を更新して `intlayerCompiler` プラグインを含めます：
 
 ```ts fileName="vite.config.ts"
 import { intlayer, intlayerCompiler } from "vite-intlayer";
@@ -951,15 +958,15 @@ import viteReact from "@vitejs/plugin-react";
 export default defineConfig({
   plugins: [
     devtools(),
-    intlayerCompiler(),
     tanstackStart({
       router: {
         routeFileIgnorePattern:
-          ".content.(ts|tsx|js|mjs|cjs|jsx|json|jsonc|json5)$",
+          ".content.(ts|tsx|js|mjs|cjs|jsx|json|jsonc|json5|md|mdx|yaml|yml)$",
       },
     }),
     viteReact(),
     intlayer(),
+    intlayerCompiler(), // Adds the compiler plugin
   ],
 });
 ```

package/docs/ja/intlayer_with_vite+lit.md

@@ -188,7 +188,13 @@ import { intlayer } from "vite-intlayer";
 
 // https://vitejs.dev/config/
 export default defineConfig({
-  plugins: [intlayer()],
+  plugins: [
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
+  ],
 });
 ```
 
@@ -457,12 +463,15 @@ export class MyElement extends LitElement {
 
 ```typescript {3,7} fileName="vite.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { defineConfig } from "vite";
-import { intlayer, intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
   plugins: [
-    intlayerProxy(), // should be placed first
-    intlayer(),
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
   ],
 });
 ```

package/docs/ja/intlayer_with_vite+preact.md

@@ -522,15 +522,18 @@ export default App;
 
 ```typescript {3,7} fileName="vite.config.ts"
 import { defineConfig } from "vite";
-import { intlayer, intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 import preact from "@preact/preset-vite";
 
 // https://vitejs.dev/config/
 export default defineConfig({
   plugins: [
-    intlayerProxy(), // 最初に配置する必要があります
     preact(),
-    intlayer(),
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
   ],
 });
 ```
@@ -813,6 +816,8 @@ bun x intlayer extract
  </Tab>
  <Tab value='Babelコンパイラ'>
 
+> Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
+
 ```bash packageManager="npm"
 npm install @intlayer/babel --save-dev
 ```

package/docs/ja/intlayer_with_vite+react.md

@@ -311,6 +311,8 @@ bun x intlayer extract
  </Tab>
  <Tab value='Babel compiler'>
 
+> Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
+
 `vite.config.ts` を更新して `intlayerCompiler` プラグインを含めます:
 
 ```ts fileName="vite.config.ts"
@@ -320,7 +322,7 @@ import { intlayer, intlayerCompiler } from "vite-intlayer";
 export default defineConfig({
   plugins: [
     intlayer(),
-    intlayerCompiler(), // コンパイラプラグインを追加します
+    intlayerCompiler(), // Adds the compiler plugin
   ],
 });
 ```

package/docs/ja/intlayer_with_vite+react_compiler.md

@@ -213,11 +213,18 @@ export default config;
 ```typescript fileName="vite.config.ts"
 import { defineConfig } from "vite";
 import react from "@vitejs/plugin-react-swc";
-import { intlayer, intlayerCompiler } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 // https://vitejs.dev/config/
 export default defineConfig({
-  plugins: [react(), intlayer(), intlayerCompiler()],
+  plugins: [
+    react(),
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
+  ],
 });
 ```
 

package/docs/ja/intlayer_with_vite+solid.md

@@ -599,6 +599,8 @@ bun x intlayer extract
  </Tab>
  <Tab value='Babelコンパイラ'>
 
+> Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
+
 `vite.config.ts` を更新して `intlayerCompiler` プラグインを含めます。
 
 ```ts fileName="vite.config.ts"
@@ -608,7 +610,7 @@ import { intlayer, intlayerCompiler } from "vite-intlayer";
 export default defineConfig({
   plugins: [
     intlayer(),
-    intlayerCompiler(), // コンパイラプラグインを追加します
+    intlayerCompiler(), // Adds the compiler plugin
   ],
 });
 ```

package/docs/ja/intlayer_with_vite+svelte.md

@@ -446,12 +446,12 @@ $: content = useIntlayer('app', locale); // ロケールに基づくコンテン
 ```typescript {3,7} fileName="vite.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { defineConfig } from "vite";
 import { svelte } from "@sveltejs/vite-plugin-svelte";
-import { intlayer, intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 typescript {3,7} fileName="vite.config.ts" codeFormat="typescript"
 import { defineConfig } from "vite";
 import { svelte } from "@sveltejs/vite-plugin-svelte";
-import { intlayer, intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 // https://vitejs.dev/config/
 export default defineConfig({
@@ -563,6 +563,8 @@ bun x intlayer extract
  </Tab>
  <Tab value='Babelコンパイラ'>
 
+> Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
+
 `vite.config.ts` を更新して `intlayerCompiler` プラグインを含めます。
 
 ```ts fileName="vite.config.ts"
@@ -572,7 +574,7 @@ import { intlayer, intlayerCompiler } from "vite-intlayer";
 export default defineConfig({
   plugins: [
     intlayer(),
-    intlayerCompiler(), // コンパイラプラグインを追加します
+    intlayerCompiler(), // Adds the compiler plugin
   ],
 });
 ```

package/docs/ja/intlayer_with_vite+vanilla.md

@@ -188,7 +188,13 @@ import { intlayer } from "vite-intlayer";
 
 // https://vitejs.dev/config/
 export default defineConfig({
-  plugins: [intlayer()],
+  plugins: [
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
+  ],
 });
 ```
 
@@ -449,12 +455,15 @@ document.querySelector<HTMLDivElement>(".edit-note")!.innerHTML =
 
 ```typescript {3,7} fileName="vite.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { defineConfig } from "vite";
-import { intlayer, intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
   plugins: [
-    intlayerProxy(), // 最初に配置する必要があります
-    intlayer(),
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
   ],
 });
 ```
@@ -586,6 +595,8 @@ bun x intlayer extract
  </Tab>
  <Tab value='Babel コンパイラ'>
 
+> Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
+
 `intlayerCompiler` プラグインを含めるように `vite.config.ts` を更新します：
 
 ```ts fileName="vite.config.ts"
@@ -595,7 +606,7 @@ import { intlayer, intlayerCompiler } from "vite-intlayer";
 export default defineConfig({
   plugins: [
     intlayer(),
-    intlayerCompiler(), // コンパイラプラグインを追加
+    intlayerCompiler(), // Adds the compiler plugin
   ],
 });
 ```

package/docs/ja/intlayer_with_vite+vue.md

@@ -625,14 +625,17 @@ import LocaleSwitcher from "@components/LocaleSwitcher.vue";
 ```typescript {3,7} fileName="vite.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { defineConfig } from "vite";
 import vue from "@vitejs/plugin-vue";
-import { intlayer, intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 // https://vitejs.dev/config/
 export default defineConfig({
   plugins: [
-    intlayerProxy(), // should be placed first
     vue(),
-    intlayer(),
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
   ],
 });
 ```
@@ -960,6 +963,8 @@ bun x intlayer extract
  </Tab>
  <Tab value='Babel compiler'>
 
+> Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
+
 `vite.config.ts` を更新して `intlayerCompiler` プラグインを含めます:
 
 ```ts fileName="vite.config.ts"
@@ -969,7 +974,7 @@ import { intlayer, intlayerCompiler } from "vite-intlayer";
 export default defineConfig({
   plugins: [
     intlayer(),
-    intlayerCompiler(), // コンパイラプラグインを追加します
+    intlayerCompiler(), // Adds the compiler plugin
   ],
 });
 ```

package/docs/ja/packages/@intlayer_babel/export.md

@@ -0,0 +1,131 @@
+---
+createdAt: 2026-06-25
+updatedAt: 2026-06-25
+title: "@intlayer/babel パッケージドキュメント"
+description: コンテンツ抽出、インポートの最適化、未使用フィールドのクリーンアップ、ビルド中のフィールド名の難読化を処理するIntlayer用のBabelプラグイン。
+keywords:
+  - "@intlayer/babel"
+  - babel
+  - plugin
+  - 国際化
+  - i18n
+  - コンパイラ
+  - 最適化
+  - クリーンアップ
+  - ミニファイ
+slugs:
+  - doc
+  - packages
+  - "@intlayer/babel"
+  - export
+history:
+  - version: 9.0.0
+    date: 2026-06-25
+    changes: "すべてのエクスポートのドキュメントを統一"
+author: aymericzip
+---
+
+# @intlayer/babel パッケージ
+
+`@intlayer/babel` パッケージは、Intlayer向けに特化した一連のBabelプラグインを提供します。これらのプラグインは、コンテンツ宣言の抽出、`useIntlayer` / `getIntlayer`呼び出しの最適化された辞書インポートへの書き換え、未使用フィールドのクリーンアップ、フィールド名の圧縮など、ビルドサイクル全体をカバーします。
+
+## インストール
+
+```bash
+npm install @intlayer/babel
+```
+
+## エクスポート
+
+インポート方法:
+
+```ts
+import { ... } from "@intlayer/babel";
+```
+
+---
+
+### プラグイン
+
+| 関数 / クラス                  | 説明                                                                                                                                                                                                         |
+| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `intlayerExtractBabelPlugin`   | ソースファイルから翻訳可能なコンテンツを抽出し、`useIntlayer` / `getIntlayer`フックを自動的に注入するBabelプラグイン。Next.jsおよびBabelベースのビルドツールでの使用向けに設計されています。                 |
+| `intlayerOptimizeBabelPlugin`  | `useIntlayer`および`getIntlayer`呼び出しを変換し、そのインポートを最適化されたJSON辞書インポート（静的、動的、またはフェッチ経由）に書き換えるBabelプラグイン。                                              |
+| `intlayerPurgeBabelPlugin`     | ソースファイルを分析し、コンパイルされた辞書JSONファイルを書き換えて、未使用のフィールドを削除する（`build.purge`）か、短いアルファベットのエイリアスに名前を変更する（`build.minify`）Babelプラグイン。     |
+| `intlayerMinifyBabelPlugin`    | ミニファイ（圧縮）フェーズ中に割り当てられた短いフィールドエイリアス（例：`content.title` ← `content.a`）を使用するようにソースファイルを書き換えるBabelプラグイン。`intlayerPurgeBabelPlugin`に依存します。 |
+| `makeFieldRenameBabelPlugin`   | `PruneContext`に入力された`dictionaryKeyToFieldRenameMap`に従って、ソースファイル内の辞書コンテンツフィールドアクセス名を変更するBabelプラグインを生成するファクトリ関数。                                   |
+| `makeUsageAnalyzerBabelPlugin` | ソースコード内での`useIntlayer` / `getIntlayer`の使用状況を分析し、共有`PruneContext`内にフィールドの使用状況データを集計するBabelプラグインを生成するファクトリ関数。                                       |
+| `getSharedPruneContext`        | 指定されたベースディレクトリに対する共有`PruneContext`オブジェクトを返すヘルパー関数。まだ初期化されていない場合は`null`を返します。                                                                         |
+
+---
+
+### プラグイン設定ユーティリティ
+
+| 関数                       | 説明                                                                                                                           |
+| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
+| `getExtractPluginOptions`  | Intlayer設定を読み込み、`intlayerExtractBabelPlugin`で使用できる状態の`ExtractPluginOptions`を返します。                       |
+| `getOptimizePluginOptions` | Intlayer設定とコンパイル済み辞書を読み込み、`intlayerOptimizeBabelPlugin`で使用できる状態の`OptimizePluginOptions`を返します。 |
+| `getPurgePluginOptions`    | Intlayer設定を読み込み、`intlayerPurgeBabelPlugin`で使用できる状態の`PurgePluginOptions`を返します。                           |
+| `getMinifyPluginOptions`   | Intlayer設定を読み込み、`intlayerMinifyBabelPlugin`で使用できる状態の`MinifyPluginOptions`を返します。                         |
+
+---
+
+### 型
+
+| 型                      | 説明                                                                                                                               |
+| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
+| `CompilerMode`          | コンパイラモード：`'dev'` HMRサポート付き開発用、または`'build'`本番ビルド用。                                                     |
+| `ExtractPluginOptions`  | `intlayerExtractBabelPlugin`のオプション：ファイルリスト、設定、`onExtract`コールバックなど。                                      |
+| `ExtractResult`         | 抽出結果：辞書キー、ファイルパス、コンテンツ、およびロケール。                                                                     |
+| `OptimizePluginOptions` | `intlayerOptimizeBabelPlugin`のオプション：辞書パス、インポートモード、辞書ごとのモードマップなど。                                |
+| `PurgePluginOptions`    | `intlayerPurgeBabelPlugin`のオプション：ベースディレクトリ、クリーンアップ/ミニファイ/最適化フラグ、コンポーネントファイルリスト。 |
+| `MinifyPluginOptions`   | `intlayerMinifyBabelPlugin`のオプション：ベースディレクトリ、ミニファイ/最適化/editorEnabledフラグ。                               |
+| `PruneContext`          | 分析プラグインとクリーンアッププラグインの間で共有される状態：フィールド使用マップ、名前変更マップなど。                           |
+| `DictionaryFieldUsage`  | 単一の辞書に対するフィールド使用結果：静的分析で確定できない場合は`Set<string>`または`'all'`。                                     |
+| `NestedRenameEntry`     | 名前変更ツリー内のノード：`shortName`と子ノードのマップ。                                                                          |
+| `NestedRenameMap`       | 名前変更ツリー内の1つのレベル：`Map<string, NestedRenameEntry>`。                                                                  |
+| `CompatCallerConfig`    | 互換アダプタ（compat-adapter）パッケージ用の互換使用アナライザ設定（呼び出し元名と処理オプション）。                               |
+| `ScriptBlock`           | SFCファイル（VueまたはSvelte）から抽出されたスクリプトブロック：コンテンツ、開始オフセット、および終了オフセット。                 |
+
+---
+
+### ユーティリティ関数
+
+| 関数                              | 説明                                                                                                                                        |
+| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
+| `generateShortFieldName`          | 整数（ゼロから開始）を短いアルファベットの識別子に変換します：`0` → `'a'`、`25` → `'z'`、`26` → `'aa'`など。                                |
+| `buildNestedRenameMapFromContent` | コンパイルされた辞書のコンテンツ値から、Intlayerノード構造（translation、enumerationなど）を考慮して`NestedRenameMap`を再帰的に構築します。 |
+| `createPruneContext`              | デフォルト値で初期化された新しい空の`PruneContext`オブジェクトを作成します。                                                                |
+| `extractScriptBlocks`             | 後続のBabel分析のために、SFCファイル（Vue / Svelte）から`<script>`ブロックを抽出します。                                                    |
+| `BABEL_PARSER_OPTIONS`            | サポートされているフレームワーク（React/Vue/Svelte/Angular/...）をカバーするBabelパーサーオプションを表す定数。                             |
+| `INTLAYER_CALLER_NAMES`           | オリジナルのIntlayer呼び出し元名の定数リスト：`['useIntlayer', 'getIntlayer']`。                                                            |
+
+---
+
+## 使用例
+
+```js
+// babel.config.js
+const {
+  intlayerExtractBabelPlugin,
+  intlayerPurgeBabelPlugin,
+  intlayerMinifyBabelPlugin,
+  intlayerOptimizeBabelPlugin,
+  getExtractPluginOptions,
+  getPurgePluginOptions,
+  getMinifyPluginOptions,
+  getOptimizePluginOptions,
+} = require("@intlayer/babel");
+
+module.exports = {
+  presets: ["next/babel"],
+  plugins: [
+    [intlayerExtractBabelPlugin, getExtractPluginOptions()],
+    [intlayerPurgeBabelPlugin, getPurgePluginOptions()],
+    [intlayerMinifyBabelPlugin, getMinifyPluginOptions()],
+    [intlayerOptimizeBabelPlugin, getOptimizePluginOptions()],
+  ],
+};
+```
+
+> **注意：** `intlayerPurgeBabelPlugin`は、後者が前者の構築した名前変更マップを読み取るため、`intlayerMinifyBabelPlugin`よりも**前**に宣言する必要があります。また、`useIntlayer`呼び出しが書き換えられる前に辞書キーを検知できるようにするため、両方の前に`intlayerOptimizeBabelPlugin`を配置する必要があります。

package/docs/ja/packages/vite-intlayer/intlayerCompiler.md

@@ -0,0 +1,120 @@
+---
+createdAt: 2026-06-25
+updatedAt: 2026-06-25
+title: intlayerCompiler Viteプラグインドキュメント | vite-intlayer
+description: コンポーネントファイルからインラインのIntlayerコンテンツ宣言を抽出し、ビルド/変換時に辞書JSONファイルに書き込むViteプラグイン。
+keywords:
+  - intlayerCompiler
+  - vite
+  - プラグイン
+  - コンパイラ
+  - コンテンツ
+  - 辞書
+  - 国際化
+  - i18n
+slugs:
+  - doc
+  - packages
+  - vite-intlayer
+  - intlayerCompiler
+history:
+  - version: 9.0.0
+    date: 2026-06-25
+    changes: "intlayer()にバンドル。ドキュメント初期化"
+author: aymericzip
+---
+
+# intlayerCompiler
+
+`intlayerCompiler`は、コンポーネントのソースファイルをスキャンして**インラインのIntlayerコンテンツ宣言**（別個の`.content.ts`ファイルではなく、コンポーネント内に直接定義されたコンテンツ）を探し、変換（transform）フェーズ中にそれらを辞書JSONファイルに書き込むViteプラグインです。
+
+> **Intlayer v9以降**、`compiler.enabled`が`true`かつ`compiler.output`がIntlayer設定で指定されている場合、`intlayerCompiler`はメインの[`intlayer()`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/vite-intlayer/intlayer.md)プラグインに自動的に組み込まれます。コンパイラ固有の設定を完全に制御したい場合にのみ、個別に登録する必要があります。
+
+## 使用方法
+
+### `intlayer()`の一部として（推奨、v9+）
+
+Intlayer設定でコンパイラを有効にします：
+
+```ts
+// intlayer.config.ts
+import { defineConfig } from "intlayer";
+
+export default defineConfig({
+  compiler: {
+    enabled: true,
+    output: "./src/dictionaries", // 抽出された辞書が書き込まれる場所
+  },
+});
+```
+
+次に、追加の登録なしで標準プラグインを使用します：
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { intlayer } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [intlayer()],
+});
+```
+
+### スタンドアロン（必要な場合）
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { intlayerCompiler } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [intlayerCompiler()],
+});
+```
+
+## オプション
+
+```ts
+import type { IntlayerCompilerOptions } from "vite-intlayer";
+```
+
+| オプション       | 型                        | 説明                                                                                           |
+| ---------------- | ------------------------- | ---------------------------------------------------------------------------------------------- |
+| `configOptions`  | `GetConfigurationOptions` | `getConfiguration()`に転送されるIntlayer設定のオーバーライド。                                 |
+| `compilerConfig` | `Partial<CompilerConfig>` | コンパイラ固有の設定セクションに対するオーバーライド（例：`enabled`、`output`、`filesList`）。 |
+
+### 例
+
+```ts
+intlayerCompiler({
+  configOptions: { configFile: "./config/intlayer.config.ts" },
+  compilerConfig: { enabled: true, output: "./src/dictionaries" },
+});
+```
+
+## 動作原理
+
+### 変換（Transform）フェーズ
+
+`compiler.filesList`に一致するすべてのソースファイルに対して、コンパイラプラグインは以下を実行します：
+
+1. ファイルコンテンツを`@intlayer/babel`の`extractContent`に渡します。
+2. 検出された各宣言に対して`onExtract`を呼び出し、結果の辞書JSONを`compiler.output`に書き込みます。
+3. インライン宣言が標準の`useIntlayer('key')` / `getIntlayer('key')`呼び出しに置き換えられた、変換後のソースコードを返します。
+
+サポートされているファイルタイプ：`.ts`、`.tsx`、`.js`、`.jsx`、`.vue`、`.svelte`、`.astro`。
+
+### HMR（ホットモジュールリプレイスメント）
+
+開発モードでコンポーネントファイルが保存されると、コンパイラは以下を実行します：
+
+1. Viteの`handleHotUpdate`フックを介してファイルの変更を検知します。
+2. 更新されたファイルからコンテンツを再抽出します。
+3. 更新された辞書JSONを書き込みます。
+4. ページのフルリロードをトリガーします（`server.ws.send({ type: 'full-reload' })`）。
+
+500ミリ秒のデバウンス（遅延）により、辞書の書き込み自体（これもファイル変更イベントをトリガーします）が無限の再抽出ループを引き起こすのを防ぎます。
+
+### 重複排除（Deduplication）
+
+`intlayerCompiler`は、他のバンドルされたプラグインと同じ`createPrimaryInstanceGuard`重複排除メカニズムを使用します。`intlayer()`（コンパイラを内包）と手動の`intlayerCompiler()`呼び出しの両方が存在する場合、最初に登録されたインスタンスのみが実行され、辞書が二重に書き込まれることはありません。