@intlayer/docs 8.12.5-canary.0 → 9.0.0-canary.11

package/docs/ja/compat/polyglot.md

@@ -0,0 +1,45 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Polyglot.jsからIntlayerへの移行"
+description: "compat adapterを使用してPolyglot.jsからIntlayerに移行する方法を学びます。"
+keywords:
+  - polyglot
+  - airbnb
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - polyglot
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# Polyglot.js から Intlayer への移行
+
+Airbnb の Polyglot.js を使用している場合、compat layer を使用すると Intlayer への移行は非常に簡単です。
+
+## 実施内容
+
+プロジェクトで初期化コマンドを実行するだけです:
+
+```bash
+npx intlayer init
+```
+
+これにより `intlayer.config.ts` が生成されます。その後、bundler プラグインエイリアスを使用して、Polyglot のインポートを `@intlayer/polyglot` に透過的にリダイレクトできます。
+
+## 内部的な動作
+
+Polyglot.js の構文は通常、`polyglot.t('key', {name})` と `%{name}` インターポレーション、および `"singular |||| plural"` で区切られた `smart_count` 複数形に依存します。
+
+内部的には:
+
+- **インターポレーション:** 互換性レイヤーはネイティブに `%{var}` プレースホルダーを処理します。
+- **複数形:** 文字列は `||||` で分割され、アクティブなロケールに従って native `Intl.PluralRules` に対して評価され、ロケールごとに Polyglot 独自のバケット順序をミラーリングします。
+- **辞書:** `new Polyglot()` に巨大な JSON 設定を提供する必要がなくなります。Intlayer は辞書を動的に処理し、自動的にプルーニングします。

package/docs/ja/compat/react-i18next.md

@@ -0,0 +1,58 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "react-i18nextからIntlayerへの移行"
+description: "compatアダプターを使用して、ReactアプリケーションをReact-i18nextからIntlayerに移行する方法を学びます。"
+keywords:
+  - react-i18next
+  - i18next
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - react-i18next
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# react-i18next から Intlayer への移行
+
+完全で詳細なステップバイステップチュートリアルについては、[react-i18next 移行ガイド](../migration_from_react-i18next_to_intlayer.md)をご覧ください。
+
+Intlayer の compat adapter を使用することで、ソースコードのインポート変更なしに `react-i18next` から移行できます。
+
+## 何をするか
+
+プロジェクトを初期化するには、次を実行します：
+
+```bash
+npx intlayer init
+```
+
+初期化中に、Intlayer は `@intlayer/react-i18next` をインストールし、`intlayer.config.ts` を作成します。バンドラー（Vite など）で、Intlayer プラグインを適用します：
+
+```typescript fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import react from "@vitejs/plugin-react";
+import { reactI18nextVitePlugin } from "@intlayer/react-i18next/plugin";
+
+export default defineConfig({
+  plugins: [react(), reactI18nextVitePlugin()],
+});
+```
+
+## 内部的な動作
+
+`reactI18nextVitePlugin` は、コアの `vite-intlayer` プラグインをラップし、`react-i18next` と `i18next` のリゾルブエイリアスを注入して、`@intlayer/react-i18next` と `@intlayer/i18next` にリダイレクトします。
+
+内部的には:
+
+- **`useTranslation` & `withTranslation`:** Intlayer のネイティブフックを使用するように書き直されており、辞書キーの自動 TypeScript 補完を提供します。namespaces をシームレスにサポートしています (例: `t('namespace:key')`)。
+- **Plurals & Context:** i18next のサフィックスベースの複数形処理 (`key_one`、`key_other`) をネイティブ `Intl.PluralRules` とコンテキストサフィックス (`key_male`) を使用して処理します。
+- **`<Trans>` Component:** `components` プロップ、object と array の形式、および番号付きタグ `<1>...</1>` をサポートするように再実装され、React ノードに直接マップされます。
+- **`i18n` instance:** 大規模な JSON ファイルを取得せずに Intlayer からキーを直接リゾルブするため、バンドルサイズが大幅に削減されます。

package/docs/ja/compat/react-intl.md

