@intlayer/docs 9.1.2 → 9.2.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/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とのシームレスな統合が可能になります。
 
 ## ファイル埋め込みの仕組み
 

package/docs/ja/dictionary/nesting.md

@@ -64,6 +64,53 @@ export default firstDictionary;
 }
 ```
 
+### Nestを使用した参照
+
+次に、`nest`関数を使用して上記のコンテンツを参照する別のコンテンツモジュールを作成します。コンテンツ全体または特定のネストされた値を参照できます:
+
+```typescript fileName="secondDictionary.content.ts" contentDeclarationFormat={["typescript", "esm", "commonjs"]}
+import { nest, type Dictionary } from "intlayer";
+
+const myNestingContent = {
+  key: "key_of_my_second_dictionary",
+  content: {
+    // 辞書全体を参照します:
+    fullNestedContent: nest("key_of_my_first_dictionary"),
+    // 特定のネストされた値を参照します:
+    partialNestedContent: nest(
+      "key_of_my_first_dictionary",
+      "subContent.contentNumber"
+    ),
+  },
+} satisfies Dictionary;
+
+export default myNestingContent;
+```
+
+```json fileName="secondDictionary.content.json" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "key_of_my_second_dictionary",
+  "content": {
+    "fullNestedContent": {
+      "nodeType": "nested",
+      "nested": {
+        "dictionaryKey": "key_of_my_first_dictionary"
+      }
+    },
+    "partialNestedContent": {
+      "nodeType": "nested",
+      "nested": {
+        "dictionaryKey": "key_of_my_first_dictionary",
+        "path": "subContent.contentNumber"
+      }
+    }
+  }
+}
+```
+
+2番目のパラメーターとして、そのコンテンツ内のネストされた値へのパスを指定できます。パスが指定されない場合、参照された辞書のコンテンツ全体が返されます。
+
 ## ネストの設定
 
 <Tabs group="framework">
@@ -258,36 +305,6 @@ document.getElementById("nested")!.textContent = content.partialNestedContent;
   </Tab>
 </Tabs>
 
-## React Intlayerでのネストの使用
-
-Reactコンポーネントでネストされたコンテンツを使用するには、`react-intlayer`パッケージの`useIntlayer`フックを活用します。このフックは、指定されたキーに基づいて正しいコンテンツを取得します。以下はその使用例です:
-
-```tsx fileName="**/*.tsx" codeFormat={["typescript", "esm"]}
-import type { FC } from "react";
-import { useIntlayer } from "react-intlayer";
-
-const NestComponent: FC = () => {
-  const { fullNestedContent, partialNestedContent } = useIntlayer(
-    "key_of_my_second_dictionary"
-  );
-
-  return (
-    <div>
-      <p>
-        Full Nested Content: {JSON.stringify(fullNestedContent)}
-        {/* 出力: {"content": "content", "subContent": {"contentNumber": 0, "contentString": "string"}} */}
-      </p>
-      <p>
-        Partial Nested Value: {partialNestedContent}
-        {/* 出力: 0 */}
-      </p>
-    </div>
-  );
-};
-
-export default NestComponent;
-```
-
 ## 追加リソース
 
 設定や使用方法の詳細については、以下のリソースを参照してください: