@intlayer/docs 9.1.3 → 9.3.0

package/docs/ja/analytics.md

@@ -0,0 +1,222 @@
+---
+createdAt: 2026-07-08
+updatedAt: 2026-07-08
+title: Intlayer Analytics | コンテンツ露出の追跡とA/Bテストの実行
+description: "@intlayer/analyticsがページ/ロケールビューとコンテンツ露出をどのように追跡するか、そしてそれを活用してIntlayerコンテンツでA/Bテストを実行する方法について説明します。"
+keywords:
+  - Analytics (アナリティクス)
+  - A/B Testing (A/Bテスト)
+  - Audience (オーディエンス)
+  - Internationalization (国際化)
+  - Documentation (ドキュメント)
+  - Intlayer
+  - Next.js
+  - JavaScript
+  - React
+slugs:
+  - doc
+  - concept
+  - analytics
+history:
+  - version: 9.0.0
+    date: 2026-07-08
+    changes: "Init doc — @intlayer/analytics パッケージ、プロバイダ/ノードレベルのトラッキング、A/Bテスト、ダッシュボード"
+author: aymericzip
+---
+
+# Intlayer Analytics ドキュメント
+
+`@intlayer/analytics`はオプションのコンパニオンパッケージであり、**実際にどのコンテンツが訪問者に表示されたか**（どのページで、どのロケールで、翻訳されたコンテンツのどの特定の部分か）を把握できるようにします。これにより、オーディエンスを理解し、**コンテンツ上でA/Bテスト**を実行することができます。
+
+## 目次
+
+<TOC/>
+
+---
+
+## トラッキング対象
+
+`@intlayer/analytics`は、3種類の匿名イベントをバッチ処理します：
+
+| イベント           | どこでキャプチャされるか                                | 何がわかるか                                                                                                           |
+| ------------------ | ------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
+| `page_view`        | プロバイダレベル (`IntlayerProvider`)                   | 初回ロード、ルート変更、またはロケール切り替え時に、セッションがどのページとロケールを表示したか。                     |
+| `content_exposure` | ノードレベル (`useIntlayer` / インタープリタプラグイン) | どの辞書キー（dictionary key）/ キーパスが実際に解決されて表示されたか。実験の一部である場合は、どの**バリアント**か。 |
+| `conversion`       | `useConversion()`を呼び出す場所                         | 達成された目標（サインアップ、クリック、購入など）が、セッションに表示されたA/Bバリアントに紐付けられます。            |
+
+イベントはメモリに収集され、**約20秒に1回のバッチリクエスト**として送信されます。キー入力やレンダリングごとに送信されることはないため、アナリティクスが初回レンダリング時間に影響を与えたり、インタラクションごとにリクエストを追加したりすることはありません。
+
+## コンテンツA/Bテストをどのように強化するか
+
+Intlayerでは、すでにコンテンツの[バリアント (Variants)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/dynamic_dictionaries/index.md)を宣言できます（例：`control`と`black_friday`バリアントを持つ`hero-banner`辞書など）。`@intlayer/analytics`は、そのサイクルを完結させます：
+
+1. `getVariant(experimentKey, variants)`は、各匿名セッションを決定論的にバリアントに割り当てます。これはセッションIDと実験キーの純粋関数であるため、割り当ては**セッション全体で安定**しており、初回レンダリング前の**サーバーラウンドトリップを必要としません**（ちらつきやレイアウトのずれが発生しません）。
+2. すべての`content_exposure`イベントには、表示された`variant`が含まれます。
+3. `useConversion()`を使用すると、そのバリアントに目標（例：`"cta_click"`）を紐付けることができます。
+4. ダッシュボードの実験結果エンドポイントでは、統計的有意性（Z検定）を含むバリアントごとのコンバージョン率を比較します。
+
+## インストール
+
+`@intlayer/analytics`は**ピア（peer）、オプション**の依存関係です。フレームワークパッケージによって自動的にインストールされることはありません。`intlayer`と一緒に追加してください：
+
+```bash packageManager="npm"
+npm install @intlayer/analytics
+```
+
+```bash packageManager="yarn"
+yarn add @intlayer/analytics
+```
+
+```bash packageManager="pnpm"
+pnpm add @intlayer/analytics
+```
+
+```bash packageManager="bun"
+bun add @intlayer/analytics
+```
+
+インストールしない場合、すべての統合ポイントはNo-Op（何もしない処理）として解決されます — 以下の[未インストール時のゼロコスト](#未インストール時のゼロコスト)を参照してください。
+
+## 設定
+
+Analyticsは**既存の`editor`設定ブロックを再利用**します。入力する個別の`analytics`設定スキーマはありません：
+
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  editor: {
+    backendURL: "https://back.intlayer.org", // アナリティクスデータ収集エンドポイントとしても使用されます
+    clientId: "your-client-id", // アナリティクスプロジェクトキーとしても使用されます
+    clientSecret: "your-client-secret",
+  },
+};
+
+export default config;
+```
+
+- `editor.backendURL` — アナリティクスイベントが送信されるベースURL（`POST {backendURL}/api/analytics/events`）。
+- `editor.clientId` — 収集されたすべてのイベントに紐付けられる公開プロジェクトキー。これは**有効化スイッチ**としても機能します：`clientId`が設定されるまで、アナリティクスは完全に無効化されます（後述のようにツリーシェイキングで削除されます）。
+
+Intlayerをセルフホスト（self-host）している場合、`editor.backendURL`を共有しているため、アナリティクスは自動的にご自身のインスタンスを指します。
+
+## フレームワークのサポート
+
+Analyticsは`react-intlayer`からの共有`IntlayerProvider`に組み込まれているため、そのプロバイダが使用されている場所であればどこでも今日から利用できます：
+
+| フレームワーク                                           | ステータス                                                                                           |
+| -------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
+| React                                                    | ✅ 利用可能                                                                                          |
+| Next.js (`next-intlayer`)                                | ✅ 利用可能 (`react-intlayer` 経由)                                                                  |
+| React Native / Expo (`react-native-intlayer`)            | ✅ 利用可能 (`react-intlayer` 経由)                                                                  |
+| Vue, Svelte, Angular, Solid, Preact, Lit, Astro, Vanilla | 🚧 計画中 — 同一クライアント、`@intlayer/editor`の展開パターンに従うプロバイダレベルのバインディング |
+
+## 使用方法
+
+### 自動プロバイダレベルのトラッキング
+
+コードの変更は必要ありません。`@intlayer/analytics`がインストールされ、`editor.clientId`が設定されると、`IntlayerProvider`は自動的に以下を実行します：
+
+- マウント時にアナリティクスクライアントを初期化します。
+- 初回ロード時に`page_view`を記録します。
+- ロケールが変更されるたびに`page_view`を記録します。
+- 約20秒間のフラッシュ（送信）ループを開始し、アンマウント時またはタブを閉じた時に残りのイベントを送信します（`navigator.sendBeacon`経由、`fetch(..., { keepalive: true })`にフォールバック）。
+
+### 自動ノードレベルのトラッキング
+
+`useIntlayer`が表示用のコンテンツを解決するたびに、インタープリタは正確な`dictionaryKey` + キーパス + ロケールに対して`content_exposure`イベントを報告します。これについてもコードの変更は必要ありません。送信ウィンドウ内で同じノードが繰り返し表示された場合は、`count`付きの単一のイベントとしてまとめられるため、50回再レンダリングされるリストが50のイベントを送信することはありません。
+
+### A/Bテストのコンバージョントラッキング
+
+`useConversion()`を使用して、セッションが表示されたバリアントに目標を紐付けます：
+
+```tsx fileName="CTAButton.tsx" codeFormat="tsx"
+import { useConversion } from "react-intlayer";
+
+const CTAButton = () => {
+  const trackConversion = useConversion();
+
+  return (
+    <button
+      onClick={() =>
+        trackConversion({
+          experimentKey: "homepage-hero",
+          variant: "black_friday",
+          goal: "cta_click",
+        })
+      }
+    >
+      はじめる
+    </button>
+  );
+};
+```
+
+### クライアント側でのバリアント解決
+
+```tsx fileName="useHeroVariant.ts" codeFormat="tsx"
+import { getGlobalAnalyticsClient } from "@intlayer/analytics/client";
+
+const client = getGlobalAnalyticsClient();
+const variant = client?.getVariant("homepage-hero", [
+  "control",
+  "black_friday",
+]);
+```
+
+## プライバシーとパフォーマンス
+
+- **設計上の匿名性**: セッションは回転するIDによって識別されます。バックエンドはそのIDの**SHA-256ハッシュ**のみを保存し、生のIDやIPアドレスは決して保存しません。
+- **大まかな位置情報**: CDNのジオロケーションヘッダー（`cf-ipcountry`、`x-vercel-ip-country`など）から派生した国コードのみであり、IPが読み取られたり保存されたりすることはありません。
+- **デフォルトで検索パラメータを除外するURL**: そのため、クエリ文字列（query strings）がキャプチャされることはありません。
+- **サンプリング**: `sampleRate`を使用すると、トラフィックの多いアプリでコンテンツ露出イベントの一部のみを保持できます。
+- **バッチ処理**: 約20秒ごと（`flushInterval`）、またはバッファがいっぱいになった場合（`maxBufferSize`）はそれより早く、1回のリクエストを送信します。イベントごとにリクエストを送信することはありません。
+
+### 未インストール時のゼロコスト
+
+`@intlayer/analytics`は、`@intlayer/editor`とまったく同じオプション依存関係パターンに従っています：
+
+- 各統合ポイントは、**`try/catch`でラップされた動的`import()`**を介してパッケージをロードします。`@intlayer/analytics`をインストールしないアプリでは、バンドルサイズやランタイムコストが発生することはなく、エラーが表示されることもありません。
+- コンパイル時の環境変数（`INTLAYER_ANALYTICS_ENABLED`）は、`editor.clientId`が設定されていない場合に`@intlayer/config`によって自動的に`'false'`に設定されます。これにより、バンドラーが統合全体を**デッドコードとして削除（dead-code-eliminate）**できるようになります。
+- Intlayerエディタ/CMSプレビューのiframe内ではアナリティクスが無効になっているため、エディタセッションが実際のトラフィックとしてカウントされることはありません。
+
+## ダッシュボード：アナリティクスページ
+
+プロジェクトがイベントを収集すると、[Intlayerダッシュボード](https://app.intlayer.org/analytics)の**Analytics**ページ（プロジェクトを選択するとサイドバーに表示されます）に以下が表示されます：
+
+- **アクティブユーザー** — 選択したローリングウィンドウ（7日 / 30日 / 90日）内のユニーク訪問者数。
+- **今日のユーザー** および **過去7日間のユーザー**。
+- 選択したウィンドウ内の**ページビュー**。
+- 日次ユニーク訪問者の**推移グラフ**。
+- オーディエンスをロケールおよび国別にランク付けする**ロケール**および**ロケーション**の詳細タブ。
+
+## バックエンドAPIリファレンス
+
+すべての読み取りエンドポイントには認証が必要です。データの取り込み（ingestion）は公開されており、ボディの`clientId`によって属性付けされます。
+
+| メソッド | エンドポイント                              | 説明                                                                     |
+| -------- | ------------------------------------------- | ------------------------------------------------------------------------ |
+| `POST`   | `/api/analytics/events`                     | イベントのバッチを取り込む（公開、ボディの`clientId`に紐付けられる）。   |
+| `GET`    | `/api/analytics/overview`                   | 認証されたプロジェクトのページ/ロケールの合計。                          |
+| `GET`    | `/api/analytics/audience?days=30`           | ユニーク訪問者、ページビュー、日次系列、ロケール + 国の詳細。            |
+| `GET`    | `/api/analytics/content-stats`              | コンテンツごとの露出合計（辞書キー / キーパス / ロケールでグループ化）。 |
+| `GET`    | `/api/analytics/experiments/:experimentKey` | A/B実験のバリアントごとのコンバージョン率と統計的有意性。                |
+
+[CMS SDK](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/intlayer_CMS.md)を使用して、これらをプログラムで呼び出すこともできます：
+
+```ts fileName="analytics.ts"
+import { createIntlayerCMS } from "@intlayer/api";
+import { analyticsEndpoint } from "@intlayer/api/analytics";
+
+const cms = createIntlayerCMS();
+
+const { data: audience } = await analyticsEndpoint(cms).getAudience(30);
+```
+
+## 便利なリンク
+
+- [ダイナミック辞書 - コレクションとバリアント](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/dynamic_dictionaries/index.md)
+- [Intlayer CMS - CMS SDK](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/intlayer_CMS.md)
+- [Intlayer ビジュアルエディタ](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/intlayer_visual_editor.md)
+- [設定リファレンス](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/configuration.md)
+- [セルフホスティングガイド](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/self_hosting.md)

package/docs/ja/autoFill.md

@@ -75,11 +75,30 @@ v7 では、`fill` コマンドの動作が更新されました：
 
 別のファイルに書き込むためのパスオプションを使用する場合、埋め込みメカニズムはコンテンツ宣言ファイル間の _マスター・スレーブ_ 関係を通じて機能します。メインファイル（マスター）が情報源として機能し、更新されると、Intlayer はパスで指定されたスレーブの宣言ファイルに変更を自動的に適用します。
 
-# 自動入力コンテンツ宣言ファイルの翻訳
+### ロケールごとのカスタマイズ
 
-**自動入力コンテンツ宣言ファイル**は、開発ワークフローを高速化する方法です。
+オブジェクトを使用して、各ロケールの動作をカスタマイズすることもできます：
 
-自動入力メカニズムは、コンテンツ宣言ファイル間の _マスター・スレーブ_ 関係を通じて機能します。メイン（マスター）ファイルが更新されると、Intlayerはその変更を派生（自動入力された）宣言ファイルに自動的に適用します。
+```ts fileName="intlayer.config.ts"
+const config: IntlayerConfig = {
+  content: {
+    internationalization: {
+      locales: [Locales.ENGLISH, Locales.FRENCH, Locales.POLISH],
+      defaultLocale: Locales.ENGLISH,
+      requiredLocales: [Locales.ENGLISH], // Property 'pl' is missing in type '{ en: string; xxx } on your t function if を回避することをお勧めします
+    },
+  },
+  dictionary: {
+    fill: {
+      en: true, // 英語の現在のファイルを埋める・編集する
+      fr: "./translations/fr.json", // フランス語用に別ファイルを作成
+      es: false, // スペイン語の埋めを無効にする
+    },
+  },
+};
+```
+
+これにより、同じプロジェクト内の異なるロケールに対して異なるfill動作を設定できます。
 
 ```ts fileName="src/components/example/example.content.ts"
 import { Locales, type Dictionary } from "intlayer";