@@ -0,0 +1,55 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "React Intl から Intlayer への移行"
+description: "compat アダプターを使用して、React アプリケーションを react-intl から Intlayer に移行する方法を学びます。"
+keywords:
+  - react-intl
+  - formatjs
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - react-intl
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# React IntlからIntlayerへの移行
+
+React アプリケーションが `react-intl` (FormatJS) を使用している場合、Intlayer への移行は簡単です。互換性レイヤーは ICU MessageFormat と既存のすべての `Formatted*` コンポーネントをシームレスに処理します。
+
+## やること
+
+まずプロジェクトで初期化コマンドを実行します：
+
+```bash
+npx intlayer init
+```
+
+次に、設定で Intlayer Vite または Next.js プラグインをセットアップします。このプラグインは、`react-intl` のインポートを `@intlayer/react-intl` にリダイレクトするためのビルド時エイリアスを注入します。
+
+```typescript fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import react from "@vitejs/plugin-react";
+import reactIntlVitePlugin from "@intlayer/react-intl/plugin";
+
+export default defineConfig({
+  plugins: [react(), reactIntlVitePlugin()],
+});
+```
+
+## 内部的な動作
+
+bundler プラグインは `react-intl` を `@intlayer/react-intl` にエイリアスします。大きな JSON ファイルを手動でパースして `IntlProvider` でアプリをラップする代わりに、Intlayer プラグインは静的にキーを抽出し、実行時に Intlayer ディクショナリを使用します。
+
+内部的には以下のように動作します:
+
+- **ICU MessageFormat:** Intlayer は `resolveMessage(..., 'icu')` リゾルバを使用しており、ICU の複数形化、選択、日付/数値フォーマット、リッチテキストタグをネイティブに完全にサポートしています。
+- **Method & JSX callers:** `intl.formatMessage({ id: 'a.b' })` と `<FormattedMessage id="a.b">` は Intlayer コンパイラプラグイン (`@intlayer/babel` / `@intlayer/swc`) によって識別され、フラットなドット記号キーを変換して最初のセグメントが Intlayer ディクショナリキーに正しく解決されるようにします。
+- **Formatters:** `<FormattedNumber>`、`<FormattedDate>` など、ネイティブな `core/formatters` を `Intl` を使用してブリッジします。

package/docs/ja/compat/svelte-i18n.md

@@ -0,0 +1,47 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Svelte I18nからIntlayerへの移行"
+description: "compat アダプターを使用して、Svelte アプリケーションを svelte-i18n から Intlayer に移行する方法を学びます。"
+keywords:
+  - svelte-i18n
+  - svelte
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - svelte-i18n
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# Svelte I18n から Intlayer への移行
+
+`svelte-i18n` から Intlayer への Svelte アプリケーションの移行は、compat adapter を使用することで、わずかな時間で完了します。
+
+## やることリスト
+
+プロジェクトで初期化コマンドを実行するだけです:
+
+```bash
+npx intlayer init
+```
+
+これにより `intlayer.config.ts` が生成されます。SvelteKit / Vite プラグインが Intlayer のエイリアスプラグインでラップされていることを確認して、`svelte-i18n` を `@intlayer/svelte-i18n` にシームレスにマップします。
+
+## 内部動作
+
+Svelte-i18n は頻繁に使用される store（`$_`、`$t`、`$format` など）と ICU MessageFormat に依存しています。
+
+内部動作：
+
+- **Stores:** Intlayer は `svelte-i18n` store をプロキシします。`$_` は現在のロケールの派生 store になり、Intlayer resolver を返します。
+- **Keys:** フラットキー（例：`$_('home.title')`）が評価され、最初のパスセグメントが Intlayer dictionary を表します。
+- **ICU Syntax:** 共有 ICU resolver（`intl-messageformat` と同等のパース）によって完全に処理されます。
+- **Formatters:** `$date`、`$time`、`$number` の呼び出しは Intlayer のネイティブコアフォーマッターに安全にリダイレクトされます。
+- **Babel/SWC Analysis:** Intlayer analyzer は コンパイル前に `.svelte` ソースファイル内の Svelte store 呼び出し（`$_`）を読み取り、関連する dictionary chunks を自動的にビルドします。

