@intlayer/docs 9.3.3 → 9.4.0

package/docs/ja/benchmark/tanstack.md

@@ -196,6 +196,8 @@ GitHubのスターは、プロジェクトの普及度、コミュニティの
 
 TanStack Startでは反応性の問題もありました。ロケール変更時にプロバイダーを強制的に再レンダリングし、ロケール変更イベントを購読して、別の言語でのロードが正しく動作するようにする必要がありました。
 
+TanStack Start でも反応性の問題がありました。ロケール変更時にプロバイダーを強制的に再レンダリングし、locale-change イベントをサブスクライブして、別の言語での読み込みが正しく動作するようにする必要がありました。
+
 **(use-intl)** (`use-intl@4.9.1`):
 
 `use-intl`は、Reactエコシステムにおける最もファッショナブルな「intl」の一部であり（`next-intl`と同じファミリー）、AIエージェントによって頻繁に推奨されますが、パフォーマンス重視の設定においては間違いであるというのが私の見解です。導入は比較的簡単です。しかし実際には、リークを最適化し制限するプロセスは非常に複雑です。同様に、動的ロード、ネームスぺーシング、TypeScriptの型を組み合わせると、開発が著しく遅くなります。
@@ -208,6 +210,8 @@ TanStack Startでは、Next.js特有の罠（`setRequestLocale`、静的レン
 
 それでも、`t('a.b.c')`上に構築されたスタックと同じ大きな欠点を共有しています。最適化は可能ですが非常に時間がかかり、大規模プロジェクトでは悪い習慣（ネームスペース、動的ロード、型）に陥るリスクがあります。
 
+このパッケージは特に重い (~17.3kb、これは `react-intlayer` の約 3.5 倍)。
+
 メッセージ形式も異なります。`use-intl`はICU MessageFormatを使用しますが、`i18next`は独自の形式を使用しており、これらを混ぜるとツールや移行が複雑になります。
 
 **(Lingui)** (`@lingui/core@5.3.0`):
@@ -218,6 +222,8 @@ TanStack Startでは、Next.js特有の罠（`setRequestLocale`、静的レン
 
 `react-intl`は、Format.jsチームによるパフォーマンス重視の実装です。DXは冗長なままです。`const intl = useIntl()` + `intl.formatMessage({ id: "xx.xx" })`は複雑さを増し、JavaScriptの余分な作業を増やし、グローバルなi18nインスタンスをReactツリーの多くのノードに結びつけます。
 
+このパッケージは重い（~14.4kb で、`react-intlayer` の約 3 倍）です。
+
 ### 4 - 推奨事項
 
 このTanStack Startベンチマークには、`next-translate`（Next.jsプラグイン + `getStaticProps`）に直接相当するものはありません。成熟したエコシステムと`t()` APIを切望するチームにとって、`react-i18next`や`use-intl`は「妥当な」選択肢であり続けますが、リークを回避するための最適化には多くの時間を投資することを覚悟してください。

package/docs/ja/bundle_optimization.md

