@intlayer/docs 9.4.1 → 9.4.3

package/docs/ja/bundle_optimization.md

@@ -43,139 +43,6 @@ JSONファイルに依存する従来のi18nソリューションで最も一般
 
 <TOC />
 
-## バンドルの分析
-
-バンドルを分析することは、「重い」JSONファイルやコード分割の機会を特定するための第一歩です。これらのツールは、アプリケーションのコンパイル済みコードの視覚的なツリーマップを生成し、どのライブラリが最もスペースを消費しているかを正確に確認できるようにします。
-
-<Tabs>
- <Tab value="vite">
-
-### Vite / Rollup
-
-Viteは内部でRollupを使用しています。`rollup-plugin-visualizer`を使用すると、グラフ内のすべてのモジュールのサイズを示すインタラクティブなHTMLファイルが生成されます。
-
-```bash
-npm install -D rollup-plugin-visualizer
-```
-
-```typescript fileName="vite.config.ts"
-import { defineConfig } from "vite";
-import { visualizer } from "rollup-plugin-visualizer";
-
-export default defineConfig({
-  plugins: [
-    visualizer({
-      open: true, // ブラウザでレポートを自動的に開く
-      filename: "stats.html",
-      gzipSize: true,
-      brotliSize: true,
-    }),
-  ],
-});
-```
-
- </Tab>
- <Tab value="nextjs (turbopack)">
-
-### Next.js (Turbopack)
-
-App RouterとTurbopackを使用しているプロジェクトの場合、Next.jsは追加の依存関係を必要としない組み込みの実験的なアナライザーを提供しています。
-
-```bash packageManager='npm'
-npx next experimental-analyze
-```
-
-```bash packageManager='yarn'
-yarn next experimental-analyze
-```
-
-```bash packageManager='pnpm'
-pnpm next experimental-analyze
-```
-
-```bash packageManager='bun'
-bun next experimental-analyze
-```
-
- </Tab>
- <Tab value="nextjs (Webpack)">
-
-### Next.js (Webpack)
-
-Next.jsでデフォルトのWebpackバンドラーを使用している場合は、公式のバンドルアナライザーを使用してください。ビルド中に環境変数を設定することでトリガーされます。
-
-```bash packageManager='npm'
-npm install -D @next/bundle-analyzer
-```
-
-```bash packageManager='yarn'
-yarn add -D @next/bundle-analyzer
-```
-
-```bash packageManager='pnpm'
-pnpm add -D @next/bundle-analyzer
-```
-
-```bash packageManager='bun'
-bun add -d @next/bundle-analyzer
-```
-
-```javascript fileName="next.config.js"
-const withBundleAnalyzer = require("@next/bundle-analyzer")({
-  enabled: process.env.ANALYZE === "true",
-});
-
-module.exports = withBundleAnalyzer({
-  // Next.jsの設定
-});
-```
-
-**使用方法:**
-
-```bash
-ANALYZE=true npm run build
-```
-
- </Tab>
- <Tab value="Webpack (CRA / Angular / etc)">
-
-### 標準の Webpack
-
-Create React App (ejected)、Angular、またはカスタムのWebpackセットアップの場合は、業界標準の `webpack-bundle-analyzer` を使用します。
-
-```bash packageManager='npm'
-npm install -D webpack-bundle-analyzer
-```
-
-```bash packageManager='yarn'
-yarn add -D webpack-bundle-analyzer
-```
-
-```bash packageManager='pnpm'
-pnpm add -D webpack-bundle-analyzer
-```
-
-```bash packageManager='bun'
-bun add -d webpack-bundle-analyzer
-```
-
-```typescript fileName="webpack.config.ts"
-import { BundleAnalyzerPlugin } from "webpack-bundle-analyzer";
-
-export default {
-  plugins: [
-    new BundleAnalyzerPlugin({
-      analyzerMode: "static",
-      reportFilename: "bundle-analyzer.html",
-      openAnalyzer: false,
-    }),
-  ],
-};
-```
-
- </Tab>
-</Tabs>
-
 ## 仕組み
 
 Intlayerは**コンポーネントごとのアプローチ**を使用します。グローバルなJSONファイルとは異なり、コンテンツはコンポーネントの横、またはコンポーネント内に定義されます。ビルドプロセス中に、Intlayerは以下を実行します。