@@ -87,18 +106,18 @@ import { Locales, type Dictionary } from "intlayer";
 const exampleContent = {
   key: "example",
   locale: Locales.ENGLISH,
-  autoFill: "./example.content.json",
+  fill: "./example.content.json",
   content: {
-    contentExample: "これはコンテンツの例です", // コンテンツの例
+    contentExample: "This is an example of content",
   },
 } satisfies Dictionary;
 
 export default exampleContent;
 ```
 
-こちらは `autoFill` 指示を使用した[ロケール別コンテンツ宣言ファイル](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/per_locale_file.md)です。
+ここに `fill` 命令を使用した[ロケール単位のコンテンツ宣言ファイル](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/per_locale_file.md)があります。
 
-次に、以下のコマンドを実行すると：
+次に、以下のコマンドを実行します：
 
 ```bash packageManager="npm"
 npx intlayer fill --file 'src/components/example/example.content.ts'
@@ -116,7 +135,7 @@ pnpm intlayer fill --file 'src/components/example/example.content.ts'
 bun x intlayer fill --file 'src/components/example/example.content.ts'
 ```
 
-Intlayer は、メインファイルにまだ宣言されていないすべてのロケールを埋めて、派生した宣言ファイルを `src/components/example/example.content.json` に自動生成します。
+Intlayerは `src/components/example/example.content.json` に派生宣言ファイルを自動生成し、メインファイルでまだ宣言されていないすべてのロケールを埋めます。
 
 ```json5 fileName="src/components/example/example.content.json"
 {
@@ -133,7 +152,7 @@ Intlayer は、メインファイルにまだ宣言されていないすべて
 }
 ```
 
-その後、両方の宣言ファイルは単一の辞書にマージされ、標準の `useIntlayer("example")` フック（React）/ コンポーザブル（Vue）を使ってアクセス可能になります。
+その後、両方の宣言ファイルが単一の辞書にマージされ、標準の `useIntlayer("example")` hook（react）/composable（vue）を使用してアクセスできます。
 
 ## グローバル設定
 

package/docs/ja/bundle_optimization.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-11-25
-updatedAt: 2026-06-07
+updatedAt: 2026-08-09
 title: i18nバンドルサイズとパフォーマンスの最適化
 description: 国際化（i18n）コンテンツを最適化し、アプリケーションのバンドルサイズを削減します。Intlayerを使用して辞書のツリーシェイキングと遅延読み込みを活用する方法を学びます。
 keywords:
@@ -16,6 +16,12 @@ slugs:
   - concept
   - bundle-optimization
 history:
+  - version: 9.2.1
+    date: 2026-08-09
+    changes: "`purge` と `minify` が `@intlayer/swc` を通じて Next.js で動作するようになりました — `babel.config.js` は不要です"
+  - version: 8.12.0
+    date: 2026-06-24
+    changes: "リファレンス表で Babel プラグインを必要なパイプライン順（extract → purge → minify → optimize）で列挙"
   - version: 8.12.0
     date: 2026-06-07
     changes: "Babel/Webpack用の `intlayerPurgeBabelPlugin` と `intlayerMinifyBabelPlugin` を追加、プラグインのパイプラインを明確化"
@@ -191,12 +197,14 @@ Intlayerのビルド最適化は、それぞれ単一の責任を持つ複数の
 
 これらは、Webpackベースのセットアップ（Babelを使用したNext.js、CRA、カスタムWebpackなど）の `babel.config.js` で直接使用されます。
 
+以下の表は、必要なパイプライン順（`babel.config.js` に記述しなければならない順序と同じ）で列挙しています:
+
 | プラグイン                    | 役割                                                                                                                                      |
 | :---------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------- |
 | `intlayerExtractBabelPlugin`  | `.content.ts` ファイルをスキャンし、コンパイルされた辞書を `.intlayer/` に書き込みます                                                    |
-| `intlayerOptimizeBabelPlugin` | `useIntlayer('key')` を `useDictionary(hash)` に書き換え、一致する辞書の `import` を注入します                                            |
 | `intlayerPurgeBabelPlugin`    | すべてのソースファイルをスキャンし、コンパイルされた `.intlayer/**/*.json` から**未使用のフィールド**を削除します                         |
 | `intlayerMinifyBabelPlugin`   | JSONファイルとソースコードの両方で、**コンテンツフィールドキーを短いアルファベットのエイリアス**（例：`title` → `a`）に**名前変更**します |
+| `intlayerOptimizeBabelPlugin` | `useIntlayer('key')` を `useDictionary(hash)` に書き換え、一致する辞書の `import` を注入します                                            |
 
 > **プラグインの順序は重要です。** `babel.config.js` では、purgeとminifyのプラグインは、optimizeのプラグインの**前**に記述する必要があります。最適化パスは `useIntlayer('key')` を不透明な `useDictionary(hash)` 呼び出しに置き換えるため、purgeパスとminifyパスが使用されているフィールドを識別するために必要な辞書キー情報が消去されてしまいます。
 
@@ -205,9 +213,9 @@ Intlayerのビルド最適化は、それぞれ単一の責任を持つ複数の
 | オプションヘルパー           | 一緒に使用するプラグイン      |
 | :--------------------------- | :---------------------------- |
 | `getExtractPluginOptions()`  | `intlayerExtractBabelPlugin`  |
-| `getOptimizePluginOptions()` | `intlayerOptimizeBabelPlugin` |
 | `getPurgePluginOptions()`    | `intlayerPurgeBabelPlugin`    |
 | `getMinifyPluginOptions()`   | `intlayerMinifyBabelPlugin`   |
+| `getOptimizePluginOptions()` | `intlayerOptimizeBabelPlugin` |
 
 ### Vite プラグイン (`vite-intlayer`)
 
@@ -220,6 +228,20 @@ Viteユーザーは**これらを直接設定することはありません**。
 | Dictionary minify      | `intlayerMinifyBabelPlugin` のJSON書き込みパスと同じ                                    |
 | Babel transform        | `intlayerMinifyBabelPlugin` のソースコード名変更 + `intlayerOptimizeBabelPlugin` と同じ |
 
+### SWC プラグイン (`@intlayer/swc`)
+
+Next.js ユーザーも**これらを直接設定することはありません**。**v9.2.1** 以降、`next.config.ts` の `withIntlayer()` が `build.purge` と `build.minify` フラグだけを元に、パージ・ミニファイ・インポート書き換えというパイプライン全体を実行します。
+
+SWC の Wasm プラグインは一度に 1 ファイルしか変換できず、ファイルシステムにアクセスできないため、処理は 2 つに分かれています:
+
+| パス                                        | 実行場所                      | 処理内容                                                                                                         |
+| :------------------------------------------ | :---------------------------- | :--------------------------------------------------------------------------------------------------------------- |
+| 使用状況の解析 + JSON のパージ/ミニファイ   | Node、`withIntlayer()` の内部 | すべてのコンポーネントのソースファイルを読み取り、`.intlayer/**/*.json` を書き換え、リネームテーブルを生成します |
+| ソースの書き換え (`content.title` → `.a`)   | `@intlayer/swc` (Wasm)        | リネームテーブルをコード内の該当するプロパティアクセスに適用します                                               |
+| インポートの書き換え (`useIntlayer` → dict) | `@intlayer/swc` (Wasm)        | `intlayerOptimizeBabelPlugin` と同じ                                                                             |
+
+_どの_ フィールドが未使用か、そして各フィールドが _どの_ エイリアスを受け取るかを決定するには、ファイル横断の状態とファイル I/O が必要です。そのためこの半分は Node 上で実行され、SWC プラグインは生成されたテーブルだけを受け取ります。
+
 ## プラットフォーム別の設定
 
 <Tabs>
@@ -227,10 +249,12 @@ Viteユーザーは**これらを直接設定することはありません**。
 
 ### Next.js
 
-Next.jsはビルドにSWCを使用するため、最適化（インポートの書き換え）パスには `@intlayer/swc` プラグインが必要です。
+Next.js はビルドに SWC を使用するため、`@intlayer/swc` プラグインが必要です。**v9.2.1** 以降、このパッケージ 1 つでパイプライン全体 — 最適化（インポート書き換え）、パージ、ミニファイ — をカバーします。
 
 > SWCプラグインはNext.jsではまだ実験的であるため、このプラグインはデフォルトではインストールされません。将来的に変更される可能性があります。
 
+> **Next.js 16.1.0 が最小バージョンです。** SWC の前方互換な Wasm プラグイン ABI 上に構築された最初のリリースであり、それ以前のリリースはプラグインを拒否します。`withIntlayer` はプロジェクトの Next.js バージョンを読み取り、16.1.0 未満ではプラグインを登録しません — それらのビルドは引き続き成功し、単にバンドル最適化なしで実行されます。
+
 <Tabs>
  <Tab value="npm">
 
@@ -265,33 +289,40 @@ intlayer-swc-plugin = "*"
 
 インストールされると、Intlayerはプラグインを自動的に検出して使用します。
 
-**purgeおよびminify**パス（フィールドの削除とフィールドの名前変更）については、一緒に `@intlayer/babel` をインストールし、Babelプラグインを追加します。Next.jsは変換にSWCを使用しますが、プラグイン設定のために `babel.config.js` を評価するため、BabelプラグインはSWCの前の事前パスとして実行されます。
+**パージとミニファイ**のパス（フィールドの削除とリネーム）には、追加パッケージも `babel.config.js` も不要です。設定を `withIntlayer` でラップし、`intlayer.config.ts` でフラグを有効にしてください:
 
-```bash packageManager="npm"
-npm install -D @intlayer/babel
+```typescript fileName="next.config.ts"
+import { withIntlayer } from "next-intlayer/server";
+import type { NextConfig } from "next";
+
+const nextConfig: NextConfig = {/* あなたの設定 */};
+
+export default withIntlayer(nextConfig);
 ```
 