@@ -476,7 +476,7 @@ const config: IntlayerConfig = {
 export default config;
 ```
 
-> `optimize` が `false` の場合、または `editor.enabled` が `true` の場合（ビジュアルエディタでは編集を可能にするために元のフィールド名が必要なため）、最小化はスキップされます。
+> `optimize` が `false` の場合、最小化はスキップされます。`editor.enabled` が `true` の場合でも実行されますが、フィールドのリネーム処理は行われません — ビジュアルエディタは `keyPath` で編集内容を解決するため、元のフィールド名を維持する必要があります。
 
 > Next.js では、`@intlayer/swc` がインストールされていない、または読み込めない場合（16.1.0 未満の Next.js）にもミニファイはスキップされます。ソース側のアクセスを書き換えるのはこのプラグインなので、これなしで辞書をリネームすると、コードが存在しないフィールド名を読むことになります。
 
@@ -508,7 +508,7 @@ export default config;
 { "title": "…", "subtitle": "…" }
 ```
 
-> `optimize` が `false` の場合、または `editor.enabled` が `true` の場合、パージはスキップされます。 Next.js では、さらに `@intlayer/swc` が利用できない場合、および互換アダプターの呼び出し元が設定されている場合にもスキップされます。
+> `optimize` が `false` の場合、パージはスキップされます。`editor.enabled` が `true` の場合でも有効なままです — パージされたフィールドはどのコンポーネントからも読み取られないため、エディタがそれを描画することはありません。Next.js では、さらに `@intlayer/swc` が利用できない場合、および互換アダプターの呼び出し元が設定されている場合にもスキップされます。
 
 > ソースファイルが解析できない場合、または `useIntlayer` の結果が変数に割り当てられ、静的アナライザーが追跡できない方法（例：オブジェクトへのスプレッド、分割代入せずにプロップとして渡すなど）で渡された場合も、パージは保守的にスキップされます。このような場合は、完全な辞書が保持されます。
 

package/docs/ja/cli/build.md

@@ -72,22 +72,8 @@ bun x intlayer build --watch
 
   > 例: `npx intlayer build --base-dir ./src`
 
-- **`--env`**: 環境を指定します（例：`development`、`production`）。intlayerの設定ファイルで環境変数を使用している場合に便利です。
-
-  > 例: `npx intlayer build --env production`
-
-- **`--env-file`**: 変数を読み込むためのカスタム環境ファイルを指定します。intlayerの設定ファイルで環境変数を使用している場合に便利です。
-
-  > 例: `npx intlayer build --env-file .env.production.local`
-
 - **`--with`**: ビルドと並行してコマンドを開始します。
 
-- **`--base-dir`**: プロジェクトのベースディレクトリを指定します。intlayerの設定を取得するために、コマンドはベースディレクトリ内の `intlayer.config.{ts,js,json,cjs,mjs}` ファイルを探します。
-
-  > 例: `npx intlayer build --base-dir ./src`
-
-- **`--env`**: 環境を指定します（例：`development`、`production`）。intlayerの設定ファイルで環境変数を使用している場合に便利です。
-
   > 例: `npx intlayer build --env production`
 
 - **`--env-file`**: 変数を読み込むためのカスタム環境ファイルを指定します。intlayerの設定ファイルで環境変数を使用している場合に便利です。

package/docs/ja/cli/ci.md

@@ -130,6 +130,8 @@ bun x intlayer ci fill --verbose --mode complete
 
 CI/CD設定（例：GitHub Actions、GitLab CI）で、`INTLAYER_PROJECT_CREDENTIALS`をシークレットとして設定します：
 
+> **AI access**: `fill` コマンドは翻訳を生成するために AI アクセスが必要です。`ci` から `INTLAYER_PROJECT_CREDENTIALS` (Intlayer CMS アクセスキー) によって注入された認証情報は、Intlayer バックエンドを通じて AI アクセスを付与するため、別の AI プロバイダーキーは必要ありません。代わりに自分のプロバイダーキーを使用したい場合は、`--provider`、`--model`、および `--api-key` を `intlayer ci fill` に渡してください。`test` コマンドは AI アクセスを必要としません。
+
 ```yaml
 # GitHub Actionsの例
 env:

package/docs/ja/cli/doc-review.md

@@ -91,8 +91,16 @@ bun x intlayer doc review
 
 - **`--log`**: ログ出力のみモード。AIによる翻訳は行わず、代わりに別のエージェントが翻訳を生成できるように、ベースロケールとターゲットロケールで注意が必要なブロック（行番号と内容を含む）をログ出力します。
 
+- `apply`: AI を使用して異なるブロックを翻訳し、ファイルを作成します。
+- `report`: AI を呼び出さず、ベースと対象ロケールのブロック（行番号とコンテンツ付き）で注意が必要なものをログして、別のエージェントが翻訳を生成できるようにします。
+- `synthesis`: AI を呼び出さず、ブロックごとの出力をスキップし、最新のドキュメントと編集が必要なドキュメントの最終的な概要のみをログします。
+
   > 例: `npx intlayer doc review --log`
 
+  > 例: `npx intlayer doc review --mode synthesis`
+
+どのモードであっても、実行は、ベースドキュメントと一致しているドキュメントと、まだ編集するブロックがあるドキュメントをリストアップするサマリーで終了します。
+
 **エントリー出力オプション:**
 
 - **`--locales [locales...]`**: ドキュメントをレビューする対象のロケール。

package/docs/ja/cli/fill.md

@@ -39,14 +39,6 @@ bun x intlayer fill
 
 このコマンドは、翻訳の欠落、構造の不整合、型の不一致などの潜在的な問題を検出するために、コンテンツ宣言ファイルを解析します。問題が見つかった場合、**intlayer fill** は辞書を一貫性があり完全な状態に保つために、更新を提案または適用します。
 
-重要なポイント：
-
-- AIモデルのコンテキストウィンドウの制限内に収まるように、大きなJSONファイルをチャンクに分割します。
-- 出力形式が正しくない場合、翻訳を再試行します。
-- 翻訳の精度を向上させるために、アプリケーション固有およびファイル固有のコンテキストを組み込みます。
-- 既存の翻訳を上書きしないことで、既存の翻訳を保持します。
-- キューシステムを使用してファイル、チャンク、ロケールを並列処理し、速度を向上させます。
-
 ## 主なポイント:
 
 - 大規模なJSONファイルをチャンクに分割して、AIモデルのコンテキストウィンドウ制限内に収まるようにします。

package/docs/ja/cli/index.md

@@ -127,6 +127,8 @@ Intlayerは、複数の設定ファイル形式をサポートしています：
 
 - **[Login](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/cli/login.md)** - Intlayer CMSで認証し、アクセス資格情報を取得します。
 
+> `intlayer login` は、すべての認証されたコマンドが使用する **access key** (`clientId` / `clientSecret`) を発行します。シークレットはサーバー側の認証情報であり、クライアント bundle に到達することはありません — [access key の安全な保管](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/cli/login.md#access-key-の安全な保管)を参照してください。
+
 ### コアコマンド
 
 - **[Build Dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/cli/build.md)** - コンテンツ宣言ファイルからディクショナリをビルドします。

package/docs/ja/cli/list_projects.md

@@ -52,8 +52,6 @@ bun x intlayer projects list
 
   > 例: `npx intlayer projects list --base-dir /path/to/workspace`
 
-  > 例: `npx intlayer projects list --base-dir /path/to/workspace`
-
 - **`--git-root`**: ベースディレクトリではなく git ルートディレクトリから検索します。モノレポや git リポジトリ内のすべての Intlayer プロジェクトを見つけるのに便利です。
 
   > 例: `npx intlayer projects list --git-root`

package/docs/ja/cli/login.md

@@ -118,6 +118,34 @@ INTLAYER_CLIENT_SECRET=your_client_secret
 }
 ```
 
+## アクセスキーの安全性を保つ
+
+`intlayer login` は **アクセスキー** を発行します: `clientId` / `clientSecret` のペアで、すべての認証済みコマンド (`push`, `pull`, `fill`, `configuration push`, `live`, …) が認証に使用します。
+
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  editor: {
+    clientId: process.env.INTLAYER_CLIENT_ID,
+    clientSecret: process.env.INTLAYER_CLIENT_SECRET,
+  },
+};
+
+export default config;
+```
+
+> **`clientSecret` はサーバー側の認証情報です。** プロジェクト範囲の完全な API アクセスを付与します — 辞書、プロジェクト、組織の読み書きができます。`.env` (git で無視) または CI シークレットストアに保管し、設定ファイルにインラインで記述しないでください。
+
+Intlayer はこれを単にドキュメント化するのではなく、強制します:
+
+- `clientSecret` はバンドラーがインラインする設定から **削除される** ため、使用するフレームワーク統合に関わらず、ブラウザバンドルに到達することはできません。サーバー側でのみ、ランタイムで環境から読み込まれます。
+- `clientId` は異なります: これは **公開** プロジェクトキーで、安全に配布でき、[`@intlayer/analytics`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/analytics.md#how-events-are-authenticated) で短時間有効な取り込み専用トークンを取得するために使用されます。
+
+`clientId` をコメントアウトするだけで、環境変数がまだ定義されていても、すべての認証済み動作 — リモート辞書フェッチ、CMS アクセス、analytics — を無効にするのに十分です。
+
+CI パイプラインの場合、[`ci` コマンド](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/cli/ci.md) を使用することをお勧めします。これは単一実行の期間中認証情報を注入し、永続化せず代わりに。
+
 ## 手動設定
 
 ブラウザが自動で開かない場合、ターミナルに表示されている URL を手動で開いてください。

package/docs/ja/cli/push.md

@@ -89,25 +89,10 @@ bun x intlayer dictionary push
 
   > 例: `npx intlayer dictionary push --keep-locale-dictionary`
 
-**準備オプション:**
-
-- **`--build`**: プッシュする前に辞書をビルドして、内容が最新であることを確認します。true はビルドを強制し、false はビルドをスキップし、undefined はビルドのキャッシュを使用することを許可します。
-
 **ログオプション:**
 
 - **`--verbose`**: デバッグのために詳細なログを有効にします。（CLIではデフォルトでtrue）
 
-**Gitオプション:**
-
-- **`--git-diff`**: ベース（デフォルトは `origin/main`）から現在のブランチ（デフォルトは `HEAD`）への変更を含む辞書のみで実行します。
-- **`--git-diff-base`**: git diff のベース参照を指定します（デフォルトは `origin/main`）。
-- **`--git-diff-current`**: git diff の現在の参照を指定します（デフォルトは `HEAD`）。
-- **`--uncommitted`**: コミットされていない変更を含めます。
-- **`--unpushed`**: プッシュされていない変更を含めます。
-- **`--untracked`**: トラッキングされていないファイルを含めます。
-
-- **`--build`**: プッシュ前に辞書をビルドして、内容が最新であることを保証します。`true` はビルドを強制し、`false` はビルドをスキップし、`undefined` はビルドのキャッシュを使用することを許可します。
-
 **ログオプション:**
 
 - **`--verbose`**: デバッグのために詳細なログ出力を有効にします。（CLIではデフォルトでtrue）

package/docs/ja/compiler.md

@@ -45,6 +45,12 @@ author: aymericzip
 - **開発者体験**: コンテンツ宣言を使用箇所にそのまま保持し、保守性を向上させます。
 - **ライブアップデート**: 開発中に即時フィードバックを得られるホットモジュールリプレースメント（HMR）をサポートします。
 
+- **Speed**: 最適化されたコンテンツ抽出により、ビルドプロセスの速度が維持されます。
+
+- **Developer Experience**: コンテンツ宣言を使用される場所に保つことで、保守性を向上させます。
+
+- **ライブ更新**: 開発中の即座なフィードバックのための Hot Module Replacement (HMR) をサポートしています。
+
 より詳しい比較については、[Compiler vs. Declarative i18n](https://github.com/aymericzip/intlayer/blob/main/docs/blog/ja/compiler_vs_declarative_i18n.md) のブログ記事をご覧ください。
 
 ## Intlayer コンパイラーを使わない理由
@@ -54,6 +60,8 @@ author: aymericzip
 - **ヒューリスティックの曖昧さ**：コンパイラーは、ユーザー向けコンテンツとアプリケーションロジック（例：`className="active"`、ステータスコード、製品ID）を推測する必要があります。複雑なコードベースでは、これにより誤検出や見逃された文字列が発生し、手動での注釈と例外処理が必要になる場合があります。
 - **静的抽出のみ**：コンパイラーベースの抽出は静的解析に依存しています。実行時のみ存在する文字列（APIエラーコード、CMSフィールドなど）は、コンパイラー単独では発見または翻訳できないため、補完的なランタイムi18n戦略が必要です。
 
+- **静的のみの抽出**: コンパイラベースの抽出は静的分析に依存します。実行時にのみ存在する文字列（APIエラーコード、CMS フィールドなど）はコンパイラだけでは検出または翻訳できないため、補完的なランタイム i18n 戦略が必要です。
+
 より深いアーキテクチャの比較については、ブログ記事[Compiler vs. Declarative i18n](https://github.com/aymericzip/intlayer/blob/main/docs/blog/ja/compiler_vs_declarative_i18n.md)を参照してください。
 
 代替として、コンテンツの完全な制御を維持しながらi18nプロセスを自動化するために、Intlayerは自動抽出コマンド `intlayer extract`（[CLIドキュメント](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/cli/extract.md)を参照）またはIntlayer VS Code拡張機能の `Intlayer: extract content to Dictionary` コマンド（[VS Code拡張機能ドキュメント](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/vs_code_extension.md)を参照）も提供しています。
@@ -94,10 +102,14 @@ export default defineConfig({
 });
 ```
 