package/docs/ja/compat/transloco.md

@@ -0,0 +1,45 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "TranslocoからIntlayerへの移行"
+description: "compatアダプターを使用してAngularアプリケーションをTranslocoからIntlayerに移行する方法を学びます。"
+keywords:
+  - transloco
+  - angular
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - transloco
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# Transloco から Intlayer への移行
+
+Angular アプリケーションが現在 `@jsverse/transloco` を使用している場合、当社の compat アダプタを使用して Intlayer に移行できます。この移行により、既存のテンプレート構文を維持しながら、Intlayer の強力な辞書構造を活用できます。
+
+## やること
+
+プロジェクトで初期化コマンドを実行するだけです：
+
+```bash
+npx intlayer init
+```
+
+これにより、必要な `intlayer.config.ts` 設定が生成されます。その後、Transloco のインポートを `@intlayer/transloco` モジュールに置き換えるか、ビルド aliases に依存します。
+
+## 内部動作
+
+Translocoは、スコープと`TranslocoService`（`translate`、`selectTranslate`）を、構造的ディレクティブ（`*transloco="let t"`）とパイプ（`| transloco`）とともに使用します。
+
+内部動作：
+
+- **スコープ：** Intlayerの辞書キーに自然にマップされ、バンドルの最適化のための優れたプルーニング機能を提供します。
+- **サービスとディレクティブ：** Intlayerの角度アダプターはプロバイダーをシームレスに置き換え、既存のテンプレートパイプとディレクティブがIntlayer辞書に対して文字列を解決できるようにします。
+- **ビルド時パース：** TypeScriptアナライザーは`instant/get`呼び出しを認識し、フォールバックプルーニングはテンプレートの使用が静的に追跡可能でない場合でも正確性を保証します。

package/docs/ja/compat/vue-i18n.md

@@ -0,0 +1,58 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Vue I18nからIntlayerへの移行"
+description: "compatアダプタを使用してVueアプリケーションをvue-i18nからIntlayerに移行する方法を学びます。"
+keywords:
+  - vue-i18n
+  - vue
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - vue-i18n
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# Vue I18n から Intlayer への移行
+
+Vue アプリケーションが現在 `vue-i18n` を使用している場合、コンポーネントを書き直したり、フックを翻訳したりすることなく、Intlayer に移行できます。Intlayer は `vue-i18n` の API を完全に反映する互換性アダプターを提供しながら、Intlayer の強力な機能を内部で活用しています。
+
+## 実施すべきこと
+
+まず、プロジェクトで初期化コマンドを実行してください：
+
+```bash
+npx intlayer init
+```
+
+初期化中、Intlayer は設定ファイル（`intlayer.config.ts`）をセットアップし、プロジェクトをマイグレーション用に準備します。Vite 設定に Intlayer プラグインを追加するだけで、`vue-i18n` インポートを自動的にエイリアスできます。
+
+```typescript fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import vue from "@vitejs/plugin-vue";
+import vueI18nVitePlugin from "@intlayer/vue-i18n/plugin";
+
+export default defineConfig({
+  plugins: [vue(), vueI18nVitePlugin()],
+});
+```
+
+## 内部的な動作
+
+`vueI18nVitePlugin` はバンドラーにモジュールエイリアスを注入します。コードベース内の `vue-i18n` のあらゆるインポートは、透過的に `@intlayer/vue-i18n` にリダイレクトされます。
+
+**内部的には、アダプターは複雑な `vue-i18n` 構文をネイティブに処理します：**
+
+- **補間とプルーラル：** `{name}` とリスト `{0}` の補間を解決します。パイププルーラル（`"car | cars"`）は位置セマンティクスに基づいて Intlayer の列挙型/プルーラルノードに変換されます。
+- **フォーマット：** `d()` や `n()` などの関数は内部的に `Intl` をラップし、オプションで定義された `datetimeFormats` と `numberFormats` を尊重します。
+- **グローバルおよびローカルの状態：** `global.locale` は Intlayer クライアントによって支援される `WritableComputedRef` にマップされるため、リアクティビティはまさに期待通りに機能します（例：`locale.value = 'fr'`）。
+- **ディレクティブ：** `v-t` ディレクティブが登録され、正常に機能します。
+
+アプリケーションは以前と全く同じようにレンダリングされ続けますが、コンテンツは Intlayer ディクショナリによって駆動されるため、型安全性、より優れたバンドル最適化、シームレスな CMS 統合を得られます。

