@intlayer/docs 9.4.0-canary.0 → 9.4.0

package/docs/it/self_hosting.md

@@ -21,12 +21,16 @@ author: aymericzip
 
 Intlayer può essere eseguito interamente sulla tua infrastruttura — non è richiesto alcun account Intlayer Cloud. Un singolo comando avvia uno stack pronto per la produzione:
 
+Un comando installa tutto:
+
 ```sh
 curl -fsSL https://intlayer.org/install.sh | sh
 ```
 
 L'installer scarica un `docker-compose.yml` e un `.env`, genera automaticamente i segreti richiesti e avvia tutti i container con `docker compose up -d`.
 
+L'unica dipendenza esterna è **MongoDB**: il backend si connette a un cluster MongoDB **Atlas**, che fornisci tu. Tutto il resto viene eseguito all'interno del container.
+
 ## Indice dei Contenuti
 
 <TOC/>
@@ -60,40 +64,82 @@ Chromium (utilizzato per la generazione di screenshot con Puppeteer) è incluso
 - Porte `3000`, `3100`, `8025`, `9000` e `9001` disponibili sull'host.
 - Un host Linux o macOS (o WSL2 su Windows).
 
+Tutto il resto — Bun, Redis, MinIO, Chromium — è incluso nell'immagine.
+
 ---
 
-## Avvio rapido
+## Quick start
+
+### 1. Eseguire l'installer
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Verifica che Docker sia installato e in esecuzione, scrive `./intlayer.env` con `BETTER_AUTH_SECRET` e `S3_SECRET_ACCESS_KEY` già generati, e scarica l'immagine. Non avvia il container — il backend non può avviarsi senza le credenziali del database.
 