+> スタンドアロン `intlayerCompiler()` プラグインは、高度なセットアップのためにエクスポートされています。`intlayer()` と一緒に登録するのは安全です — コンパイラが自動的に重複を排除し、1 回だけ実行されます。
+
 See complete tutorial: [Intlayer Compiler with Vite+React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_vite+react_compiler.md)
 
 #### フレームワークサポート
 
+Vite プラグインは異なるファイルタイプを自動的に検出して処理します:
+
 Viteプラグインは自動的に異なるファイルタイプを検出し処理します：
 
 - **React / JSX / TSX**: ネイティブに対応。
@@ -106,6 +118,8 @@ Viteプラグインは自動的に異なるファイルタイプを検出し処
 
 使用しているフレームワークに応じて、適切なコンパイラーパッケージをインストールしてください：
 
+お使いのフレームワークに適切なコンパイラーパッケージをインストールしてください：
+
 ```bash
 # Vue用
 npm install @intlayer/vue-compiler

package/docs/ja/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-08-06
+updatedAt: 2026-08-22
 title: 設定 (Configuration)
 description: アプリケーションにIntlayerを設定する方法について説明します。ニーズに合わせてIntlayerをカスタマイズするためのさまざまな設定とオプションを理解してください。
 keywords:
@@ -14,6 +14,9 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 9.3.3
+    date: 2026-08-22
+    changes: "`@intlayer/analytics` がインストールされている場合、アナリティクスをデフォルトで有効化"
   - version: 9.1.3
     date: 2026-08-06
     changes: "`routing.enableProxy` を三状態化: 未設定 (auto)、`true`、`false`"
@@ -380,8 +383,8 @@ const config: IntlayerConfig = {
   analytics: {
     /**
      * アナリティクス収集を有効にするかどうか（ページビュー、コンテンツの露出、A/Bイベント）。
-     * 帰属（attribution）のために `editor.clientId` の設定が必要です。
-     * デフォルト: false
+     * `@intlayer/analytics` がインストールされ、帰属（attribution）のために `editor.clientId` が設定されている必要があります。
+     * デフォルト: true
      */
     enabled: true,
 
@@ -728,19 +731,17 @@ export default config;
 | `liveSyncPort`               | Live Sync サーバーのポート。                                                                                                                                                                 | `number`                          | `4000`                              | `4000`                                                                                          |                                                                                                                                                                                                                                                      |
 | `liveSyncURL`                | Live Sync サーバーの URL。                                                                                                                                                                   | `string`                          | `'http://localhost:{liveSyncPort}'` | `'https://example.com'`                                                                         | デフォルトで localhost を指します。リモートの Live Sync サーバーを使用する場合は変更可能です。                                                                                                                                                       |
 
----
-
 ### アナリティクス設定 (Analytics)
 
 Intlayerアナリティクスに関する設定を定義します。ユーザーに実際に表示されたコンテンツ（ページビュー、コンテンツの露出）を収集し、コンテンツのA/Bテストを可能にします。
 
-アナリティクスは厳密にオプトイン方式です。`analytics.enabled` が明示的に `true` に設定され、**かつ** 帰属のためのプロジェクトキー（`editor.clientId`）が設定されない限り、何も収集されません。無効の場合（デフォルト）、アナリティクスの統合全体がアプリケーションのバンドルから削除されます（デッドコード除去）。
+アナリティクスはオプトアウト方式です。デフォルトで有効であり、`@intlayer/analytics` パッケージがインストールされ、**かつ** 帰属のためのプロジェクトキー（`editor.clientId`）が設定されるとすぐに収集を開始します。`analytics.enabled` を `false` にする（またはパッケージをインストールしない）と、アナリティクスの統合全体がアプリケーションのバンドルから削除されます（デッドコード除去）。
 
-| フィールド      | 説明                                                                              | 型        | デフォルト | 例      | 備考                                                                                                                                       |
-| --------------- | --------------------------------------------------------------------------------- | --------- | ---------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
-| `enabled`       | アナリティクス収集を有効にします（ページビュー、コンテンツの露出、A/Bイベント）。 | `boolean` | `false`    | `true`  | 帰属のために `editor.clientId` の設定が必要です。設定されていない場合、`enabled` が `true` でもアナリティクスは無効のままです。            |
-| `flushInterval` | バックエンドへの自動バッチ送信間のミリ秒数。                                      | `number`  | `20000`    | `10000` |                                                                                                                                            |
-| `sampleRate`    | 記録するセッションの割合。`0`（なし）から`1`（すべて）まで。                      | `number`  | `1`        | `0.5`   | サンプリングはセッションごとに決定的であるため、記録されたセッションはそのすべてのイベントを報告します（部分的なファネルにはなりません）。 |
+| フィールド      | 説明                                                                              | 型        | デフォルト | 例      | 備考                                                                                                                                                                              |
+| --------------- | --------------------------------------------------------------------------------- | --------- | ---------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `enabled`       | アナリティクス収集を有効にします（ページビュー、コンテンツの露出、A/Bイベント）。 | `boolean` | `true`     | `false` | `@intlayer/analytics` がインストールされ、帰属のために `editor.clientId` が設定されている必要があります。そうでない場合、`enabled` が `true` でもアナリティクスは無効のままです。 |
+| `flushInterval` | バックエンドへの自動バッチ送信間のミリ秒数。                                      | `number`  | `20000`    | `10000` |                                                                                                                                                                                   |
+| `sampleRate`    | 記録するセッションの割合。`0`（なし）から`1`（すべて）まで。                      | `number`  | `1`        | `0.5`   | サンプリングはセッションごとに決定的であるため、記録されたセッションはそのすべてのイベントを報告します（部分的なファネルにはなりません）。                                        |
 
 ---
 
@@ -979,6 +980,13 @@ Intlayerの内部パスと出力結果に関連する設定。これらの設定
 
 ### 辞書設定 (Dictionary)
 
+辞書操作を制御する設定。自動入力動作とコンテンツ生成を含みます。
+
+このディクショナリ設定には、主に2つの目的があります：
+
+1. **デフォルト値**: コンテンツ宣言ファイルを作成する際にデフォルト値を定義する
+2. **フォールバック動作**: 特定のフィールドが定義されていない場合にフォールバック値を提供し、辞書操作の動作をグローバルに定義できるようにする
+
 自動入力動作やコンテンツ生成など、辞書操作を制御するパラメータ。
 
 | フィールド                  | 説明                                                                                                                                          | 型                                                                                                              | デフォルト   | 例                                                                                          | 備考                                                                                                                                                                                                                                                                                                                                                                                                      |
@@ -1020,8 +1028,6 @@ Intlayer からのログ出力をカスタマイズするためのパラメー
 | `mode`     | ロガーのモードを指定します。     | `'default'` &#124; <br/> `'verbose'` &#124; <br/> `'disabled'` | `'default'`     | `'verbose'`      | • `'verbose'`: デバッグ用により多くの情報を出力します。<br/>• `'disabled'`: ロガーを完全に無効にします。 |
 | `prefix`   | ログメッセージのプレフィックス。 | `string`                                                       | `'[intlayer] '` | `'[my prefix] '` |                                                                                                          |
 
----
-
 ### AI 設定 (AI)
 
 プロバイダー、モデル、API キーなど、Intlayer の AI 機能を制御する設定。
@@ -1061,8 +1067,6 @@ Intlayer は、柔軟性を最大限に高めるために複数の AI プロバ
 | `baseURL`            | AI API のベース URL。                                                                                                                            | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                             | なし        | `'https://api.openai.com/v1'` <br/> `'http://localhost:5000'` | ローカルまたはカスタムの AI API エンドポイントを指すことができます。                                                                                                                                                 |
 | `dataSerialization`  | AI 機能のデータシリアライゼーション形式。                                                                                                        | `'json'` &#124; <br/> `'toon'`                                                                                                                                                                                                                                                                                                                                                                                                                       | `undefined` | `'toon'`                                                      | • `'json'`: デフォルト、信頼性が高いがトークン消費が多い。<br/>• `'toon'`: トークン消費が少ないが、一貫性に欠ける。<br/>• 推論の努力 (reasoning effort) などの追加パラメータがコンテキストとしてモデルに渡されます。 |
 
----
-
 ### ビルド設定 (Build)
 
 Intlayer がアプリケーションの国際化をどのように最適化およびコンパイルするかを制御するパラメータ。
@@ -1100,8 +1104,6 @@ Intlayer がアプリケーションの国際化をどのように最適化お
 | `noMetadata`          | `true` の場合、出力から辞書のメタデータ (キー、コンテンツラッパー) を除外します。                                                                                                                                                                                                                                  | `boolean`                                                                                                       | `false`     | `false` → `{"key":"my-key","content":{"key":"value"}}` <br/> `true` → `{"key":"value"}`                                                                  | • i18next や ICU MessageFormat JSON 出力に有用。<br/>• `loadJSON` プラグインと組み合わせて使用。                                                                                        |
 | `dictionaryKeyPrefix` | 辞書のキープレフィックス                                                                                                                                                                                                                                                                                           | `string`                                                                                                        | `''`        |                                                                                                                                                          | 抽出された辞書キーにオプションのプレフィックスを追加します。                                                                                                                            |
 
----
-
 ### カスタムスキーマ (Custom Schemas)
 
 | フィールド | 説明                                                    | 型                          |

package/docs/ja/custom_domains.md

@@ -138,6 +138,36 @@ getMultilingualUrls("/about", { currentDomain: "intlayer.org" });
 
 これらの絶対URLは、SEO用の `<link rel="alternate" hreflang="...">` タグですぐに使用できます。
 
+## 型推論
+
+`routing.domains` は生成されたモジュール拡張にシリアライズされるため、
+`getLocalizedUrl` と `getLocalizedPath` は、ドメインルーティングされたロケールが解決する正確な
+URL に戻り値の型を絞り込みます — プリフィックスの抑制を含みます。
+
+```ts
+// routing: { mode: 'prefix-no-default', domains: { en: 'intlayer.org', zh: 'intlayer.zh' } }
+
+getLocalizedUrl("/about", "zh");
+//     ^? "https://intlayer.zh/about" | "/about"
+
+getLocalizedPath("/about", "zh");
+//     ^? "/about"   (オリジンなし、/zh/ プリフィックスなし)
+```
+
+URL 型は、関数が返すことができる 2 つの値の **union** です: ロケールのドメイン上の
+絶対 URL と、レンダリング中のページがそのドメイン上に既に存在する場合に返す相対 URL です。`getLocalizedPath` にはそのような
+曖昧性はありません - オリジンを出力しません - そのため単一のリテラルのままです。
+
+ドメインを共有するロケールは、型でも通常のプリフィックスを保持します:
+
+```ts
+getLocalizedUrl("/about", "fr");
+//     ^? "https://intlayer.org/fr/about" | "/fr/about"
+```
+
+> `routing.domains` を変更した後、型を再生成します (`npx intlayer build`、または任意の dev server 実行) - 絞り込みはコンフィグファイル自体からではなく、生成された
+> `__RoutingRegistry` から来ています。
+
 ## プロキシの動作
 
 ### Next.js
@@ -170,6 +200,8 @@ GET intlayer.zh/about
 
 `intlayerProxy` Viteプラグインは、開発中に同じロジックを適用します。
 
+> Intlayer v9 以降、`intlayerProxy()` は `intlayer()` プラグインに直接バンドルされており、`routing.enableProxy` オプション (デフォルトでは `true`) で有効になっています。以下のように別々に登録することは現在オプションです — これは後方互換性とプラグインの順序を制御する必要があるセットアップのために保持されています。`routing.enableProxy: false` に設定してオプトアウトしてください。[v9 リリースノート](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/releases/v9.md)を参照してください。
+
 ```typescript fileName="vite.config.ts"
 import { defineConfig } from "vite";
 import { intlayer } from "vite-intlayer";