package/docs/ja/compiler.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-09-09
-updatedAt: 2026-03-12
+updatedAt: 2026-06-23
 title: Intlayer コンパイラー | i18n のための自動コンテンツ抽出
 description: Intlayer コンパイラーで国際化プロセスを自動化しましょう。コンポーネントから直接コンテンツを抽出し、Vite、Next.js などでより高速かつ効率的な i18n を実現します。
 keywords:
@@ -60,6 +60,8 @@ author: aymericzip
 
 ## 使い方
 
+> The quickest way to wire the compiler in is the interactive setup: run `npx intlayer init --interactive` and select **Compiler**. On Vite there is nothing to configure — the compiler is plugged in directly through the `intlayerCompiler()` plugin. On Next.js the command scaffolds the `babel.config.js` shown below. The non-interactive `intlayer init` leaves the compiler setup untouched.
+
 <Tabs>
  <Tab value='vite'>
 
@@ -79,12 +81,15 @@ npm install vite-intlayer
 
 ```ts fileName="vite.config.ts"
 import { defineConfig } from "vite";
-import { intlayer, intlayerCompiler } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
   plugins: [
-    intlayer(),
-    intlayerCompiler(), // コンパイラープラグインを追加
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
   ],
 });
 ```

package/docs/ja/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-05-12
+updatedAt: 2026-06-23
 title: 設定 (Configuration)
 description: アプリケーションにIntlayerを設定する方法について説明します。ニーズに合わせてIntlayerをカスタマイズするためのさまざまな設定とオプションを理解してください。
 keywords:
@@ -14,6 +14,12 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 9.0.0
+    date: 2026-06-24
+    changes: "Add `enableProxy` option to the routing configuration"
+  - version: 8.10.0
+    date: 2026-06-17
+    changes: "辞書設定に `format` オプションを追加"
   - version: 8.9.4
     date: 2026-05-12
     changes: "LM Studio プロバイダーのサポートを追加"
@@ -135,6 +141,7 @@ Intlayer は、JSON、JS、MJS、および TS の設定ファイル形式をサ
 ````typescript fileName="intlayer.config.ts" codeFormat="typescript"
 import { Locales, type IntlayerConfig } from "intlayer";
 import { nextjsRewrite } from "intlayer/routing";
+import { syncJSON } from "@intlayer/sync-json-plugin";
 import { z } from "zod";
 
 /**
@@ -583,9 +590,37 @@ const config: IntlayerConfig = {
   },
 
   /**
-   * プラグイン設定。
+   * 辞書設定。
    */
-  plugins: [],
+  dictionary: {
+    /**
+     * 辞書のインポート方法を制御します。
+     * - "static": ビルド時に静的にインポート。
+     * - "dynamic": Suspenseを使用して動的にインポート。
+     * - "fetch": ライブ同期APIを介して動的に取得。
+     */
+    importMode: "static",
+
+    /**
+     * プロジェクト内のすべての辞書のデフォルトのメッセージ形式。
+     * - 'intlayer': ネイティブの intlayer 形式 (デフォルト)。
+     * - 'icu': ICU メッセージ形式。
+     * - 'i18next': i18next 形式。
+     * - 'vue-i18n': Vue I18n 形式。
+     * - 'po': GNU Gettext PO 形式。
+     */
+    format: "icu",
+  },
+
+  /**
+   * プラグインの設定。
+   */
+  plugins: [
+    syncJSON({
+      format: "icu",
+      source: ({ locale }) => `./messages/${locale}.json`,
+    }),
+  ],
 };
 
 export default config;
@@ -850,24 +885,40 @@ export default config;
 
 ---
 