@@ -189,59 +56,6 @@ Intlayerは**コンポーネントごとのアプローチ**を使用します
 - コンポーネントがインポートされていない場合、そのコンテンツはバンドルに含まれません（デッドコードの削除）。
 - コンポーネントが遅延読み込みされる場合、そのコンテンツも遅延読み込みされます。
 
-## プラグインリファレンス
-
-Intlayerのビルド最適化は、それぞれ単一の責任を持つ複数の個別のプラグインに分割されています。それぞれが何を行うかを理解することで、設定時の混乱を防ぐことができます。
-
-### Babel プラグイン (`@intlayer/babel`)
-
-これらは、Webpackベースのセットアップ（Babelを使用したNext.js、CRA、カスタムWebpackなど）の `babel.config.js` で直接使用されます。
-
-以下の表は、必要なパイプライン順（`babel.config.js` に記述しなければならない順序と同じ）で列挙しています:
-
-| プラグイン                    | 役割                                                                                                                                      |
-| :---------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------- |
-| `intlayerExtractBabelPlugin`  | `.content.ts` ファイルをスキャンし、コンパイルされた辞書を `.intlayer/` に書き込みます                                                    |
-| `intlayerPurgeBabelPlugin`    | すべてのソースファイルをスキャンし、コンパイルされた `.intlayer/**/*.json` から**未使用のフィールド**を削除します                         |
-| `intlayerMinifyBabelPlugin`   | JSONファイルとソースコードの両方で、**コンテンツフィールドキーを短いアルファベットのエイリアス**（例：`title` → `a`）に**名前変更**します |
-| `intlayerOptimizeBabelPlugin` | `useIntlayer('key')` を `useDictionary(hash)` に書き換え、一致する辞書の `import` を注入します                                            |
-
-> **プラグインの順序は重要です。** `babel.config.js` では、purgeとminifyのプラグインは、optimizeのプラグインの**前**に記述する必要があります。最適化パスは `useIntlayer('key')` を不透明な `useDictionary(hash)` 呼び出しに置き換えるため、purgeパスとminifyパスが使用されているフィールドを識別するために必要な辞書キー情報が消去されてしまいます。
-
-各Babelプラグインには、設定読み込み時に `intlayer.config.ts` を1回読み込み、事前解決された値を返す対応するオプションヘルパーがあります。
-
-| オプションヘルパー           | 一緒に使用するプラグイン      |
-| :--------------------------- | :---------------------------- |
-| `getExtractPluginOptions()`  | `intlayerExtractBabelPlugin`  |
-| `getPurgePluginOptions()`    | `intlayerPurgeBabelPlugin`    |
-| `getMinifyPluginOptions()`   | `intlayerMinifyBabelPlugin`   |
-| `getOptimizePluginOptions()` | `intlayerOptimizeBabelPlugin` |
-
-### Vite プラグイン (`vite-intlayer`)
-
-Viteユーザーは**これらを直接設定することはありません**。これらは、`vite.config.ts` で `withIntlayer()` を呼び出したときに自動的に設定されます。`intlayer.config.ts` の `build.purge` および `build.minify` フラグは、追加のプラグイン登録なしに対応する動作を切り替えます。
-
-| 内部の Vite プラグイン | 同等の動作                                                                              |
-| :--------------------- | :-------------------------------------------------------------------------------------- |
-| Usage analyzer         | `intlayerPurgeBabelPlugin` の分析パスと同じ                                             |
-| Dictionary prune       | `intlayerPurgeBabelPlugin` のJSON書き込みパスと同じ                                     |
-| Dictionary minify      | `intlayerMinifyBabelPlugin` のJSON書き込みパスと同じ                                    |
-| Babel transform        | `intlayerMinifyBabelPlugin` のソースコード名変更 + `intlayerOptimizeBabelPlugin` と同じ |
-
-### SWC プラグイン (`@intlayer/swc`)
-
-Next.js ユーザーも**これらを直接設定することはありません**。**v9.2.1** 以降、`next.config.ts` の `withIntlayer()` が `build.purge` と `build.minify` フラグだけを元に、パージ・ミニファイ・インポート書き換えというパイプライン全体を実行します。
-
-SWC の Wasm プラグインは一度に 1 ファイルしか変換できず、ファイルシステムにアクセスできないため、処理は 2 つに分かれています:
-
-| パス                                        | 実行場所                      | 処理内容                                                                                                         |
-| :------------------------------------------ | :---------------------------- | :--------------------------------------------------------------------------------------------------------------- |
-| 使用状況の解析 + JSON のパージ/ミニファイ   | Node、`withIntlayer()` の内部 | すべてのコンポーネントのソースファイルを読み取り、`.intlayer/**/*.json` を書き換え、リネームテーブルを生成します |
-| ソースの書き換え (`content.title` → `.a`)   | `@intlayer/swc` (Wasm)        | リネームテーブルをコード内の該当するプロパティアクセスに適用します                                               |
-| インポートの書き換え (`useIntlayer` → dict) | `@intlayer/swc` (Wasm)        | `intlayerOptimizeBabelPlugin` と同じ                                                                             |
-
-_どの_ フィールドが未使用か、そして各フィールドが _どの_ エイリアスを受け取るかを決定するには、ファイル横断の状態とファイル I/O が必要です。そのためこの半分は Node 上で実行され、SWC プラグインは生成されたテーブルだけを受け取ります。
-
 ## プラットフォーム別の設定
 
 <Tabs>