package/docs/ja/custom_url_rewrites.md

@@ -248,7 +248,7 @@ Intlayer はこれらのパターンを内部で統一された構文に正規
 
 <Tabs group='framework'>
   <Tab label="Next.js" value="nextjs">
-  
+
     ```tsx
     'use client';
 
@@ -263,7 +263,7 @@ Intlayer はこれらのパターンを内部で統一された構文に正規
   </Tab>
 
   <Tab label="React Router" value="reactrouter">
-  
+
     ```tsx
     'use client';
 
@@ -279,7 +279,7 @@ Intlayer はこれらのパターンを内部で統一された構文に正規
   </Tab>
 
   <Tab label="Vue" value="vue">
-  
+
     ```vue
     <script setup>
     import { useRewriteURL } from "vue-intlayer";
@@ -291,7 +291,7 @@ Intlayer はこれらのパターンを内部で統一された構文に正規
 
   </Tab>
   <Tab label="Solid" value="solid">
-  
+
     ```tsx
     import { useRewriteURL } from "solid-intlayer";
 
@@ -303,7 +303,7 @@ Intlayer はこれらのパターンを内部で統一された構文に正規
 
   </Tab>
   <Tab label="Svelte" value="svelte">
-  
+
     ```svelte
     <script>
     import { useRewriteURL } from "svelte-intlayer";
@@ -340,6 +340,8 @@ export function middleware(request: NextRequest) {
 
 SolidJS、Vue、Svelte 向けに、開発中のリライトは `intlayerProxy` Vite プラグインが管理します。
 
+> Intlayer v9 以降、`intlayerProxy()` は `intlayer()` プラグインに直接バンドルされており、`routing.enableProxy` オプション（デフォルトは `true`）を通じてデフォルトで有効になっています。以下のように個別に登録することはオプションになりました — これは後方互換性とプラグインの順序を制御する必要があるセットアップのために保持されています。`routing.enableProxy: false` を設定してオプトアウトできます。[v9 リリースノート](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/releases/v9.md)を参照してください。
+
 ```typescript fileName="vite.config.ts"
 import { defineConfig } from "vite";
 import { intlayer } from "vite-intlayer";