+### システム設定
+
+Intlayerの内部パスと出力結果に関連する設定。これらの設定は通常内部的なものであり、ユーザーが変更する必要はありません。
+
+| Field                     | Description                                                           | Type     | Default                           | Example              | Note                                                         |
+| ------------------------- | --------------------------------------------------------------------- | -------- | --------------------------------- | -------------------- | ------------------------------------------------------------ |
+| `baseDir`                 | プロジェクトのベースディレクトリ。                                    | `string` | `process.cwd()`                   | `'/path/to/project'` | すべてのIntlayer関連ディレクトリを解決するために使用される。 |
+| `dictionariesDir`         | ローカライゼーション辞書を保存するディレクトリパス。                  | `string` | `'.intlayer/dictionary'`          |                      |                                                              |
+| `moduleAugmentationDir`   | モジュール拡張用ディレクトリ。IDEの提案とタイプチェックを向上させる。 | `string` | `'.intlayer/types'`               | `'intlayer-types'`   | `tsconfig.json`に含めることを確認する。                      |
+| `unmergedDictionariesDir` | マージされていない辞書を保存するディレクトリ。                        | `string` | `'.intlayer/unmerged_dictionary'` |                      |                                                              |
+| `typesDir`                | 辞書タイプを保存するディレクトリ。                                    | `string` | `'.intlayer/types'`               |                      |                                                              |
+| `mainDir`                 | メインアプリケーションファイルが保存されるディレクトリ。              | `string` | `'.intlayer/main'`                |                      |                                                              |
+| `configDir`               | 設定ファイルが保存されるディレクトリ。                                | `string` | `'.intlayer/config'`              |                      |                                                              |
+| `cacheDir`                | キャッシュファイルが保存されるディレクトリ。                          | `string` | `'.intlayer/cache'`               |                      |                                                              |
+
 ### 辞書設定 (Dictionary)
 
 自動入力動作やコンテンツ生成など、辞書操作を制御するパラメータ。
 
