@intlayer/docs 9.1.3 → 9.3.0

package/docs/ja/intlayer_with_vite+preact.md

@@ -749,41 +749,90 @@ export const Link = forwardRef<HTMLAnchorElement, LinkProps>(
 Link.displayName = "Link";
 ```
 
-## Vite と Preact アプリケーションで Intlayer をセットアップするステップバイステップガイド
+#### 動作方法
 
-<Steps>
+- **外部リンクの検出**:  
+  ヘルパー関数 `checkIsExternalLink` は、URL が外部かどうかを判定します。外部リンクはローカライズが不要なため、変更されません。
+- **現在のロケールの取得**:  
+  `useLocale` フックが現在のロケール（例：フランス語の場合 `fr`）を提供します。
+- **URL のローカライズ**:  
+  内部リンク（つまり外部ではないリンク）の場合、`getLocalizedUrl` を使用して、URL に現在のロケールを自動的にプレフィックスします。つまり、ユーザーがフランス語を使用している場合、`href` として `/about` を渡すと `/fr/about` に変換されます。
+- **リンクの返却**:  
+  コンポーネントはローカライズされた URL を含む `<a>` 要素を返し、ナビゲーションがロケールと一貫していることを確認します。
+
+</Step>
+
+<Step number={11} title="Markdown と HTML をレンダリング" isOptional={true}>
+
+Intlayer は Preact での Markdown および HTML コンテンツのレンダリングをサポートしています。
+
+`.use()` メソッドを使用して、Markdown および HTML コンテンツのレンダリングをカスタマイズできます。このメソッドにより、特定のタグのデフォルトレンダリングをオーバーライドできます。
+
+```tsx
+import { useIntlayer } from "preact-intlayer";
+
+const { myMarkdownContent, myHtmlContent } = useIntlayer("my-component");
 
-<Step number={1} title="コンポーネントのコンテンツを抽出する" isOptional={true}>
+// ...
+
+return (
+  <div>
+    {/* 基本的なレンダリング */}
+    {myMarkdownContent}
+
+    {/* Markdown のカスタムレンダリング */}
+    {myMarkdownContent.use({
+      h1: (props) => <h1 style={{ color: "red" }} {...props} />,
+    })}
+
+    {/* HTML の基本的なレンダリング */}
+    {myHtmlContent}
+
+    {/* HTML のカスタムレンダリング */}
+    {myHtmlContent.use({
+      b: (props) => <strong style={{ color: "blue" }} {...props} />,
+    })}
+  </div>
+);
+```
+
+</Step>
 
-既存のコードベースがある場合、数千のファイルを変換するのは時間がかかることがあります。
+<Step number={12} title="コンポーネントのコンテンツを抽出する" isOptional={true}>
 
-このプロセスを容易にするために、Intlayerは、コンポーネントを変換しコンテンツを抽出するための [コンパイラ](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/compiler.md) / [エクストラクタ](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/cli/extract.md) を提案しています。
+既存の codebase がある場合、数千のファイルを変換するのは時間がかかる可能性があります。
 
-セットアップするには、`intlayer.config.ts` ファイルに `compiler` セクションを追加します。
+このプロセスを簡素化するために、Intlayer は[コンパイラ](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/compiler.md) / [エクストラクタ](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/cli/extract.md)を提供して、コンポーネントを変換し、コンテンツを抽出します。
+
+これを設定するには、`intlayer.config.ts` ファイルに `compiler` セクションを追加できます：
 
 ```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { type IntlayerConfig } from "intlayer";
 
 const config: IntlayerConfig = {
-  // ... 他の構成
+  // ... 残りの設定
   compiler: {
     /**
-     * コンパイラを有効にするかどうかを指定します。
+     * コンパイラを有効にするかどうかを示します。
      */
     enabled: true,
 
     /**
-     * 出力ファイルのパスを定義します。
+     * 出力ファイルパスを定義します
      */
     output: ({ fileName, extension }) => `./${fileName}${extension}`,
 
     /**
-     * 変換後にコンポーネントを保存するかどうかを指定します。これにより、コンパイラを一度だけ実行してアプリを変換し、その後削除することができます。
+     * 変換後、コンポーネントを保存するかどうかを示します。
+     *
+     * - `true` の場合、コンパイラはディスク上のコンポーネントファイルを上書きします。したがって、変換は永続的になり、コンパイラは次のプロセスで変換をスキップします。このように、コンパイラはアプリを変換してから削除できます。
+     *
+     * - `false` の場合、コンパイラはビルド出力のコード内にのみ `useIntlayer()` 関数呼び出しを挿入し、ベース codebase をそのままにします。変換はメモリ内でのみ行われます。
      */
     saveComponents: false,
 
     /**
-     * 辞書キーの接頭辞
+     * 辞書キープレフィックス
      */
     dictionaryKeyPrefix: "",
   },
@@ -793,9 +842,9 @@ export default config;
 ```
 
 <Tabs>
- <Tab value='抽出コマンド'>
+ <Tab value='Extract command'>
 
-コンポーネントを変換してコンテンツを抽出するためにエクストラクタを実行します
+エクストラクタを実行してコンポーネントを変換し、コンテンツを抽出します
 
 ```bash packageManager="npm"
 npx intlayer extract
@@ -814,39 +863,22 @@ bun x intlayer extract
 ```
 
  </Tab>
- <Tab value='Babelコンパイラ'>
-
-> Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
-
-```bash packageManager="npm"
-npm install @intlayer/babel --save-dev
-```
-
-```bash packageManager="pnpm"
-pnpm add @intlayer/babel --save-dev
-```
+ <Tab value='Babel compiler'>
 
-```bash packageManager="yarn"
-yarn add @intlayer/babel --save-dev
-```
+> v9 以降、`intlayerCompiler` は `intlayer` プラグインに含まれています。したがって、手動で追加する必要はありません。
 
-```bash packageManager="bun"
-bun add @intlayer/babel --dev
-```
+`vite.config.ts` を更新して、`intlayerCompiler` プラグインを含めます：
 
-```js fileName="babel.config.js"
-const {
-  intlayerExtractBabelPlugin,
-  getExtractPluginOptions,
-} = require("@intlayer/babel");
+```ts fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import { intlayer, intlayerCompiler } from "vite-intlayer";
 
-module.exports = {
-  presets: ["next/babel"],
+export default defineConfig({
   plugins: [
-    // コンポーネントから辞書へコンテンツを抽出する
-    [intlayerExtractBabelPlugin, getExtractPluginOptions()],
+    intlayer(),
+    intlayerCompiler(), // コンパイラプラグインを追加
   ],
-};
+});
 ```
 
 ```bash packageManager="npm"
@@ -862,7 +894,7 @@ yarn build # または yarn dev
 ```
 
 ```bash packageManager="bun"
-bun run build # Or bun run dev
+bun run build # または bun run dev
 ```
 
  </Tab>

package/docs/ja/intlayer_with_vite+vue.md

@@ -30,9 +30,7 @@ history:
 author: aymericzip
 ---
 
-# IntlayerでVite and Vueを翻訳する | 国際化（i18n）
-
-GitHub の [アプリケーションテンプレート](https://github.com/aymericzip/intlayer-vite-vue-template) を参照してください。
+# Intlayerを使用してViteおよびVueウェブサイトを国際化する | 国際化（i18n）
 
 ## 目次
 

package/docs/ja/live-sync.md

@@ -13,6 +13,10 @@ keywords:
   - Intlayer
   - Next.js
   - Vite
+slugs:
+  - doc
+  - concept
+  - live-sync
 history:
   - version: 9.0.0
     date: 2026-07-08

package/docs/ja/mcp_server.md

@@ -252,20 +252,14 @@ ChatGPT で MCP サーバーを設定するには、[公式ドキュメント](h
 
 [公式ドキュメント](https://modelcontextprotocol.io/quickstart/user)に従って、Claude Code で MCP サーバーを設定してください。
 
-## CLIを使ったMCPサーバーの利用
+### ローカルサーバー (stdio) (推奨)
 
-Intlayer MCPサーバーは、テスト、デバッグ、または他のツールとの統合のために、コマンドラインから直接実行することもできます。
+Intlayer MCP サーバーを Claude Code に stdio を使用して接続するには:
 
 ```bash
-# グローバルにインストール
-npm install -g @intlayer/mcp
-
-# またはnpxで直接使用（推奨）
-npx @intlayer/mcp
+claude mcp add intlayer npx -y @intlayer/mcp
 ```
 
----
-
 ### リモートサーバー (Streamable HTTP)
 
 Intlayer MCPサーバーをStreamable HTTP (SSE)を使用してClaude Codeに接続するには:

package/docs/ja/packages/intlayer/getLocalizedUrl.md

@@ -63,30 +63,32 @@ getLocalizedUrl(
   - **Type**: `Locales`
   - **Required**: Yes
 
-## パラメーター
-
-- `url: string`
-  - **説明**: ロケールのプレフィックスを付加する元の URL 文字列。
-  - **型**: `string`
-
-- `currentLocale: Locales`
-  - **説明**: URL をローカライズする対象の現在のロケール。
-  - **型**: `Locales`
-
-- `locales: Locales[]`
-  - **説明**: サポートされているロケールのオプション配列。デフォルトでは、プロジェクトで設定されたロケールが提供されます。
-  - **型**: `Locales[]`
-  - **デフォルト**: [`プロジェクト設定`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/configuration.md#middleware)
-
-- `defaultLocale: Locales`
-  - **説明**: アプリケーションのデフォルトロケール。デフォルトでは、プロジェクトで設定されたデフォルトロケールが提供されます。
-  - **型**: `Locales`
-  - **デフォルト**: [`プロジェクト設定`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/configuration.md#middleware)
-
-- `prefixDefault: boolean`
-  - **説明**: デフォルトロケールの URL にプレフィックスを付けるかどうか。デフォルトでは、プロジェクトで設定された値が提供されます。
-  - **型**: `boolean`
-  - **デフォルト**: [`プロジェクト設定`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/configuration.md#middleware)
+### オプションパラメータ
+
+- `options?: object`
+  - **Description**: URL ローカライゼーション動作の設定オブジェクト。
+  - **Type**: `object`
+  - **Required**: No (Optional)
+
+  - `options.locales?: Locales[]`
+    - **Description**: サポートされているロケールの配列。指定されない場合、プロジェクト設定から設定されたロケールを使用します。
+    - **Type**: `Locales[]`
+    - **Default**: [`プロジェクト設定`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/configuration.md#middleware)
+
+  - `options.defaultLocale?: Locales`
+    - **Description**: アプリケーションのデフォルトロケール。指定されない場合、プロジェクト設定から設定されたデフォルトロケールを使用します。
+    - **Type**: `Locales`
+    - **Default**: [`プロジェクト設定`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/configuration.md#middleware)
+
+  - `options.mode?: 'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params'`
+    - **Description**: ロケール処理のための URL ルーティングモード。指定されない場合、プロジェクト設定から設定されたモードを使用します。
+    - **Type**: `'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params'`
+    - **Default**: [`プロジェクト設定`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/configuration.md#middleware)
+    - **Modes**:
+      - `prefix-no-default`: デフォルトロケールにはプレフィックスなし、その他すべてにプレフィックスあり
+      - `prefix-all`: すべてのロケール（デフォルトを含む）にプレフィックスあり
+      - `no-prefix`: URL にロケールプレフィックスなし
+      - `search-params`: ロケールのクエリパラメータを使用（例：`?locale=fr`）
 
 ### 戻り値
 

package/docs/ja/packages/intlayer/getMultilingualUrls.md

@@ -50,26 +50,12 @@ getMultilingualUrls(
 
 ## パラメータ
 
-## パラメータ
+### 必須パラメータ
 
 - `url: string`
-  - **説明**: ロケールを付加する元の URL 文字列。
+  - **説明**: ロケールでプレフィックスを付与する元のURL文字列。
   - **型**: `string`
-
-- `locales: Locales[]`
-  - **説明**: オプションのサポートされているロケールの配列。プロジェクトで設定されたロケールがデフォルト。
-  - **型**: `Locales[]`
-  - **デフォルト**: `localesDefault`
-
-- `defaultLocale: Locales`
-  - **説明**: アプリケーションのデフォルトロケール。プロジェクトで設定されたデフォルトロケールがデフォルト。
-  - **型**: `Locales`
-  - **デフォルト**: `defaultLocaleDefault`
-
-- `prefixDefault: boolean`
-  - **説明**: デフォルトロケールにプレフィックスを付けるかどうか。プロジェクトで設定された値がデフォルト。
-  - **型**: `boolean`
-  - **デフォルト**: `prefixDefaultDefault`
+  - **必須**: はい
 
 ### オプションパラメータ
 

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

@@ -48,3 +48,18 @@ import "vite-intlayer";
 | `intlayerProxy`      | ロケール検出とルーティングを処理する開発用ミドルウェアプラグイン。 | -                                                                                                                      |
 | `intlayerMiddleware` | (**非推奨**) `intlayerProxy` のエイリアス。                        | -                                                                                                                      |
 | `intlayerPrune`      | ビルド時に未使用の辞書をツリーシェイクしてプルーンするプラグイン。 | [intlayerPrune](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/vite-intlayer/intlayerPrune.md) |
+
+### ユーティリティ
+
+| エクスポート                 | 説明                                                                                                            | 関連ドキュメント                                                                                                       |
+| ---------------------------- | --------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
+| `createIntlayerProxyHandler` | フレームワークに依存しないNode.js `(req, res, next)` ミドルウェアをロケールルーティングロジック付きで返します。 | [intlayerProxy](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/vite-intlayer/intlayerProxy.md) |
+
+### Types
+
+| Export                       | Description                                                                                                              |
+| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
+| `IntlayerPluginOptions`      | `intlayer()` で受け入れられるオプション。`GetConfigurationOptions` を `compatCallers` と `proxy` で拡張します。          |
+| `IntlayerProxyPluginOptions` | `intlayerProxy()` と `createIntlayerProxyHandler()` で受け入れられるオプション。`ignore` と `configOptions` を含みます。 |
+| `IntlayerCompilerOptions`    | `intlayerCompiler()` で受け入れられるオプション。`configOptions` と `compilerConfig` を含みます。                        |
+| `CompatCallerConfig`         | `@intlayer/babel` から再エクスポート。フィールド使用分析のための compat-adapter caller パターンを説明します。            |

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

@@ -39,11 +39,126 @@ export default defineConfig({
 });
 ```
 
-## 説明
+## オプション
 
-このプラグインは次の処理を行います:
+```ts
+import type { IntlayerPluginOptions } from "vite-intlayer";
+```
+
+`IntlayerPluginOptions` は `GetConfigurationOptions` (参照: `@intlayer/config`) を拡張し、以下の追加フィールドを含みます:
+
+| オプション      | 型                              | デフォルト  | 説明                                                                                                                                    |
+| --------------- | ------------------------------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------------- |
+| `compatCallers` | `CompatCallerConfig[]`          | `[]`        | compat-adapterパッケージ(例: `@intlayer/react-i18next`)用の追加呼び出しパターン。ビルド時にfield-usage analyserに渡されます。           |
+| `proxy`         | `{ ignore?: (req) => boolean }` | `undefined` | バンドルされたlocale-routingプロキシに転送されるオプション。`ignore`を使用して特定のパス(例: APIルート)をlocale routingから除外します。 |
+
+その他すべてのオプション(`override`、`configFile`など)は `getConfiguration()` に直接転送されます。
+
+### 例
+
+#### ロケール ルーティングから API ルートを除外する
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { intlayer } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
+  ],
+});
+```
+
+#### カスタムコンフィグファイルパスを使用する場合
+
+```ts
+export default defineConfig({
+  plugins: [
+    intlayer({
+      configFile: "./config/intlayer.config.ts",
+    }),
+  ],
+});
+```
+
+#### compat-adapter callers を使用する場合
+
+```ts
+import { intlayer } from "vite-intlayer";
+import { reactI18nextCallerConfig } from "@intlayer/react-i18next/plugin";
+
+export default defineConfig({
+  plugins: [
+    intlayer({
+      compatCallers: [reactI18nextCallerConfig],
+    }),
+  ],
+});
+```
+
+## プラグインが行うこと
+
+### 1. Dictionary preparation
+
+ビルドが開始される前に（そして開発環境では1時間ごとに）、`intlayer` は `prepareIntlayer` を呼び出して、すべての `.content.ts` ファイルを最適化された JSON 辞書にコンパイルし、`.intlayer/` に保存します。
+
+### 2. モジュールエイリアス
+
+プラグインはViteのresolveエイリアスを追加して、`import { myDict } from 'intlayer/dictionaries/my-dict'` がディスク上のコンパイルされたJSONファイルに解決されるようにします。SSRビルドは `ssr.noExternal` を使用して、すべての `@intlayer/*` パッケージがエイリアスを適用してバンドルされることを確認します。
+
+### 3. Dev-server watcher
+
+開発モードでは `chokidar` ウォッチャーが起動します。`.content.ts` ファイルが変更されると、辞書が再コンパイルされ、Vite の HMR がブラウザに更新を伝播します。
+
+### 4. バンドルされたロケールルーティングプロキシ (v9+)
+
+Intlayer v9 以降、`intlayerProxy` ミドルウェアは `intlayer()` 内に自動的に登録されます。以下の処理を担当します:
+
+- URL プレフィックス、Cookie、および `Accept-Language` ヘッダーからのロケール検出。
+- 検出されたロケールが現在の URL と一致しない場合の 301 リダイレクト。
+- フレームワークが正しい `[locale]` ルートパラメータを認識するための内部 URL 書き換え。
+
+プロキシは Intlayer 設定の `routing.enableProxy`（デフォルト `true`）で制御されます。完全に無効にするには:
+
+```ts
+// intlayer.config.ts
+import { defineConfig } from "intlayer";
+
+export default defineConfig({
+  routing: { enableProxy: false },
+});
+```
+
+別の `intlayerProxy()` 呼び出しなしでプロキシの動作をカスタマイズするには、メインプラグインに `proxy` オプションを渡します:
+
+```ts
+intlayer({ proxy: { ignore: (req) => req.url?.startsWith("/api") } });
+```
+
+ルーティング動作の完全なリファレンスについては、[intlayerProxy ドキュメント](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/vite-intlayer/intlayerProxy.md)を参照してください。
+
+### 5. Bundled compiler (v9+)
+
+`compiler.enabled` が `true` **かつ** `compiler.output` が Intlayer config で設定されている場合、`intlayer()` は `intlayerCompiler` を自動的に登録します。コンパイラはコンポーネントファイル内に直接記述されたインラインコンテンツ宣言を抽出し、トランスフォーム時に辞書に書き込みます。[intlayerCompiler ドキュメント](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/vite-intlayer/intlayerCompiler.md)を参照してください。
+
+### 6. ビルド最適化
+
+本番環境ビルド中、プラグインは以下を追加します：
+
+- **intlayerOptimize** – `useIntlayer('key')` → `useDictionary(hash)` を書き直し、直接 JSON インポートをインジェクトする Babel トランスフォーム。
+- **intlayerPrune** – dictionary JSON から使用されていないコンテンツフィールドを削除します。
+- **intlayerMinify** – dictionary JSON をコンパクト化し、必要に応じてフィールド名をマングルします。
+
+これらは開発モードでは無効です。
+
+## 廃止予定のエイリアス
 
-1. **辞書の準備**: ビルドまたは開発プロセスの開始時に、辞書を最適化されたファイルにコンパイルします。
-2. **ウォッチモード**: 開発モードでは、辞書ファイルの変更を監視し、自動的に再コンパイルします。
-3. **エイリアス**: アプリケーション内で辞書にアクセスするためのエイリアスを提供します。
-4. **ツリーシェイキング**: `intlayerPrune` プラグインを通じて未使用の翻訳のツリーシェイキングをサポートします。
+| 廃止予定のエクスポート | 置き換え   |
+| ---------------------- | ---------- |
+| `intlayerPlugin`       | `intlayer` |
+| `intLayerPlugin`       | `intlayer` |

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

@@ -28,18 +28,91 @@ author: aymericzip
 
 `intlayerPrune` Vite プラグインは、アプリケーションのバンドルから未使用の辞書をツリーシェイクおよびプルーニングするために使用します。これにより、必要な多言語コンテンツのみを含めることで、最終的なバンドルサイズを削減できます。
 
-## 使用方法
+## 使用法
+
+### `intlayer()` の一部として（推奨）
+
+Intlayer の設定を通じてプルーニングを有効にすると、メインプラグインがすべてを処理します：
+
+```ts
+// intlayer.config.ts
+import { defineConfig } from "intlayer";
+
+export default defineConfig({
+  build: {
+    optimize: true, // プルーニングと縮小化の両方を有効にします
+  },
+});
+```
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { intlayer } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [intlayer()],
+});
+```
+
+### スタンドアロン
+
+プラグインスタックを手動で構成している場合、`intlayerPrune` と `intlayerMinify` は `PruneContext` オブジェクトを共有します。このオブジェクトは一度作成して、両方に渡す必要があります：
 
 ```ts
-// vite.config.ts (Vite 設定ファイル)
+// vite.config.ts
 import { defineConfig } from "vite";
-import { intlayer, intlayerPrune } from "vite-intlayer";
+import { intlayerPrune, intlayerMinify } from "vite-intlayer";
+import { createPruneContext } from "@intlayer/babel";
+import { getConfiguration } from "@intlayer/config/node";
+
+const intlayerConfig = getConfiguration();
+const pruneContext = createPruneContext();
 
 export default defineConfig({
-  plugins: [intlayer(), intlayerPrune()],
+  plugins: [
+    intlayerPrune(intlayerConfig, pruneContext),
+    intlayerMinify(intlayerConfig, pruneContext), // オプション、同じコンテキストから読み取ります
+  ],
 });
 ```
 
-## 説明
+## どのように機能するか
+
+### 1. 使用状況分析（buildStart）
+
+`buildStart` 中に、`intlayerOptimize` プラグイン（`intlayer()` の一部でもあります）は `build.filesList` にリストされているすべてのコンポーネントソースファイルをスキャンします。`useIntlayer('key')` または `getIntlayer('key')` の各呼び出しについて、どのフィールドがアクセスされているかを正確に記録します。例えば：
+
+```ts
+const { title, description } = useIntlayer("myDict");
+// 記録: myDict → { title, description }
+```
+
+これにより、`transform` 呼び出しが実行される前に `pruneContext.fieldUsageMap` が構築されます。
+
+### 2. JSON pruning (transform, enforce: 'pre')
+
+Viteがコンパイル済みの辞書JSONファイルを処理する場合、`intlayerPrune`はViteの組み込みJSON → ESM変換の前に処理を行います。`pruneContext`からfield-usageマップを読み取り、記録された使用セットに含まれていないすべてのcontentフィールドを削除します。
+
+2つのコンテンツ形状がサポートされています：
+
+- **Static dictionaries** — `{ nodeType: "translation", translation: { en: {...}, fr: {...} } }`。フィールドは`translation`内のロケールごとに削除されます。
+- **Dynamic (per-locale) dictionaries** — `{ fieldA: ..., fieldB: ... }`のようなflat構造。フィールドはトップレベルで削除されます。
+
+### 3. エッジケース
+
+辞書のコンテンツ構造が認識できない場合（例：異常にネストされた形状）、`pruneContext.dictionariesWithEdgeCases` に追加され、**そのままにされます**。警告がログに出力されます。`intlayerMinify` もこれらの辞書をスキップします。
+
+### 4. Field-rename map
+
+Pruning が成功すると、`intlayerPrune` は `pruneContext.dictionaryKeyToFieldRenameMap` も書き込みます。これは元のフィールド名から短いエイリアスへのマッピングです。`intlayerMinify` はこのマップを読み込んで出力 JSON 内のフィールドの名前を変更し、`intlayerOptimize` の Babel rename pass はソースファイル内のプロパティアクセスをそれに応じて更新します。
+
+## アクティベーション条件
+
+`intlayerPrune` は以下のすべてが当てはまる場合**のみ**アクティブになります:
+
+1. Vite コマンドが `build` である。
+2. `build.optimize` が `true` である (または `undefined` で、ビルドではデフォルトで `true`)。
+3. Intlayer の設定で `build.purge` が `true` である。
 
-このプラグインはソースコードを解析して、実際に使用されている辞書キーを特定します。続いて、バンドルされた辞書ファイルから未使用のコンテンツを削除します。特定のページやコンポーネントで辞書の一部しか使われないような、辞書が多数存在する大規模なプロジェクトで特に有用です。
+`editor.enabled` が `true` の場合、エディターが完全な辞書コンテンツを必要とするため、自動的に**無効化**されます。

package/docs/ja/releases/v9.md

@@ -362,6 +362,18 @@ await dictionaryEndpoint(cms).pushDictionaries([myDictionary]);
 
 ---
 
+## セルフホスティング
+
+Intlayer v9は、単一のコマンドで独自のIntlayerインスタンスを実行するためのファーストクラスサポートを提供します。Intlayer Cloudアカウントは必要ありません。
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+インストーラーは`docker-compose.yml`と`.env`をダウンロードし、必要なシークレットを自動生成し、`docker compose up -d`を実行します。ダッシュボード、API、データベース、オブジェクトストレージ、トランザクションメールのすべてがコンテナ内でローカルに実行されます。
+
+---
+
 ## v8からの移行に関する注意点
 
 v8からアップグレードする場合、v9には破壊的変更は含まれていません。ただし、主な変更点は次のとおりです。