package/docs/ja/dictionary/content_file.md

@@ -656,19 +656,6 @@ statusContent: enu({
 
 Content that varies based on plural rules:
 
-```typescript
-import { plural } from "intlayer";
-
-pluralContent: plural({
-  one: "One car",
-  other: "{{count}} cars",
-});
-```
-
-> 詳細については、 [Plural Content ドキュメント](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/dictionary/plural.md) を参照してください。### 挿入コンテンツ (`insert`)
-
-他のコンテンツに挿入できるコンテンツ：
-
 ```typescript
 import { insert } from "intlayer";
 

package/docs/ja/dictionary/html.md

@@ -245,7 +245,7 @@ HTML ノードで `.use()` メソッドを使用する場合、提供された
 
 <Tabs group="framework">
   <Tab label="React / Next.js" value="react">
-  
+
     ```tsx fileName="AppProvider.tsx"
     import { HTMLProvider } from "react-intlayer/html";
 
@@ -282,7 +282,7 @@ HTML ノードで `.use()` メソッドを使用する場合、提供された
 
   </Tab>
   <Tab label="Vue" value="vue">
-  
+
     ```typescript fileName="main.ts"
     import { createApp, h } from "vue";
     import { intlayer } from "vue-intlayer";
@@ -327,7 +327,7 @@ HTML ノードで `.use()` メソッドを使用する場合、提供された
 
   </Tab>
   <Tab label="Svelte" value="svelte">
-   
+
     ```svelte fileName="App.svelte"
     <script lang="ts">
       import { HTMLProvider } from "svelte-intlayer/html";
@@ -364,7 +364,7 @@ HTML ノードで `.use()` メソッドを使用する場合、提供された
 
   </Tab>
   <Tab label="Preact" value="preact">
-   
+
     ```tsx fileName="AppProvider.tsx"
     import { HTMLProvider } from "preact-intlayer/html";
 
@@ -400,7 +400,7 @@ HTML ノードで `.use()` メソッドを使用する場合、提供された
 
   </Tab>
   <Tab label="Solid" value="solid">
-   
+
     ```tsx fileName="AppProvider.tsx"
     import { HTMLProvider } from "solid-intlayer/html";
 
@@ -460,9 +460,9 @@ HTML ノードで `.use()` メソッドを使用する場合、提供された
     export const appConfig: ApplicationConfig = {
       providers: [
         createIntlayerHTMLProvider({
-          renderMarkdown: async (html) => {
-            const { renderMarkdown } = await import('angular-intlayer/html');
-            return renderMarkdown(html);
+          renderHTML: async (html) => {
+            const { renderHTML } = await import('angular-intlayer/html');
+            return renderHTML(html);
           },
         }),
       ],
@@ -483,7 +483,9 @@ HTML ノードで `.use()` メソッドを使用する場合、提供された
 <Tabs group="framework">
   <Tab label="React / Next.js" value="react">
     #### `<HTMLRenderer />` コンポーネント
-    
+
+特定のコンポーネントを使用してHTMLの文字列をレンダリングします。
+
     ```tsx
     import { HTMLRenderer } from "react-intlayer/html";
 
@@ -518,9 +520,9 @@ HTML ノードで `.use()` メソッドを使用する場合、提供された
 
   </Tab>
   <Tab label="Vue" value="vue">
-   
+
     #### `<HTMLRenderer />` コンポーネント
-   
+
     ```vue
     <script setup>
     import { HTMLRenderer } from "vue-intlayer/html";
@@ -533,9 +535,9 @@ HTML ノードで `.use()` メソッドを使用する場合、提供された
 
   </Tab>
   <Tab label="Svelte" value="svelte">
-  
+
     #### `<HTMLRenderer />` コンポーネント
-   
+
     ```svelte
     <script lang="ts">
     import { HTMLRenderer } from "svelte-intlayer/html";
@@ -567,9 +569,9 @@ HTML ノードで `.use()` メソッドを使用する場合、提供された
 
   </Tab>
   <Tab label="Preact" value="preact">
-   
+
     #### `<HTMLRenderer />` コンポーネント
-   
+
     ```tsx
     import { HTMLRenderer } from "preact-intlayer/html";
 
@@ -598,9 +600,9 @@ HTML ノードで `.use()` メソッドを使用する場合、提供された
 
   </Tab>
   <Tab label="Solid" value="solid">
-   
+
     #### `<HTMLRenderer />` コンポーネント
-   
+
     ```tsx
     import { HTMLRenderer } from "solid-intlayer/html";