-| フィールド                  | 説明                                                                                                                                          | 型                                                                                                              | デフォルト  | 例                                                                                          | 備考                                                                                                                                                                                                                                                                                                                                                                                                      |
-| --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `fill`                      | 自動入力 (AI 翻訳) の出力ファイルがどのように生成されるかを制御します。                                                                       | `boolean` &#124; <br/> `FilePathPattern` &#124; <br/> `Partial<Record<Locale, boolean &#124; FilePathPattern>>` | `true`      | `{ en: '/locales/en/{{key}}.json', fr: ({ key }) => '/locales/fr/${key}.json', es: false }` | • `true`: デフォルトパス (ソースと同じファイル)。<br/>• `false`: 無効化。<br/>• 文字列/関数パターンは、ロケールごとのファイルを生成します。<br/>• ロケールごとのオブジェクト: 各ロケールが独自のパターンに対応します。`false` はそのロケールを無視します。<br/>• `{{locale}}` を含めると、ロケールごとの生成がトリガーされます。<br/>• 辞書レベルの `fill` は、常にこのグローバル設定よりも優先されます。 |
-| `description`               | エディタや CMS が辞書の目的を理解するのに役立ちます。AI による翻訳生成のコンテキストとしても使用されます。                                    | `string`                                                                                                        | `undefined` | `'User profile section'`                                                                    |                                                                                                                                                                                                                                                                                                                                                                                                           |
-| `locale`                    | 辞書をロケールごとの形式に変換します。宣言された各フィールドが翻訳ノードになります。存在しない場合、辞書は多言語対応として扱われます。        | `LocalesValues`                                                                                                 | `undefined` | `'en'`                                                                                      | 辞書が複数の言語の翻訳を含むのではなく、特定のロケール専用である場合に使用します。                                                                                                                                                                                                                                                                                                                        |
-| `contentAutoTransformation` | コンテンツの文字列を型付きノード (markdown, HTML, または insertion) に自動変換します。                                                        | `boolean` &#124; <br/> `{ markdown?: boolean; html?: boolean; insertion?: boolean }`                            | `false`     | `true`                                                                                      | • Markdown : `### Title` → `md('### Title')`。<br/>• HTML : `<div>Title</div>` → `html('<div>Title</div>')`。<br/>• 挿入 (Insertion) : `Hello {{name}}` → `insert('Hello {{name}}')`。                                                                                                                                                                                                                    |
-| `location`                  | 辞書ファイルの保存場所と CMS との同期方法を指定します。                                                                                       | `'local'` &#124; <br/> `'remote'` &#124; <br/> `'hybrid'` &#124; <br/> `'plugin'` &#124; <br/> `string`         | `'local'`   | `'hybrid'`                                                                                  | • `'local'`: ローカルでのみ管理。<br/>• `'remote'`: リモート (CMS) でのみ管理。<br/>• `'hybrid'`: ローカルとリモートの両方で管理。<br/>• `'plugin'` またはカスタム文字列: プラグインやカスタムソースによって管理。                                                                                                                                                                                        |
-| `importMode`                | 辞書のインポート方法を制御します。                                                                                                            | `'static'` &#124; <br/> `'dynamic'` &#124; <br/> `'fetch'`                                                      | `'static'`  | `'dynamic'`                                                                                 | • `'static'`: 静的インポート。<br/>• `'dynamic'`: Suspense を介した動的インポート。<br/>• `'fetch'`: Live Sync API を介して取得。失敗した場合は `'dynamic'` にフォールバック。<br/>• `@intlayer/babel` および `@intlayer/swc` プラグインが必要。<br/>• キーは静的に宣言される必要があります。<br/>• `optimize` がオフの場合は無視されます。<br/>• `getIntlayer`、`getDictionary` などには影響しません。   |
-| `priority`                  | 辞書の優先順位。辞書間の競合を解決する際、高い値が低い値に優先されます。                                                                      | `number`                                                                                                        | `undefined` | `1`                                                                                         |                                                                                                                                                                                                                                                                                                                                                                                                           |
-| `live`                      | 非推奨 - 代わりに `importMode: 'fetch'` を使用してください。辞書コンテンツを Live Sync API を介して動的に取得するかどうかを指定していました。 | `boolean`                                                                                                       | `undefined` |                                                                                             | v8.0.0 で `importMode: 'fetch'` に名前変更。                                                                                                                                                                                                                                                                                                                                                              |
-| `schema`                    | JSON スキーマ検証のために Intlayer によって自動生成されます。                                                                                 | `'https://intlayer.org/schema.json'`                                                                            | 自動生成    |                                                                                             | 手動で編集しないでください。                                                                                                                                                                                                                                                                                                                                                                              |
-| `title`                     | エディタや CMS で辞書を識別するのに役立ちます。                                                                                               | `string`                                                                                                        | `undefined` | `'User Profile'`                                                                            |                                                                                                                                                                                                                                                                                                                                                                                                           |
-| `tags`                      | 辞書をカテゴリ化し、エディタや AI にコンテキストや指示を提供します。                                                                          | `string[]`                                                                                                      | `undefined` | `['user', 'profile']`                                                                       |                                                                                                                                                                                                                                                                                                                                                                                                           |
-| `version`                   | リモート辞書のバージョン。現在使用されているバージョンを追跡するのに役立ちます。                                                              | `string`                                                                                                        | `undefined` | `'1.0.0'`                                                                                   | • CMS で管理可能。<br/>• ローカルで編集しないでください。                                                                                                                                                                                                                                                                                                                                                 |
+| フィールド                  | 説明                                                                                                                                          | 型                                                                                                              | デフォルト   | 例                                                                                          | 備考                                                                                                                                                                                                                                                                                                                                                                                                      |
+| --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | ------------ | ------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `fill`                      | 自動入力 (AI 翻訳) の出力ファイルがどのように生成されるかを制御します。                                                                       | `boolean` &#124; <br/> `FilePathPattern` &#124; <br/> `Partial<Record<Locale, boolean &#124; FilePathPattern>>` | `true`       | `{ en: '/locales/en/{{key}}.json', fr: ({ key }) => '/locales/fr/${key}.json', es: false }` | • `true`: デフォルトパス (ソースと同じファイル)。<br/>• `false`: 無効化。<br/>• 文字列/関数パターンは、ロケールごとのファイルを生成します。<br/>• ロケールごとのオブジェクト: 各ロケールが独自のパターンに対応します。`false` はそのロケールを無視します。<br/>• `{{locale}}` を含めると、ロケールごとの生成がトリガーされます。<br/>• 辞書レベルの `fill` は、常にこのグローバル設定よりも優先されます。 |
+| `description`               | エディタや CMS が辞書の目的を理解するのに役立ちます。AI による翻訳生成のコンテキストとしても使用されます。                                    | `string`                                                                                                        | `undefined`  | `'User profile section'`                                                                    |                                                                                                                                                                                                                                                                                                                                                                                                           |
+| `locale`                    | 辞書をロケールごとの形式に変換します。宣言された各フィールドが翻訳ノードになります。存在しない場合、辞書は多言語対応として扱われます。        | `LocalesValues`                                                                                                 | `undefined`  | `'en'`                                                                                      | 辞書が複数の言語の翻訳を含むのではなく、特定のロケール専用である場合に使用します。                                                                                                                                                                                                                                                                                                                        |
+| `contentAutoTransformation` | コンテンツの文字列を型付きノード (markdown, HTML, または insertion) に自動変換します。                                                        | `boolean` &#124; <br/> `{ markdown?: boolean; html?: boolean; insertion?: boolean }`                            | `false`      | `true`                                                                                      | • Markdown : `### Title` → `md('### Title')`。<br/>• HTML : `<div>Title</div>` → `html('<div>Title</div>')`。<br/>• 挿入 (Insertion) : `Hello {{name}}` → `insert('Hello {{name}}')`。                                                                                                                                                                                                                    |
+| `location`                  | 辞書ファイルの保存場所と CMS との同期方法を指定します。                                                                                       | `'local'` &#124; <br/> `'remote'` &#124; <br/> `'hybrid'` &#124; <br/> `'plugin'` &#124; <br/> `string`         | `'local'`    | `'hybrid'`                                                                                  | • `'local'`: ローカルでのみ管理。<br/>• `'remote'`: リモート (CMS) でのみ管理。<br/>• `'hybrid'`: ローカルとリモートの両方で管理。<br/>• `'plugin'` またはカスタム文字列: プラグインやカスタムソースによって管理。                                                                                                                                                                                        |
+| `importMode`                | 辞書のインポート方法を制御します。                                                                                                            | `'static'` &#124; <br/> `'dynamic'` &#124; <br/> `'fetch'`                                                      | `'static'`   | `'dynamic'`                                                                                 | • `'static'`: 静的インポート。<br/>• `'dynamic'`: Suspense を介した動的インポート。<br/>• `'fetch'`: Live Sync API を介して取得。失敗した場合は `'dynamic'` にフォールバック。<br/>• `@intlayer/babel` および `@intlayer/swc` プラグインが必要。<br/>• キーは静的に宣言される必要があります。<br/>• `optimize` がオフの場合は無視されます。<br/>• `getIntlayer`、`getDictionary` などには影響しません。   |
+| `format`                    | プロジェクト内のすべての辞書のデフォルトのメッセージ形式。                                                                                    | `'intlayer'` &#124; <br/> `'icu'` &#124; <br/> `'i18next'` &#124; <br/> `'vue-i18n'` &#124; <br/> `'po'`        | `'intlayer'` | `'icu'`                                                                                     | • `'intlayer'`: ネイティブ intlayer 形式。<br/>• `'icu'`: ICU メッセージ形式。<br/>• `'i18next'`: i18next 形式。<br/>• `'vue-i18n'`: Vue I18n 形式。<br/>• `'po'`: GNU Gettext PO 形式。                                                                                                                                                                                                                  |
+| `priority`                  | 辞書の優先順位。辞書間の競合を解決する際、高い値が低い値に優先されます。                                                                      | `number`                                                                                                        | `undefined`  | `1`                                                                                         |                                                                                                                                                                                                                                                                                                                                                                                                           |
+| `live`                      | 非推奨 - 代わりに `importMode: 'fetch'` を使用してください。辞書コンテンツを Live Sync API を介して動的に取得するかどうかを指定していました。 | `boolean`                                                                                                       | `undefined`  |                                                                                             | v8.0.0 で `importMode: 'fetch'` に名前変更。                                                                                                                                                                                                                                                                                                                                                              |
+| `schema`                    | JSON スキーマ検証のために Intlayer によって自動生成されます。                                                                                 | `'https://intlayer.org/schema.json'`                                                                            | 自動生成     |                                                                                             | 手動で編集しないでください。                                                                                                                                                                                                                                                                                                                                                                              |
+| `title`                     | エディタや CMS で辞書を識別するのに役立ちます。                                                                                               | `string`                                                                                                        | `undefined`  | `'User Profile'`                                                                            |                                                                                                                                                                                                                                                                                                                                                                                                           |
+| `tags`                      | 辞書をカテゴリ化し、エディタや AI にコンテキストや指示を提供します。                                                                          | `string[]`                                                                                                      | `undefined`  | `['user', 'profile']`                                                                       |                                                                                                                                                                                                                                                                                                                                                                                                           |
+| `version`                   | リモート辞書のバージョン。現在使用されているバージョンを追跡するのに役立ちます。                                                              | `string`                                                                                                        | `undefined`  | `'1.0.0'`                                                                                   | • CMS で管理可能。<br/>• ローカルで編集しないでください。                                                                                                                                                                                                                                                                                                                                                 |
 
 **`fill` の例**:
 