-```javascript fileName="babel.config.js"
-const {
-  intlayerPurgeBabelPlugin,
-  intlayerMinifyBabelPlugin,
-  getPurgePluginOptions,
-  getMinifyPluginOptions,
-} = require("@intlayer/babel");
+```typescript fileName="intlayer.config.ts"
+import type { IntlayerConfig } from "intlayer";
 
-module.exports = {
-  presets: ["next/babel"],
-  plugins: [
-    // Purge: .intlayer/**/*.json から未使用のコンテンツフィールドを削除します
-    [intlayerPurgeBabelPlugin, getPurgePluginOptions()],
-    // Minify: JSON + ソースコード内のコンテンツフィールドキーの名前を変更します
-    [intlayerMinifyBabelPlugin, getMinifyPluginOptions()],
-    // 注意: @intlayer/swc が useIntlayer → useDictionary の書き換えを処理するため、
-    // intlayerOptimizeBabelPluginはここでは不要です。
-  ],
+const config: IntlayerConfig = {
+  build: {
+    purge: true, // バンドルされた JSON から未使用のコンテンツフィールドを削除します
+    minify: true, // コンテンツフィールドのキーを短いエイリアスにリネームします
+  },
 };
+
+export default config;
 ```
 
+`next build` の実行中、`withIntlayer` はソースを解析し、コンパイル済み辞書を書き換え、生成されたフィールドのリネームテーブルを `@intlayer/swc` に渡します。プラグインはコード内の該当するプロパティアクセスを更新します。
+
+> `withIntlayerSync` ではなく、非同期の `withIntlayer` を使用してください。同期版は解析パイプラインを実行しないため、パージとミニファイは効果がありません。
+
+> パージとミニファイは `next build` 時にのみ実行されます — 最適化パイプラインは `next dev` 中は無効です。
+
+> 互換アダプターの呼び出し元が設定されている場合（`swcExtraCallers`。`@intlayer/next-intl` や `@intlayer/react-i18next` などの互換パッケージが設定します）も無効になります。これらの呼び出し箇所は使用状況アナライザーから見えないため、パージするとコードがまだ読んでいるフィールドを削除してしまいます。インポートの書き換えは有効なままです。
+
+**それ以前のバージョン（9.2.1 より前）** では `@intlayer/babel` と、`intlayerPurgeBabelPlugin` および `intlayerMinifyBabelPlugin` を宣言する `babel.config.js` が必要でした。このファイルはもう不要で、削除できます。
+
  </Tab>
  <Tab value="vite">
 
@@ -447,6 +478,8 @@ export default config;
 
 > `optimize` が `false` の場合、または `editor.enabled` が `true` の場合（ビジュアルエディタでは編集を可能にするために元のフィールド名が必要なため）、最小化はスキップされます。
 
+> Next.js では、`@intlayer/swc` がインストールされていない、または読み込めない場合（16.1.0 未満の Next.js）にもミニファイはスキップされます。ソース側のアクセスを書き換えるのはこのプラグインなので、これなしで辞書をリネームすると、コードが存在しないフィールド名を読むことになります。
+
 > `importMode: 'fetch'` 経由で読み込まれた辞書の場合も最小化はスキップされます。これは、そのJSONが元のフィールド名を使用してリモートAPIから提供されるためであり、クライアント側のキーの名前を変更するとサーバー/クライアントの規約が壊れるためです。
 
 ### パージ（Purging - 未使用フィールドの削除）
@@ -475,7 +508,7 @@ export default config;
 { "title": "…", "subtitle": "…" }
 ```
 
-> `optimize` が `false` の場合、または `editor.enabled` が `true` の場合、パージはスキップされます。
+> `optimize` が `false` の場合、または `editor.enabled` が `true` の場合、パージはスキップされます。 Next.js では、さらに `@intlayer/swc` が利用できない場合、および互換アダプターの呼び出し元が設定されている場合にもスキップされます。
 
 > ソースファイルが解析できない場合、または `useIntlayer` の結果が変数に割り当てられ、静的アナライザーが追跡できない方法（例：オブジェクトへのスプレッド、分割代入せずにプロップとして渡すなど）で渡された場合も、パージは保守的にスキップされます。このような場合は、完全な辞書が保持されます。
 

package/docs/ja/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-07-11
+updatedAt: 2026-08-06
 title: 設定 (Configuration)
 description: アプリケーションにIntlayerを設定する方法について説明します。ニーズに合わせてIntlayerをカスタマイズするためのさまざまな設定とオプションを理解してください。
 keywords:
@@ -14,6 +14,9 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 9.1.3
+    date: 2026-08-06
+    changes: "`routing.enableProxy` を三状態化: 未設定 (auto)、`true`、`false`"
   - version: 9.0.0
     date: 2026-07-11
     changes: "`analytics` 設定を追加"
@@ -235,6 +238,19 @@ const config: IntlayerConfig = {
      */
     mode: "prefix-no-default",
 
+    /**
+     * Intlayer のロケールルーティングプロキシ（ミドルウェア）を有効にします。
+     * dev、preview、SSR でのロケール検出・リダイレクト・リライトを担います。
+     * - 未設定 (auto): dev および preview サーバーは Cookie やヘッダーに保存された
+     *   ロケールを無視し、ルーティングを URL 駆動に保ちます。プレフィックスの解決、
+     *   ロケールの永続化、Accept-Language 検出は引き続き動作します。
+     *   本番環境では `true` と同じ挙動になります。
+     * - true: すべての環境で完全な挙動。
+     * - false: ロケールルーティングを行いません。
+     * デフォルト: undefined (auto)
+     */
+    enableProxy: undefined,
+
     /**
      * ユーザーが選択したロケールを保存する場所。
      * オプション: 'cookie', 'localStorage', 'sessionStorage', 'header', またはそれらの配列。
@@ -713,13 +729,14 @@ Intlayerアナリティクスに関する設定を定義します。ユーザー
 
 URL 構造、ロケール保存、ミドルウェア管理など、ルーティングの動作を制御する設定。
 
-| フィールド | 説明                                                                                                                                                                                                                       | 型                                                                                                                                                                                                           | デフォルト             | 例                                                                                                                                                                                                   | 備考                                                                                                                                                                                                                                                                                             |
-| ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `mode`     | ロケール管理のための URL ルーティングモード。                                                                                                                                                                              | `'prefix-no-default'` &#124; <br/> `'prefix-all'` &#124; <br/> `'no-prefix'` &#124; <br/> `'search-params'`                                                                                                  | `'prefix-no-default'`  | `'prefix-no-default'`: `/dashboard` (en) または `/fr/dashboard` (fr)。 `'prefix-all'`: `/en/dashboard`。 `'no-prefix'`: ロケールは他の手段で管理されます。 `'search-params'`: `/dashboard?locale=fr` | Cookie やロケール保存の管理には影響しません。                                                                                                                                                                                                                                                    |
-| `storage`  | クライアントでのロケール保存の設定。                                                                                                                                                                                       | `false` &#124; <br/> `'cookie'` &#124; <br/> `'localStorage'` &#124; <br/> `'sessionStorage'` &#124; <br/> `'header'` &#124; <br/> `CookiesAttributes` &#124; <br/> `StorageAttributes` &#124; <br/> `Array` | `['cookie', 'header']` | `'localStorage'` <br/> `[{ type: 'cookie', name: 'custom-locale', secure: true }]`                                                                                                                   | 下記の「保存オプション」の表を参照してください。                                                                                                                                                                                                                                                 |
-| `basePath` | アプリケーション URL のベースパス。                                                                                                                                                                                        | `string`                                                                                                                                                                                                     | `''`                   | `'/my-app'`                                                                                                                                                                                          | アプリが `https://example.com/my-app` にある場合、basePath は `'/my-app'` となり、URL は `https://example.com/my-app/en` のようになります。                                                                                                                                                      |
-| `rewrite`  | 特定のパスに対してデフォルトのルーティングモードを上書きするカスタム URL リライトルール。動的パラメータ `[param]` をサポートします。                                                                                       | `Record<string, StrictModeLocaleMap<string>>`                                                                                                                                                                | `undefined`            | 下記の例を参照してください                                                                                                                                                                           | • リライトルールは `mode` よりも優先されます。<br/>• Next.js および Vite で動作します。<br/>• `getLocalizedUrl()` は一致するルールを自動的に適用します。<br/>• [カスタム URL リライト](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/custom_url_rewrites.md)を参照してください。 |
-| `domains`  | ドメインベースのルーティングのために、ロケールをドメインのホスト名にマップします。設定されている場合、そのロケールのURLはパスのベースとしてそのドメインを使用し（絶対URL）、パスにロケールプレフィックスは追加されません。 | `Partial<Record<Locale, string>>`                                                                                                                                                                            | `undefined`            | `{ zh: 'intlayer.zh', fr: 'intlayer.org' }`                                                                                                                                                          | • ホスト名に含まれていない場合、デフォルトのプロトコルは `https://` です。<br/>• ドメイン自体がロケールを識別するため、`/zh/` プレフィックスは追加されません。<br/>• `getLocalizedUrl('/', 'zh')` は `https://intlayer.zh/` を返します。                                                         |
+| フィールド    | 説明                                                                                                                                                                                                                       | 型                                                                                                                                                                                                           | デフォルト             | 例                                                                                                                                                                                                   | 備考                                                                                                                                                                                                                                                                                                                                                                   |
+| ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `mode`        | ロケール管理のための URL ルーティングモード。                                                                                                                                                                              | `'prefix-no-default'` &#124; <br/> `'prefix-all'` &#124; <br/> `'no-prefix'` &#124; <br/> `'search-params'`                                                                                                  | `'prefix-no-default'`  | `'prefix-no-default'`: `/dashboard` (en) または `/fr/dashboard` (fr)。 `'prefix-all'`: `/en/dashboard`。 `'no-prefix'`: ロケールは他の手段で管理されます。 `'search-params'`: `/dashboard?locale=fr` | Cookie やロケール保存の管理には影響しません。                                                                                                                                                                                                                                                                                                                          |
+| `enableProxy` | Intlayer のロケールルーティングプロキシ（ミドルウェア）を有効にします。                                                                                                                                                    | `boolean` &#124; <br/> `undefined`                                                                                                                                                                           | `undefined` (auto)     | `true`                                                                                                                                                                                               | • 未設定 (auto): dev / preview サーバーは Cookie・ヘッダーに保存されたロケールをリダイレクト元として無視します。プレフィックス、永続化、`Accept-Language` 検出は引き続き動作します。本番環境では `true` と同じ挙動です。<br/>• `true`: どこでも完全な挙動。<br/>• `false`: ロケールルーティングなし。Next.js では `intlayerProxy` ミドルウェアがパススルーになります。 |
+| `storage`     | クライアントでのロケール保存の設定。                                                                                                                                                                                       | `false` &#124; <br/> `'cookie'` &#124; <br/> `'localStorage'` &#124; <br/> `'sessionStorage'` &#124; <br/> `'header'` &#124; <br/> `CookiesAttributes` &#124; <br/> `StorageAttributes` &#124; <br/> `Array` | `['cookie', 'header']` | `'localStorage'` <br/> `[{ type: 'cookie', name: 'custom-locale', secure: true }]`                                                                                                                   | 下記の「保存オプション」の表を参照してください。                                                                                                                                                                                                                                                                                                                       |
+| `basePath`    | アプリケーション URL のベースパス。                                                                                                                                                                                        | `string`                                                                                                                                                                                                     | `''`                   | `'/my-app'`                                                                                                                                                                                          | アプリが `https://example.com/my-app` にある場合、basePath は `'/my-app'` となり、URL は `https://example.com/my-app/en` のようになります。                                                                                                                                                                                                                            |
+| `rewrite`     | 特定のパスに対してデフォルトのルーティングモードを上書きするカスタム URL リライトルール。動的パラメータ `[param]` をサポートします。                                                                                       | `Record<string, StrictModeLocaleMap<string>>`                                                                                                                                                                | `undefined`            | 下記の例を参照してください                                                                                                                                                                           | • リライトルールは `mode` よりも優先されます。<br/>• Next.js および Vite で動作します。<br/>• `getLocalizedUrl()` は一致するルールを自動的に適用します。<br/>• [カスタム URL リライト](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/custom_url_rewrites.md)を参照してください。                                                                       |
+| `domains`     | ドメインベースのルーティングのために、ロケールをドメインのホスト名にマップします。設定されている場合、そのロケールのURLはパスのベースとしてそのドメインを使用し（絶対URL）、パスにロケールプレフィックスは追加されません。 | `Partial<Record<Locale, string>>`                                                                                                                                                                            | `undefined`            | `{ zh: 'intlayer.zh', fr: 'intlayer.org' }`                                                                                                                                                          | • ホスト名に含まれていない場合、デフォルトのプロトコルは `https://` です。<br/>• ドメイン自体がロケールを識別するため、`/zh/` プレフィックスは追加されません。<br/>• `getLocalizedUrl('/', 'zh')` は `https://intlayer.zh/` を返します。                                                                                                                               |
 
 **`rewrite` の例**:
 

package/docs/ja/dictionary/content_file.md

@@ -607,13 +607,6 @@ export default aboutPageMetaContent;
 
 辞書が外部ソースから自動的に補完されたかどうかを示します。競合が発生した場合、ベース辞書が自動補完された辞書より優先されます。
 
-##### `location` ('distant' | 'locale')
-
-辞書の場所を示します：
-
-- `'locale'`: ローカル辞書（コンテンツファイルから）
-- `'distant'`: リモート辞書（外部ソースから）
-
 ## コンテンツノードタイプ
 
 Intlayerは、基本的なプリミティブ値を拡張するいくつかの専門的なコンテンツノードタイプを提供します。
@@ -650,6 +643,21 @@ conditionalContent: cond({
 
 > 詳細については、 [条件コンテンツ (`cond`) ドキュメント](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/dictionary/condition.md) を参照してください。
 
+### 複数形コンテンツ (`plural`)
+
+複数形ルールに基づいて変わるコンテンツ:
+
+```typescript
+import { plural } from "intlayer";
+
+pluralContent: plural({
+  one: "One car",
+  other: "{{count}} cars",
+});
+```
+
+> 詳細については、[Plural Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/dictionary/plural.md) を参照してください。
+
 ### 列挙コンテンツ (`enu`)
 
 列挙された値に基づいて変化するコンテンツ：

package/docs/ja/dictionary/file.md

@@ -23,7 +23,9 @@ history:
 author: aymericzip
 ---
 
-# ファイルコンテンツ / Intlayerでのファイル埋め込み
+# Intlayerでのファイルコンテンツ / ファイルの埋め込み
+
+Intlayerでは、`file`関数により外部ファイルのコンテンツを辞書に埋め込むことができます。このアプローチにより、Intlayerがソースファイルを認識し、Intlayer Visual EditorおよびCMSとのシームレスな統合が可能になります。
 
 ## ファイル埋め込みの仕組み