@@ -405,6 +219,59 @@ module.exports = {
  </Tab>
 </Tabs>
 
+## プラグインリファレンス
+
+Intlayerのビルド最適化は、それぞれ単一の責任を持つ複数の個別のプラグインに分割されています。それぞれが何を行うかを理解することで、設定時の混乱を防ぐことができます。
+
+### Babel プラグイン (`@intlayer/babel`)
+
+これらは、Webpackベースのセットアップ（Babelを使用したNext.js、CRA、カスタムWebpackなど）の `babel.config.js` で直接使用されます。
+
+以下の表は、必要なパイプライン順（`babel.config.js` に記述しなければならない順序と同じ）で列挙しています:
+
+| プラグイン                    | 役割                                                                                                                                      |
+| :---------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------- |
+| `intlayerExtractBabelPlugin`  | `.content.ts` ファイルをスキャンし、コンパイルされた辞書を `.intlayer/` に書き込みます                                                    |
+| `intlayerPurgeBabelPlugin`    | すべてのソースファイルをスキャンし、コンパイルされた `.intlayer/**/*.json` から**未使用のフィールド**を削除します                         |
+| `intlayerMinifyBabelPlugin`   | JSONファイルとソースコードの両方で、**コンテンツフィールドキーを短いアルファベットのエイリアス**（例：`title` → `a`）に**名前変更**します |
+| `intlayerOptimizeBabelPlugin` | `useIntlayer('key')` を `useDictionary(hash)` に書き換え、一致する辞書の `import` を注入します                                            |
+
+> **プラグインの順序は重要です。** `babel.config.js` では、purgeとminifyのプラグインは、optimizeのプラグインの**前**に記述する必要があります。最適化パスは `useIntlayer('key')` を不透明な `useDictionary(hash)` 呼び出しに置き換えるため、purgeパスとminifyパスが使用されているフィールドを識別するために必要な辞書キー情報が消去されてしまいます。
+
+各Babelプラグインには、設定読み込み時に `intlayer.config.ts` を1回読み込み、事前解決された値を返す対応するオプションヘルパーがあります。
+
+| オプションヘルパー           | 一緒に使用するプラグイン      |
+| :--------------------------- | :---------------------------- |
+| `getExtractPluginOptions()`  | `intlayerExtractBabelPlugin`  |
+| `getPurgePluginOptions()`    | `intlayerPurgeBabelPlugin`    |
+| `getMinifyPluginOptions()`   | `intlayerMinifyBabelPlugin`   |
+| `getOptimizePluginOptions()` | `intlayerOptimizeBabelPlugin` |
+
+### Vite プラグイン (`vite-intlayer`)
+
+Viteユーザーは**これらを直接設定することはありません**。これらは、`vite.config.ts` で `withIntlayer()` を呼び出したときに自動的に設定されます。`intlayer.config.ts` の `build.purge` および `build.minify` フラグは、追加のプラグイン登録なしに対応する動作を切り替えます。
+
+| 内部の Vite プラグイン | 同等の動作                                                                              |
+| :--------------------- | :-------------------------------------------------------------------------------------- |
+| Usage analyzer         | `intlayerPurgeBabelPlugin` の分析パスと同じ                                             |
+| Dictionary prune       | `intlayerPurgeBabelPlugin` のJSON書き込みパスと同じ                                     |
+| Dictionary minify      | `intlayerMinifyBabelPlugin` のJSON書き込みパスと同じ                                    |
+| Babel transform        | `intlayerMinifyBabelPlugin` のソースコード名変更 + `intlayerOptimizeBabelPlugin` と同じ |
+
+### SWC プラグイン (`@intlayer/swc`)
+
+Next.js ユーザーも**これらを直接設定することはありません**。**v9.2.1** 以降、`next.config.ts` の `withIntlayer()` が `build.purge` と `build.minify` フラグだけを元に、パージ・ミニファイ・インポート書き換えというパイプライン全体を実行します。
+
+SWC の Wasm プラグインは一度に 1 ファイルしか変換できず、ファイルシステムにアクセスできないため、処理は 2 つに分かれています:
+
+| パス                                        | 実行場所                      | 処理内容                                                                                                         |
+| :------------------------------------------ | :---------------------------- | :--------------------------------------------------------------------------------------------------------------- |
+| 使用状況の解析 + JSON のパージ/ミニファイ   | Node、`withIntlayer()` の内部 | すべてのコンポーネントのソースファイルを読み取り、`.intlayer/**/*.json` を書き換え、リネームテーブルを生成します |
+| ソースの書き換え (`content.title` → `.a`)   | `@intlayer/swc` (Wasm)        | リネームテーブルをコード内の該当するプロパティアクセスに適用します                                               |
+| インポートの書き換え (`useIntlayer` → dict) | `@intlayer/swc` (Wasm)        | `intlayerOptimizeBabelPlugin` と同じ                                                                             |
+
+_どの_ フィールドが未使用か、そして各フィールドが _どの_ エイリアスを受け取るかを決定するには、ファイル横断の状態とファイル I/O が必要です。そのためこの半分は Node 上で実行され、SWC プラグインは生成されたテーブルだけを受け取ります。
+
 ## 設定
 
 `intlayer.config.ts` の `build` プロパティを介して、Intlayerがバンドルを最適化する方法を制御できます。
@@ -650,3 +517,136 @@ const content = useDictionaryAsync({
 | **ネットワークリクエスト** | 追加のリクエストなし                           | 辞書キーごとに1つのリクエスト         |
 | **ツリーシェイキング**     | コンポーネントレベル                           | コンポーネントレベル + ロケールレベル |
 | **最適なユースケース**     | UIコンポーネント、小規模アプリ                 | テキストが多いページ、多言語          |
+
+## バンドルの分析
+
+バンドルを分析することは、「重い」JSONファイルやコード分割の機会を特定するための最も確実な方法です。これらのツールは、アプリケーションのコンパイル済みコードの視覚的なツリーマップを生成し、どのライブラリが最もスペースを消費しているかを正確に確認できるようにします。
+
+<Tabs>
+ <Tab value="vite">
+
+### Vite / Rollup
+
+Viteは内部でRollupを使用しています。`rollup-plugin-visualizer`を使用すると、グラフ内のすべてのモジュールのサイズを示すインタラクティブなHTMLファイルが生成されます。
+
+```bash
+npm install -D rollup-plugin-visualizer
+```
+
+```typescript fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import { visualizer } from "rollup-plugin-visualizer";
+
+export default defineConfig({
+  plugins: [
+    visualizer({
+      open: true, // ブラウザでレポートを自動的に開く
+      filename: "stats.html",
+      gzipSize: true,
+      brotliSize: true,
+    }),
+  ],
+});
+```
+
+ </Tab>
+ <Tab value="nextjs (turbopack)">
+
+### Next.js (Turbopack)
+
+App RouterとTurbopackを使用しているプロジェクトの場合、Next.jsは追加の依存関係を必要としない組み込みの実験的なアナライザーを提供しています。
+
+```bash packageManager='npm'
+npx next experimental-analyze
+```
+
+```bash packageManager='yarn'
+yarn next experimental-analyze
+```
+
+```bash packageManager='pnpm'
+pnpm next experimental-analyze
+```
+
+```bash packageManager='bun'
+bun next experimental-analyze
+```
+
+ </Tab>
+ <Tab value="nextjs (Webpack)">
+
+### Next.js (Webpack)
+
+Next.jsでデフォルトのWebpackバンドラーを使用している場合は、公式のバンドルアナライザーを使用してください。ビルド中に環境変数を設定することでトリガーされます。
+
+```bash packageManager='npm'
+npm install -D @next/bundle-analyzer
+```
+
+```bash packageManager='yarn'
+yarn add -D @next/bundle-analyzer
+```
+
+```bash packageManager='pnpm'
+pnpm add -D @next/bundle-analyzer
+```
+
+```bash packageManager='bun'
+bun add -d @next/bundle-analyzer
+```
+
+```javascript fileName="next.config.js"
+const withBundleAnalyzer = require("@next/bundle-analyzer")({
+  enabled: process.env.ANALYZE === "true",
+});
+
+module.exports = withBundleAnalyzer({
+  // Next.jsの設定
+});
+```
+
+**使用方法:**
+
+```bash
+ANALYZE=true npm run build
+```
+
+ </Tab>
+ <Tab value="Webpack (CRA / Angular / etc)">
+
+### 標準の Webpack
+
+Create React App (ejected)、Angular、またはカスタムのWebpackセットアップの場合は、業界標準の `webpack-bundle-analyzer` を使用します。
+
+```bash packageManager='npm'
+npm install -D webpack-bundle-analyzer
+```
+
+```bash packageManager='yarn'
+yarn add -D webpack-bundle-analyzer
+```
+
+```bash packageManager='pnpm'
+pnpm add -D webpack-bundle-analyzer
+```
+
+```bash packageManager='bun'
+bun add -d webpack-bundle-analyzer
+```
+
+```typescript fileName="webpack.config.ts"
+import { BundleAnalyzerPlugin } from "webpack-bundle-analyzer";
+
+export default {
+  plugins: [
+    new BundleAnalyzerPlugin({
+      analyzerMode: "static",
+      reportFilename: "bundle-analyzer.html",
+      openAnalyzer: false,
+    }),
+  ],
+};
+```
+
+ </Tab>
+</Tabs>

package/docs/ja/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-08-22
+updatedAt: 2026-08-30
 title: 設定 (Configuration)
 description: アプリケーションにIntlayerを設定する方法について説明します。ニーズに合わせてIntlayerをカスタマイズするためのさまざまな設定とオプションを理解してください。
 keywords:
@@ -1117,3 +1117,101 @@ Intlayer がアプリケーションの国際化をどのように最適化お
 | フィールド | 説明                                     | 型                 |
 | ---------- | ---------------------------------------- | ------------------ |
 | `plugins`  | 有効にする Intlayer プラグインのリスト。 | `IntlayerPlugin[]` |
+
+## よくある質問
+
+<FAQ>
+
+<Question title="intlayer.config.ts ファイルはどこに置くべきですか？">
+
+プロジェクトのルート、`package.json` の隣です。Intlayer は `intlayer.config.js`、`intlayer.config.mjs`、`intlayer.config.cjs`、および JSON も受け入れるため、ファイルはプロジェクトが使用するモジュールシステムに一致します。
+
+</Question>
+
+<Question title="i18n は bundle サイズにどのくらい影響しますか？">
+
+名前空間ベースのセットアップよりもはるかに少ないです。なぜなら、ページはレンダリングしないカタログをダウンロードすることがないからです。サーバーでレンダリングされたマークアップはサーバー上でコンテンツを解決し、ビルド時コンパイラは `useIntlayer` の呼び出しをコンポーネントが使用する正確な辞書エントリに置き換えるため、未使用のキーや未使用の言語は削除されます。[動的辞書](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/dynamic_dictionaries/index.md)は残りをロケールごとに分割します。一般的な代替案と比較して、Intlayer は `bundle` およびページサイズを最大 50% 削減します。[bundle optimization](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/bundle_optimization.md) および [benchmark](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/benchmark/index.md) を参照してください。
+
+</Question>
+
+<Question title="コンポーネントを書き直さずに `i18next`、`next-intl`、または `react-i18next` から移行できますか？">
+
+はい、2つの方法があります。[i18next 移行ガイド](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/migration_from_i18next_to_intlayer.md)または [next-intl 移行ガイド](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/migration_from_next-intl_to_intlayer.md)を使用して、コンテンツを段階的に移行できます。または、現在の API を完全に維持することも可能です。[compat adapters](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/compat/index.md)は、`i18next`、`react-i18next`、`next-intl`、`next-i18next`、`react-intl`、`use-intl`、`vue-i18n`、および `Lingui` とまったく同じ API を公開しますが、Intlayer の辞書によって提供されるため、インポートは変更されますが、コンポーネントのコードは変更されません。
+
+</Question>
+
+<Question title="既存の JSON 翻訳ファイルを保持できますか？">
+
+はい。[sync JSON plugin](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/plugins/sync-json.md)は、`/messages/{locale}/{namespace}.json` ファイルを信頼できる情報源として保持し、それらから Intlayer 辞書を双方向に生成します。[sync PO plugin](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/plugins/sync-po.md)は gettext カタログに対しても同様の処理を行い、[per locale files](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/per_locale_file.md)を使用すると、ロケールを1つのファイルにまとめるのではなく、言語ごとにコンテンツを分割できます。
+
+</Question>
+
+<Question title="コンテンツをキーごとに移動する必要がありますか？">
+
+いいえ。`npx intlayer extract` を実行すると、Intlayer はソースファイルを読み取り、ユーザー向けの文字列を抽出し、それぞれの隣に `.content` ファイルを書き込みます。これにより、一度に1つずつ文字列をカタログにコピーする代わりに、差分を確認できます。[extract command](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/cli/extract.md) を参照してください。
+
+完全に自動化されたパイプラインの場合、[Intlayer Compiler](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/compiler.md) はビルド時に JSX、TSX、Vue、Svelte のソースに対して同様の処理を行い、変更があるたびに辞書を生成するため、手動でキーを管理する必要がありません。これは静的解析によって機能するため、実行時にのみ存在する文字列は対象外となり、ユーザー向けのテキストとアプリケーションロジックを区別するためにいくつかの注釈が必要です。
+
+</Question>
+
+<Question title="利用可能なエディタおよび AI エージェントツールは何ですか？">
+
+5つのオプションがあり、すべて任意です。
+
+- **[VS Code extension](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/vs_code_extension.md)**: `useIntlayer` キーからそれを宣言するコンテンツファイルにジャンプしたり、コンポーネントからコンテンツを抽出したり、コマンドパレットまたは専用の Intlayer タブからビルド、フィル、テスト、プッシュ、プルを実行したりできます。
+- **[LSP server](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/lsp.md)**: LSP をサポートする任意のエディタで同様の認識機能を提供します。定義へのジャンプ、すべての参照の検索、翻訳された値のホバープレビュー、キーとフィールドのオートコンプリート、キーがどこにも宣言されていない場合の警告などがあります。また、`i18next`、`react-i18next`、`next-intl`、`use-intl` の呼び出しも解決するため、移行中に役立ちます。
+- **[MCP server](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/mcp_server.md)**: Intlayer のドキュメントと CLI を Cursor、VS Code、Claude Desktop、Claude Code、ChatGPT に公開します。これにより、アシスタントは推測ではなく現在のドキュメントから回答し、`intlayer fill` などのコマンドを自身で実行できます。
+- **[Agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/agent_skills.md)**: `intlayer-config`、`intlayer-cli`、`intlayer-content` などの特定のスキルに加え、フレームワークごとのスキルがあり、エージェントにルーティング設定とコンテンツノードタイプを教えます。
+- **[ESLint plugin](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/eslint.md)**: `no-raw-text` はハードコードされた文字列を検出し、静的辞書キーや未使用のコンテンツに対する追加のルールも提供します。
+
+</Question>
+
+<Question title="アプリに新しい言語を追加するにはどうすればよいですか？">
+
+`internationalization.locales` にロケールを追加し、`npx intlayer fill` を実行して既存のコンテンツをその言語に翻訳します。生成される型も同時に更新されるため、新しいロケールが欠落しているコンテンツファイルは、サイレントなフォールバックではなく型エラーになります。
+
+</Question>
+
+<Question title="URL からロケールプレフィックスを削除するにはどうすればよいですか？">
+
+`routing.mode` を設定します。デフォルトの `"prefix-no-default"` は、デフォルトのロケールには `/about` を、その他のロケールには `/fr/about` を与えます。`"prefix-all"` はすべてのロケールにプレフィックスを付けます。`"no-prefix"` はパスからロケールを完全に除外し、`cookie`、`header`、またはドメインから解決します。`"search-params"` はクエリ文字列に `/about?locale=fr` のように配置します。
+
+</Question>
+
+<Question title="各言語を独自のドメインから提供できますか？">
+
+はい。`routing.domains` はロケールをホスト名にマッピングします。例えば、`{ fr: 'example.fr', en: 'example.com' }` のようになります。ドメインがロケールを識別するため、パスにプレフィックスは追加されず、`getLocalizedUrl` は適切なドメイン上の絶対 URL を返します。
+
+</Question>
+
+<Question title="ユーザーの言語はどのように検出されますか？">
+
+`routing.storage` を通じて検出されます。これは、読み取るソースを順序付けてリストします。通常は URL、次に `cookie`、そして `Accept-Language` `header` です。ユーザーによる明示的な選択は永続化され、次回の訪問時に優先されます。
+
+</Question>
+
+<Question title="`routing.enableProxy` は何をしますか？">
+
+ロケールルーティング `proxy`、つまりプレフィックスを解決しリダイレクトを行う `middleware` を制御します。設定されていない場合、`proxy` は実行されますが、開発サーバーとプレビューサーバーは、テストしていない言語にリダイレクトされるのを避けるため、保存されたロケールをリダイレクト元として無視します。本番環境では `true` と同じように動作します。ロケールルーティングを自分で処理する場合は `false` に設定します。
+
+</Question>
+
+<Question title="`importMode` の `static`、`dynamic`、`fetch` の違いは何ですか？">
+
+デフォルトの `"static"` は、辞書を静的にインポートするため、`bundle` され同期的に読み込まれます。`"dynamic"` は `Suspense` を介してインポートするため、ロケールはコンポーネントがレンダリングするときにのみダウンロードされます。これは大規模なコンテンツセットに適しています。`"fetch"` はライブ同期 API から辞書を取得し、失敗した場合は `"dynamic"` にフォールバックします。[bundle optimization](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/bundle_optimization.md) および [dynamic dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/dynamic_dictionaries/index.md) を参照してください。
+
+</Question>
+
+<Question title="自動翻訳のための AI プロバイダーと API キーはどこで設定しますか？">
+
+設定ファイル、またはコマンドラインで `--provider`、`--model`、`--api-key` を使用して設定します。キーはあなたのものです。翻訳呼び出しは、あなたのマシンまたは CI ランナーから選択したプロバイダーに直接送信されるため、第三者を介してルーティングされることはありません。[fill command](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/cli/fill.md) を参照してください。
+
+</Question>
+
+<Question title="設定を変更した後、開発サーバーを再起動する必要がありますか？">
+
+通常は必要ありません。Intlayer のウォッチャーは `intlayer.config.ts` 自体を監視しています。保存時に設定をリロードし、辞書を再度準備するため、ロケールの追加やルーティングモードの変更はコンテンツの変更と同様に認識されます。ただし、設定はシステムによってキャッシュされる場合があります。アプリを再起動するのが良い解決策となる場合があります。
+
+</Question>
+
+</FAQ>

package/docs/ja/dictionary/content_file.md

@@ -364,15 +364,15 @@ Intlayerの辞書は`Dictionary`型で定義され、その動作を制御する
 
 **例:**
 
-```json
+```jsonc
 // ロケール別辞書
 {
   "key": "about-page",
   "locale": "en",
   "content": {
     "title": "About Us", // これは 'en' の翻訳ノードになります
-    "description": "Learn more about our company"
-  }
+    "description": "Learn more about our company",
+  },
 }
 ```
 
@@ -441,7 +441,7 @@ export default aboutPageMetaContent;
 
 **例：**
 
-```json
+```jsonc
 // すべてのロケールで有効化
 {
   "autoFill": true

package/docs/ja/dictionary/plurial.md

@@ -35,9 +35,12 @@ Intlayerでは、複数形コンテンツは `plural` 関数を通じて実現
 
 ## `plural` と `enu` の使い分け
 
-To use plural content inside a React component, retrieve it via the `useIntlayer` hook and call it with a count. The active locale and the count are combined to pick the matching CLDR category.
+| ユースケース                                            | ヘルパー |
+| ------------------------------------------------------- | -------- |
+| ロケールに応じた文法上の複数形 (one apple / two apples) | `plural` |
+| カスタム数値範囲 (`<5`, `>=10`) や非 CLDR カテゴリ      | `enu`    |
 
-To use plural content in Next.js Client Components, retrieve it via the `useIntlayer` hook and call it with a count. Here's an example:
+英語のみを対象とする場合（`one` / `other` のみ）、どちらでも機能します。`few` / `many` / `two` の区別がある言語の場合は `plural` を推奨します。
 
 ## 複数形コンテンツのセットアップ