@@ -957,22 +1008,6 @@ Intlayer がアプリケーションの国際化をどのように最適化お
 
 ---
 
-### システム設定 (System)
-
-これらの設定は、高度なユースケースおよび Intlayer の内部設定用です。
-
-| フィールド                | 説明                                           | 型       | デフォルト                        | 例  | 備考 |
-| ------------------------- | ---------------------------------------------- | -------- | --------------------------------- | --- | ---- |
-| `dictionariesDir`         | コンパイルされた辞書用のディレクトリ。         | `string` | `'.intlayer/dictionary'`          |     |      |
-| `moduleAugmentationDir`   | TypeScript のモジュール拡張用ディレクトリ。    | `string` | `'.intlayer/types'`               |     |      |
-| `unmergedDictionariesDir` | マージされていない辞書用のディレクトリ。       | `string` | `'.intlayer/unmerged_dictionary'` |     |      |
-| `typesDir`                | 生成された型用のディレクトリ。                 | `string` | `'.intlayer/types'`               |     |      |
-| `mainDir`                 | Intlayer メインファイル用のディレクトリ。      | `string` | `'.intlayer/main'`                |     |      |
-| `configDir`               | コンパイルされた設定ファイル用のディレクトリ。 | `string` | `'.intlayer/config'`              |     |      |
-| `cacheDir`                | キャッシュファイル用のディレクトリ。           | `string` | `'.intlayer/cache'`               |     |      |
-
----
-
 ### コンパイラ設定 (Compiler)
 
 コンポーネントから直接辞書を抽出する Intlayer コンパイラを制御する設定。

package/docs/ja/custom_domains.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-04-02
-updatedAt: 2026-04-02
+updatedAt: 2026-06-23
 title: カスタムドメイン
 description: Intlayerでのドメインベースのロケールルーティングを設定し、専用のホスト名から異なるロケールを提供する方法を学びます。
 keywords:
@@ -172,10 +172,16 @@ GET intlayer.zh/about
 
 ```typescript fileName="vite.config.ts"
 import { defineConfig } from "vite";
-import { intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
-  plugins: [intlayerProxy()],
+  plugins: [
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
+  ],
 });
 ```
 

package/docs/ja/custom_url_rewrites.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-01-26
+updatedAt: 2026-06-23
 title: カスタムURLリライト
 description: Intlayerでロケール固有のパスを定義するためのカスタムURLリライトの設定と使用方法を学びます。
 keywords:
@@ -342,10 +342,16 @@ SolidJS、Vue、Svelte 向けに、開発中のリライトは `intlayerProxy` V
 
 ```typescript fileName="vite.config.ts"
 import { defineConfig } from "vite";
-import { intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
-  plugins: [intlayerProxy()],
+  plugins: [
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
+  ],
 });
 ```