-Scarica ed esegui l'immagine pubblicata, fornendo le tue credenziali e i segreti di MongoDB Atlas:
+Rieseguire l'installer è sicuro: un `intlayer.env` esistente non viene mai sovrascritto, quindi funge anche da percorso di aggiornamento.
+
+### 2. Compila le tue credenziali
+
+Apri `intlayer.env` e completa i valori contrassegnati come `TODO`:
+
+```sh fileName="intlayer.env"
+DB_ID=<atlas-user>
+DB_MDP=<atlas-password>
+DB_CLUSTER=<cluster>.xxxxx.mongodb.net
+RESEND_API_KEY=<your-resend-key>
+```
+
+Il file contiene anche blocchi commentati per le funzionalità opzionali — [SMTP mailer](#global-mailer), `OPENAI_API_KEY` e i provider OAuth. Decommentali secondo le tue necessità.
+
+> Il file viene letto da `docker run --env-file`, che non rimuove le virgolette e tratta tutto ciò che segue `=` come valore. Scrivi valori senza virgolette e mantieni i commenti su righe separate.
+
+### 3. Avvia il container
+
+Questo è il comando che l'installer stampa quando termina:
 
 ```sh
 docker run -d --name intlayer \
+  --restart unless-stopped \
   -p 3000:3000 \
   -p 3100:3100 \
   -p 9000:9000 \
   -p 9001:9001 \
   -v intlayer-data:/data \
-  -e DB_ID="<atlas-user>" \
-  -e DB_MDP="<atlas-password>" \
-  -e DB_CLUSTER="<cluster>.xxxxx.mongodb.net" \
-  -e BETTER_AUTH_SECRET="$(openssl rand -hex 32)" \
-  -e S3_SECRET_ACCESS_KEY="$(openssl rand -hex 16)" \
-  -e RESEND_API_KEY="<your-resend-key>" \
-  aymericzip/intlayer-selfhost
+  --env-file ./intlayer.env \
+  ghcr.io/aymericzip/intlayer-selfhost:latest
 ```
 
-Quindi apri **http://localhost:3000**.
+Quindi apri **http://localhost:3000**. Il primo avvio inizializza i datastore, quindi concedi un minuto.
 
 > La dashboard è servita su `localhost`. Vedi [Limitazioni](#limitations) — i domini personalizzati non sono supportati dall'immagine pubblicata.
 
----
+### Impostazioni del installer
 
-## Avvio rapido
+Il installer legge alcune variabili d'ambiente. Poiché viene piped in `sh`, passale alla shell piuttosto che a `curl`:
 
 ```sh
-curl -fsSL https://intlayer.org/install.sh | sh
+curl -fsSL https://intlayer.org/install.sh | INTLAYER_ENV_FILE=./config/intlayer.env sh
 ```
 
+| Variable                  | Default                                       | Description                          |
+| ------------------------- | --------------------------------------------- | ------------------------------------ |
+| `INTLAYER_IMAGE`          | `ghcr.io/aymericzip/intlayer-selfhost:latest` | Immagine da scaricare                |
+| `INTLAYER_ENV_FILE`       | `./intlayer.env`                              | Dove scrivere il file env            |
+| `INTLAYER_CONTAINER_NAME` | `intlayer`                                    | Nome del container                   |
+| `INTLAYER_DATA_VOLUME`    | `intlayer-data`                               | Volume denominato montato su `/data` |
+| `INTLAYER_APP_PORT`       | `3000`                                        | Porta host per il dashboard          |
+| `INTLAYER_API_PORT`       | `3100`                                        | Porta host per l'API                 |
+| `INTLAYER_S3_PORT`        | `9000`                                        | Porta host per l'API S3 MinIO        |
+| `INTLAYER_CONSOLE_PORT`   | `9001`                                        | Porta host per la console MinIO      |
+
+> Le quattro variabili di porta cambiano solo il lato **host** del mapping stampato nel comando `docker run`. L'immagine pubblicata ha `http://localhost:3000`, `http://localhost:3100` e `http://localhost:9000` compilati nel bundle dashboard al momento della compilazione, quindi rimappare i porta lascia il browser che punta alle porte vecchie. Mantieni i valori predefiniti a meno che non stai costruendo la tua immagine — vedi [Limitations](#limitations).
+
+---
+
+## Avvio rapido
+
 Cosa fa l'installer:
 
 1.  Verifica che `docker` e `docker compose` siano presenti.
@@ -117,8 +163,6 @@ Dopo che lo stack è attivo, apri **http://localhost:3000** e crea il tuo primo
 | **minio**   | `minio/minio`                        | `9000` (S3), `9001` (console)  | Storage di oggetti compatibile con S3 per avatar e screenshot |
 | **mailpit** | `axllent/mailpit`                    | `1025` (SMTP), `8025` (web UI) | Sink di email transazionali locale                            |
 
-Le porte interne (mongo, redis) non sono esposte all'host per impostazione predefinita.
-
 > La porta `9000` di MinIO deve essere raggiungibile dal browser perché gli asset caricati (avatar, screenshot) vengono caricati direttamente da `S3_PUBLIC_URL=http://localhost:9000/intlayer`.
 
 ---
@@ -174,8 +218,6 @@ Le porte interne (mongo, redis) non sono esposte all'host per impostazione prede
 | `LINKEDIN_CLIENT_ID`, `LINKEDIN_CLIENT_SECRET`           | Accesso OAuth di LinkedIn                                                 |
 | `ATLASSIAN_CLIENT_ID`, `ATLASSIAN_CLIENT_SECRET`         | Accesso OAuth di Atlassian                                                |
 
----
-
 ### Mailer globale
 
 Per impostazione predefinita, tutti i messaggi email transazionali vengono inviati tramite Resend utilizzando `RESEND_API_KEY`. I deploy self-hosted possono invece instradare **ogni** email — incluse le email non organizzative come i reset delle password e i magic link — attraverso un mailer globale configurato con variabili di ambiente.
@@ -261,16 +303,8 @@ const { data: dictionaries } = await dictionaryEndpoint(cms).getDictionaries();
 
 ## Aggiornamento
 
-Eseguire nuovamente l'installer su un'implementazione esistente esegue un aggiornamento rolling:
-
-```sh
-curl -fsSL https://intlayer.org/install.sh | sh
-```
-
 Questo scarica le immagini più recenti e riavvia i container con `docker compose pull && docker compose up -d`. I volumi esistenti (`mongo-data`, `redis-data`, `minio-data`) vengono preservati — nessuna perdita di dati.
 
-Per aggiornare manualmente dalla directory `./intlayer/`:
-
 ```sh
 docker compose pull
 docker compose up -d
@@ -334,15 +368,12 @@ docker compose logs mongo
 docker compose logs redis
 ```
 
+Cerca `MongoDB connection error` vicino alla parte superiore del log.
+
 ### La dashboard non riesce a raggiungere l'API
 
 Verifica che `VITE_BACKEND_URL` corrisponda all'URL dove il backend è raggiungibile dal **browser** (non dalla rete Docker). Se hai cambiato la porta del backend o aggiunto un reverse proxy, ricostruisci l'immagine della dashboard:
 
-```sh
-docker compose build app
-docker compose up -d app
-```
-
 ### Bucket MinIO mancante
 
 Se il servizio one-shot `minio-init` non è stato eseguito (o è stato eseguito prima che MinIO fosse pronto), crea il bucket manualmente:

package/docs/ja/analytics.md

@@ -123,17 +123,6 @@ export default config;
 
 `@intlayer/analytics` をアンインストールすることは `enabled: false` と同じ効果があります。全フィールドの一覧は[設定リファレンス](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/configuration.md)を参照してください。
 
-## フレームワークのサポート
-
-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`の展開パターンに従うプロバイダレベルのバインディング |
-
 ## 使用方法
 
 ### 自動プロバイダレベルのトラッキング
@@ -177,6 +166,34 @@ const CTAButton = () => {
 
 ### クライアント側でのバリアント解決
 
+  </Tab>
+</Tabs>
+
+Weights はオプションです — スプリットを調整するために、バリアントごとに 1 つ渡します。例えば、`useExperiment("homepage-hero", ["default", "black_friday"], [9, 1])` のようにします。
+
+子は、一致する辞書の[Variant](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/dynamic_dictionaries/variants.md)を読みます：
+
+```tsx fileName="HeroBanner.tsx"
+import { useIntlayer } from "react-intlayer";
+
+export const HeroBanner = ({ variant }: { variant: string }) => {
+  const { headline, cta } = useIntlayer("hero-banner", { variant });
+
+  return (
+    <section>
+      <h1>{headline}</h1>
+      <a>{cta}</a>
+    </section>
+  );
+};
+```
+
+> **子コンポーネント**でバリアントを読み込むことが、React の外でも機能する理由です。Vue、Svelte、Solid、Angular では、`useIntlayer` に渡されるセレクタはコンポーネントがセットアップされるときにキャプチャされるため、読み込みはバリアントが既知の後にのみマウントされるコンポーネント内で発生する必要があります。
+
+実験が単一の辞書ではなくページ全体をカバーする場合は、variant をプロバイダーにホイストしてください — [Ambient variant](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/dynamic_dictionaries/variants.md#ambient-variant) を参照してください。以下のすべての `useIntlayer` は、呼び出しサイトの変更なしでそれに対して解決されます。
+
+コンポーネント外で生の割り当てが必要な場合は、クライアントに直接アクセスしてください：
+
 ```tsx fileName="useHeroVariant.ts" codeFormat="tsx"
 import { getGlobalAnalyticsClient } from "@intlayer/analytics/client";
 
@@ -187,6 +204,8 @@ const variant = client?.getVariant("homepage-hero", [
 ]);
 ```
 
+> `getVariant` は割り当てるだけで、exposure を記録しません。`useExperiment()` を使用することをお勧めします。そうしないと、コンバージョン率の分母がありません。
+
 ## プライバシーとパフォーマンス
 
 - **設計上の匿名性**: セッションは回転するIDによって識別されます。バックエンドはそのIDの**SHA-256ハッシュ**のみを保存し、生のIDやIPアドレスは決して保存しません。
@@ -236,6 +255,8 @@ const cms = createIntlayerCMS();
 const { data: audience } = await analyticsEndpoint(cms).getAudience(30);
 ```
 
+> **サーバーサイドのみ。** `createIntlayerCMS()` は `clientId` + `clientSecret` で認証され、シークレットはブラウザで利用できません — このスニペットがそこで実行されると、認証されていないリクエストが発行されます。ルートハンドラー、サーバーアクション、またはスクリプトに保つようにしてください。
+
 ## 便利なリンク
 
 - [ダイナミック辞書 - コレクションとバリアント](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/dynamic_dictionaries/index.md)

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/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

@@ -731,8 +731,6 @@ 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テストを可能にします。
@@ -982,6 +980,13 @@ Intlayerの内部パスと出力結果に関連する設定。これらの設定
 
 ### 辞書設定 (Dictionary)
 
+辞書操作を制御する設定。自動入力動作とコンテンツ生成を含みます。
+
+このディクショナリ設定には、主に2つの目的があります：
+
+1. **デフォルト値**: コンテンツ宣言ファイルを作成する際にデフォルト値を定義する
+2. **フォールバック動作**: 特定のフィールドが定義されていない場合にフォールバック値を提供し、辞書操作の動作をグローバルに定義できるようにする
+
 自動入力動作やコンテンツ生成など、辞書操作を制御するパラメータ。
 
 | フィールド                  | 説明                                                                                                                                          | 型                                                                                                              | デフォルト   | 例                                                                                          | 備考                                                                                                                                                                                                                                                                                                                                                                                                      |
@@ -1023,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 機能を制御する設定。
@@ -1064,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 がアプリケーションの国際化をどのように最適化およびコンパイルするかを制御するパラメータ。
@@ -1103,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";