@intlayer/docs 9.3.0 → 9.3.1

package/docs/ja/lsp.md

@@ -1,12 +1,14 @@
 ---
 createdAt: 2025-06-07
-updatedAt: 2026-05-31
+updatedAt: 2026-08-10
 title: Intlayer LSP サーバー
-description: Intlayer Language Server が、サポートされているすべてのエディタで useIntlayer、getIntlayer、および関連する呼び出しに対して定義への移動（Go-to-Definition）やその他の IDE 機能を提供する方法について学びます。
+description: Intlayer 言語サーバーが、定義へ移動・参照の検索・ホバープレビュー・キーの自動補完・診断を、IDE と AI エージェントにもたらす方法を紹介します。
 keywords:
   - LSP
-  - Language Server
-  - 定義への移動
+  - 言語サーバー
+  - Go to Definition
+  - 自動補完
+  - 診断
   - IDE
   - Intlayer
   - VS Code
@@ -16,6 +18,9 @@ slugs:
   - doc
   - lsp
 history:
+  - version: 9.1.3
+    date: 2026-08-10
+    changes: "参照の検索、ホバー、自動補完、診断を追加"
   - version: 8.12.0
     date: 2026-06-01
     changes: "Release LSP"
@@ -24,48 +29,47 @@ author: aymericzip
 
 # Intlayer LSP サーバー
 
-**Intlayer Language Server** は、Intlayer に対応したインテリジェンスで IDE を強化する [Language Server Protocol (LSP)](https://microsoft.github.io/language-server-protocol/) の実装です。現在、辞書キー呼び出しに対する **定義への移動（Go to Definition）** を提供しており、コンポーネント内の `useIntlayer("my-key")` からそれを宣言している `.content.ts` ファイルへ直接ジャンプすることができます。
+**Intlayer 言語サーバー**は、IDE と AI エージェントに Intlayer を理解させる [Language Server Protocol (LSP)](https://microsoft.github.io/language-server-protocol/) の実装です。`useIntlayer("home")` のような呼び出しと、それを宣言する `.content.ts` ファイルを双方向に結び付けます。
 
 ---
 
-## なぜ LSP を使用するのか？
+## 機能
 
-Intlayer を使用する場合、コンポーネント内の `useIntlayer("homepage")` のような呼び出しと、`src/homepage.content.ts` でのその宣言との接続は暗黙的です。ツールがない場合、ファイルを手動で検索する必要があります。LSP はそのリンクを明示的にします。
+| 機能                   | ショートカット         | 説明                                                                                       |
+| ---------------------- | ---------------------- | ------------------------------------------------------------------------------------------ |
+| **定義へ移動**         | `F12` / `Cmd+クリック` | 辞書キーやフィールドの使用箇所から、コンテンツファイル内の宣言へジャンプします             |
+| **すべての参照を検索** | `Shift+F12`            | コンテンツファイルから、そのキーまたはフィールドを使うすべての呼び出し箇所を一覧表示します |
+| **ホバー**             | カーソルを重ねる       | ファイルを離れずに、辞書のフィールドやフィールドの翻訳値をプレビューします                 |
+| **自動補完**           | `"` `'` `` ` `` `.`    | ゲッター内で宣言済みの辞書キーを、`.` の後や分割代入ではコンテンツフィールドを提案します   |
+| **診断**               | 自動                   | どのコンテンツファイルにも宣言されていないキーを警告します                                 |
 
-**AI エージェントの認識**
+知っておくとよい挙動が 2 つあります。
 
-AI コーディングエージェント（Cursor、Windsurf、GitHub Copilot、Claude Code、Codex）は、シンボルを解決し、ファイル間の関係を理解するためにランゲージサーバーに依存しています。Intlayer LSP が実行されていると、エージェントは `useIntlayer("key")` をその宣言までたどることができるため、利用可能なコンテンツキー、各辞書の形状、および読み取りまたは編集するファイルに関する正確なコンテキストを得ることができます。
+- **マージされた辞書** — 複数のコンテンツファイルに分割されたキーは、ファイルごとに 1 件の結果を返すため、すべての宣言へ移動できます。
+- **モノレポ対応** — サーバーは各ファイルに _最も近い_ `intlayer.config.*` を解決するため、1 つのワークスペース内の複数プロジェクトがそれぞれ独自の辞書を持てます。
 
-**定義への移動**
+### サポートされる呼び出し
 
-サポートされているゲッター呼び出し内の任意の辞書キー文字列にカーソルを合わせ、`F12`（または `Cmd/Ctrl+クリック`）を押します。エディタはコンテンツ宣言ファイルを開き、カーソルを `key:` 行に配置します。
+キーは位置指定の文字列引数、またはオプションオブジェクト（`{ namespace }`、`{ id }`）から読み取られます。
 
-**マージされた辞書のサポート**
+| ライブラリ                  | 呼び出し                                                 |
+| --------------------------- | -------------------------------------------------------- |
+| **Intlayer**                | `useIntlayer`, `getIntlayer`                             |
+| **i18next / react-i18next** | `useTranslation`, `getFixedT`, `t`, `Trans`              |
+| **next-intl / use-intl**    | `useTranslations`, `getTranslations`, `createTranslator` |
+| **react-intl**              | `formatMessage`, `FormattedMessage`                      |
+| **Lingui**                  | `useLingui`, `t`, `Trans`, `_`                           |
+| **vue-i18n**                | `useI18n`                                                |
 
-キーは複数のコンテンツファイルに分割されている場合があります（Intlayer はこれらをマージします）。サーバーはソースファイルごとに 1 つの `Location` を返すため、すべての宣言にナビゲートできます。
+これはすべての `*-intlayer` パッケージ（`next-intlayer`、`react-intlayer`、`vue-intlayer`、`svelte-intlayer`、`solid-intlayer`、`preact-intlayer`、`angular-intlayer`、`lit-intlayer`、`express-intlayer`、`hono-intlayer`、`fastify-intlayer`、`intlayer`）と、既存の i18n 構文を維持できる compat アダプターパッケージで動作します。
 
-**どこでも動作**
-
-すべての `*-intlayer` パッケージ（`next-intlayer`、`react-intlayer`、`vue-intlayer`、`svelte-intlayer`、`solid-intlayer`、`preact-intlayer`、`angular-intlayer`、`lit-intlayer`、`express-intlayer`、`hono-intlayer`、`fastify-intlayer`、`adonis-intlayer`、`intlayer`）をサポートしています。
-
-### サポートされているゲッター呼び出し
-
-サーバーは以下の関数呼び出しを検出し、最初の文字列リテラル引数を辞書キーとして抽出します。
-
-| 関数          | 例                            |
-| ------------- | ----------------------------- |
-| `useIntlayer` | `useIntlayer("hero")`         |
-| `getIntlayer` | `getIntlayer("hero", locale)` |
-
-TypeScript のジェネリクスや追加の引数は無視され、キー文字列のみが重要となります。
-
-> `useDictionary` と `getDictionary` は、最初の引数として文字列キーではなく、すでにインポートされた `Dictionary` オブジェクトを受け取るため、定義への移動の恩恵を受けず、サーバーによって追跡されません。
+> 辞書はビルド出力から読み込まれます。サーバーが解決できるよう、`npx intlayer build` を実行するか、開発サーバーを起動したままにしてください。
 
 ---
 
 ## インストール
 
-LSP サーバーは `@intlayer/lsp` の一部として配布されています。
+サーバーは `@intlayer/lsp` 内の `intlayer-lsp` バイナリとして提供されます。
 
 ```bash packageManager="npm"
 npm install --save-dev @intlayer/lsp
@@ -83,43 +87,43 @@ pnpm add --save-dev @intlayer/lsp
 bun add --dev @intlayer/lsp
 ```
 
-このパッケージは、エディタがサーバー実行ファイルとして使用する `intlayer-lsp` バイナリを提供します。
+エディターが `PATH` 上の `intlayer-lsp` を必要とする場合は、代わりにグローバルインストール（`npm install -g @intlayer/lsp`）してください。Claude Code プラグインや、バイナリを直接呼び出す以下の設定がこれに該当します。
 
 ---
 
-## Claude Code プラグインとしてのセットアップ
+## セットアップ
 
-Intlayer LSP は、Intlayer GitHub リポジトリで直接ホストされている **Claude Code プラグイン**として利用可能です。これをインストールすると、Claude Code にすべての `useIntlayer` / `getIntlayer` 呼び出しに対するネイティブな定義への移動の認識が与えられます。
+<Tabs defaultTab="vscode">
+  <Tab label="VS Code" value="vscode">
 
-### 1. ランゲージサーバーバイナリのインストール
+[Intlayer VS Code 拡張機能](https://marketplace.visualstudio.com/items?itemName=Intlayer.intlayer-vs-code-extension)をインストールしてください。言語サーバーは v8.12.0 以降同梱されており、自動的に起動します — **設定は不要です**。
 
-```bash packageManager="npm"
-npm install -g @intlayer/lsp
-```
+その他の機能については [VS Code 拡張機能のドキュメント](https://intlayer.org/doc/vs-code-extension)を参照してください。
 
-```bash packageManager="yarn"
-yarn global add @intlayer/lsp
-```
+  </Tab>
+  <Tab label="Cursor / Windsurf" value="cursor">
 
-```bash packageManager="pnpm"
-pnpm add -g @intlayer/lsp
-```
+[Cursor](https://www.cursor.com/) と [Windsurf](https://windsurf.com/) は VS Code のフォークで、同じ拡張機能エコシステムを使用します。[Intlayer VS Code 拡張機能](https://marketplace.visualstudio.com/items?itemName=Intlayer.intlayer-vs-code-extension)を一度インストールすれば、サーバーは自動的に有効になります — **設定は不要です**。
+
+  </Tab>
+  <Tab label="Claude Code" value="claude-code">
 
-これにより、`intlayer-lsp` バイナリが PATH に追加され、プラグインの `lspServers` エントリがこれを呼び出します。
+Intlayer は、Intlayer リポジトリでホストされている **Claude Code プラグイン**を提供しています。これにより Claude Code は `grep` に頼らず、辞書キーの本物のシンボル解決を行えます。
 
-### 2. Intlayer マーケットプレイスの登録とプラグインのインストール
+バイナリを `PATH` に配置し、続いてマーケットプレイスを登録してプラグインをインストールします。
 
 ```bash
+npm install -g @intlayer/lsp
+
 claude plugin marketplace add intlayer@github:aymericzip/intlayer
 claude plugin install intlayer-lsp@intlayer
-claude plugin enable intlayer-lsp@intlayer
 ```
 
-Claude Code は、有効化されたプラグイン（`enabledPlugins`）に `"intlayer-lsp@intlayer": true` を追加し、サポートされているファイルタイプ（`.ts`、`.tsx`、`.js`、`.jsx`、`.vue`、`.svelte`）でランゲージサーバーを自動的に起動します。
+`install` はプラグインの有効化も行います。**Claude Code を再起動してください** — 言語サーバーは起動時に読み込まれるため、それまではプラグインは機能しません。
 
-### 3. LSP ツールの有効化（まだアクティブでない場合）
+その後 Claude Code は `.ts`、`.tsx`、`.js`、`.jsx`、`.vue`、`.astro`、`.svelte` ファイルでサーバーを起動し、コードを辿る際に `goToDefinition`、`findReferences`、`hover` を使用します。
 
-一部の Claude Code バージョンでは、LSP フィーチャフラグを設定する必要があります。インストール後に定義への移動が機能しない場合は、以下を `~/.claude/settings.json` に追加してください。
+定義へ移動が依然として動作しない場合、お使いの Claude Code のバージョンでは LSP ツールがフラグで制御されている可能性があります。
 
 ```json fileName="~/.claude/settings.json"
 {
@@ -129,61 +133,10 @@ Claude Code は、有効化されたプラグイン（`enabledPlugins`）に `"i
 }
 ```
 
-Claude Code を再起動すると、Intlayer コードベースをナビゲートする際に `grep` にフォールバックする代わりに、`goToDefinition`、`findReferences`、およびその他の LSP 操作が使用されるようになります。
-
----
-
-## VS Code でのセットアップ（拡張機能経由 — 推奨）
-
-[Intlayer VS Code 拡張機能](https://marketplace.visualstudio.com/items?itemName=Intlayer.intlayer-vs-code-extension)がインストールされている場合、ランゲージサーバーは自動的に起動します。追加の構成は必要ありません。 LSPはv8.12.0からVSCode拡張機能に直接統合されています。
-
-> インストールやその他の機能については、[VS Code 拡張機能のドキュメント](https://intlayer.org/doc/vs-code-extension)を参照してください。
-
----
-
-## VS Code での手動セットアップ
-
-Intlayer 拡張機能を使用していない場合は、[**vscode-glspc**](https://marketplace.visualstudio.com/items?itemName=sibiraj-s.vscode-scss-formatter) などの汎用 LSP クライアント拡張機能を使用するか、独自の小さな拡張機能を作成して、ランゲージサーバーを手動で接続できます。推奨されるアプローチは、Intlayer 拡張機能を使用することです。
-
-参考までに、サーバーは stdio 経由で `intlayer-lsp` バイナリを起動します。
-
-```json fileName=".vscode/settings.json"
-{
-  "intlayer.languageServer.command": "npx",
-  "intlayer.languageServer.args": ["@intlayer/lsp"]
-}
-```
-
-Intlayer 拡張機能は、これらの設定を読み取ってサーバーを起動します。拡張機能のみに依存する場合、手動での設定は不要です。
-
----
-
-## Cursor でのセットアップ
-
-[Cursor](https://www.cursor.com/) は、AI 機能を組み込んだ VS Code のフォークです。同じ拡張機能エコシステムを使用するため、**Intlayer VS Code 拡張機能**は追加の構成なしで動作します。一度インストールすれば、Cursor が自動的に検出します。
-
-手動構成を好む場合、Cursor はワークスペースのルートから `.vscode/settings.json` も読み取るため、上記の VS Code のスニペットが直接適用されます。
-
----
-
-## Windsurf でのセットアップ
-
-[Windsurf](https://windsurf.com/) (by Codeium) も、VS Code ベースのエディタです。VS Code Marketplace から Intlayer 拡張機能をインストールすると、VS Code や Cursor と同様に、ランゲージサーバーが自動的にアクティブ化されます。
-
-手動構成の場合は、プロジェクトルートに `.vscode/settings.json` を作成します。
-
-```json fileName=".vscode/settings.json"
-{
-  "intlayer.languageServer.command": "npx",
-  "intlayer.languageServer.args": ["@intlayer/lsp"]
-}
-```
-
----
-
-## Zed でのセットアップ
+  </Tab>
+  <Tab label="Zed" value="zed">
 
-[Zed](https://zed.dev/) は、言語設定を通じてネイティブな LSP サポートを提供しています。Zed ユーザー設定（`~/.config/zed/settings.json`）にエントリを追加します。
+Zed はネイティブに LSP をサポートしています。ユーザー設定にサーバーを追加してください。
 
 ```json fileName="~/.config/zed/settings.json"
 {
@@ -196,47 +149,21 @@ Intlayer 拡張機能は、これらの設定を読み取ってサーバーを
     }
   },
   "languages": {
-    "TypeScript": {
-      "language_servers": ["intlayer-lsp", "..."]
-    },
-    "TSX": {
-      "language_servers": ["intlayer-lsp", "..."]
-    },
-    "JavaScript": {
-      "language_servers": ["intlayer-lsp", "..."]
-    },
-    "Vue.js": {
-      "language_servers": ["intlayer-lsp", "..."]
-    },
-    "Svelte": {
-      "language_servers": ["intlayer-lsp", "..."]
-    }
+    "TypeScript": { "language_servers": ["intlayer-lsp", "..."] },
+    "TSX": { "language_servers": ["intlayer-lsp", "..."] },
+    "JavaScript": { "language_servers": ["intlayer-lsp", "..."] },
+    "Vue.js": { "language_servers": ["intlayer-lsp", "..."] },
+    "Svelte": { "language_servers": ["intlayer-lsp", "..."] }
   }
 }
 ```
 
-`"..."` プレースホルダーは、Intlayer のサーバーと並行してデフォルトのランゲージサーバーを維持するよう Zed に指示します。
-
----
-
-## AI エージェント CLI (Claude Code、Codex など) でのセットアップ
-
-**Claude Code** は、優れた LSP プラグインサポートを備えています。上記の [Claude Code プラグインとしてのセットアップ](#claude-code-プラグインとしてのセットアップ)に従って、ターミナルセッションで直接完全な定義への移動体験を取得してください。
+`"..."` のプレースホルダーにより、Zed の既定の言語サーバーが Intlayer のものと併存します。
 
-**OpenAI Codex** やその他のターミナルベースのツールは、まだ LSP クライアントとして動作しません。永続的なランゲージサーバーセッションを維持するのではなく、ファイルを直接読み書きします。これらのツールにとって、LSP が実行されていることの価値は間接的に得られます。コンパニオンエディタ（VS Code、Cursor、Windsurf など）でサーバーがアクティブである場合、エディタが提供するコンテキスト（Cursor Composer、Windsurf Cascade、GitHub Copilot Chat など）を介して照会できる AI エージェントに、エディタのライブインデックスが利用可能になります。
+  </Tab>
+  <Tab label="Neovim" value="neovim">
 
-エディタを開かずにターミナルのみで作業している場合は、ランゲージサーバーをバックグラウンドで起動して、後で同じワークスペースに接続するエディタに備えることができます。
-
-```bash
-# サーバーをバックグラウンドで起動したままにする
-npx @intlayer/lsp &
-```
-
----
-
-## Neovim での手動セットアップ
-
-[nvim-lspconfig](https://github.com/neovim/nvim-lspconfig) を使用して、カスタムサーバー構成を登録します。
+[nvim-lspconfig](https://github.com/neovim/nvim-lspconfig) を使って、カスタムのサーバー設定を登録します。
 
 ```lua fileName="~/.config/nvim/init.lua"
 local lspconfig = require('lspconfig')
@@ -245,7 +172,7 @@ local configs = require('lspconfig.configs')
 if not configs.intlayer_lsp then
   configs.intlayer_lsp = {
     default_config = {
-      -- グローバルインストールを避けるために npx でサーバーを起動
+      -- グローバルインストールが不要になるよう npx でサーバーを起動する
       cmd = { 'npx', '--yes', '@intlayer/lsp' },
       filetypes = {
         'typescript',
@@ -267,21 +194,10 @@ end
 lspconfig.intlayer_lsp.setup({})
 ```
 
-Neovim を再起動した後、Intlayer キーの上で `gd` を押すと、定義への移動が呼び出されます。
-
----
-
-## その他のエディタでの手動セットアップ
-
-Language Server Protocol をサポートする任意のエディタで `@intlayer/lsp` を使用できます。サーバー仕様は以下の通りです。
+Neovim を再起動すると、辞書キー上で `gd` が定義へ移動、`gr` が参照の検索を実行します。
 
-- **トランスポート** – Node.js IPC / stdio (標準)
-- **実行ファイル** – `npx @intlayer/lsp` (またはローカルにインストールされた `intlayer-lsp` バイナリ)
-- **機能** – `definitionProvider: true`、`textDocumentSync: Incremental`
-
-正確な構成フォーマット（例: [coc.nvim](https://github.com/neoclide/coc.nvim) の `languageserver.json`、または [Helix](https://helix-editor.com) の LSP クライアント設定）については、エディタの LSP ドキュメントを参照してください。
-
-### 例: coc.nvim
+  </Tab>
+  <Tab label="coc.nvim" value="coc">
 
 ```json fileName="~/.config/nvim/coc-settings.json"
 {
@@ -307,9 +223,14 @@ Language Server Protocol をサポートする任意のエディタで `@intlaye
 }
 ```
 
-### 例: Helix
+  </Tab>
+  <Tab label="Helix" value="helix">
 
 ```toml fileName="~/.config/helix/languages.toml"
+[language-server.intlayer-lsp]
+command = "npx"
+args = ["@intlayer/lsp"]
+
 [[language]]
 name = "typescript"
 language-servers = ["intlayer-lsp", "typescript-language-server"]
@@ -317,36 +238,54 @@ language-servers = ["intlayer-lsp", "typescript-language-server"]
 [[language]]
 name = "tsx"
 language-servers = ["intlayer-lsp", "typescript-language-server"]
-
-[language-server.intlayer-lsp]
-command = "npx"
-args = ["@intlayer/lsp"]
 ```
 
+  </Tab>
+  <Tab label="その他のエディター" value="other">
+
+LSP に対応したエディターであれば `@intlayer/lsp` を実行できます。次を指定してください。
+
+- **実行ファイル** — `npx @intlayer/lsp`、または `intlayer-lsp` バイナリ
+- **トランスポート** — stdio（標準）
+- **機能** — `definitionProvider`、`referencesProvider`、`hoverProvider`、`completionProvider`（トリガー文字 `"` `'` `` ` `` `.`）、プッシュ診断、`textDocumentSync: Incremental`
+- **ルートパターン** — `intlayer.config.ts`、`intlayer.config.js`、`package.json`
+
+正確な設定形式は、お使いのエディターの LSP ドキュメントを参照してください。
+
+  </Tab>
+</Tabs>
+
 ---
 
-## 仕組み
+## ターミナル AI エージェントについて
 
-サーバーが起動すると、`getConfiguration()` を使用してワークスペースルートから Intlayer 構成を解決します。これにより、コンパイルされた辞書を見つけるために必要な `build` および `system` パスがサーバーに提供されます。
+**Claude Code** は本物の LSP クライアントとして動作します — 上のタブを参照してください。
 
-各 **定義への移動** リクエスト時:
+**OpenAI Codex** をはじめとするほとんどのターミナルツールは LSP クライアントではなく、ファイルを直接読み書きします。サーバーを単独で起動しても役に立ちません。価値が生まれるのは、エージェントがインデックスを照会できる併用エディター（Cursor Composer、Windsurf Cascade、Copilot Chat）でサーバーが有効になっている場合です。
 
-1. サーバーは開いているドキュメントの全文を読み取ります。
-2. 正規表現を使用して、ゲッター呼び出し（`useIntlayer`、`getIntlayer` など）をスキャンします。
-3. カーソル位置がそれらの呼び出しのいずれかの内部にあるかどうかを確認します。
-4. 内部にある場合、辞書キー（正規表現のキャプチャグループ 3）を抽出し、`getUnmergedDictionaries()` を呼び出して、そのキーを宣言しているすべてのコンテンツファイルを特定します。
-5. 一致する各ファイルを読み取り、カーソルを正確に配置するために `key: "<key>"` を含む正確な行を見つけます。
-6. `Location` オブジェクトの配列（ソースファイルごとに 1 つ）を返します。
+---
 
-構成は遅延解決され、セッションごとにキャッシュされます。新しいワークスペースフォルダーを開いたときなどの各 `initialize` リクエスト時にリセットされます。
+## 仕組み
+
+サーバーはファイルごとに最も近い `intlayer.config.*` を探し、そのプロジェクトの設定を読み込んでコンパイル済み辞書を見つけます。設定・辞書・ソースファイル一覧は短い TTL でキャッシュされ、監視中のコンテンツファイルが変更されるたびに無効化されます。
+
+リクエスト時、サーバーは（[oxc](https://oxc.rs/) を用いて）ドキュメントを解析し、カーソル位置を調べます。
+
+1. **キー文字列の上**（`useIntlayer("home")`）→ そのキーを宣言しているすべてのコンテンツファイルを、`key:` の行に位置づけて返します。
+2. **フィールド使用箇所の上**（`content.title`、分割代入したプロパティ、`t('path.to.field')`、`<Trans>` など）→ 変数を辞書までさかのぼって解決し、コンテンツファイル内の該当フィールドを返します。
+3. **コンテンツファイルから** → 逆引きを実行し、そのキーやフィールドの呼び出し箇所をプロジェクトのソースから探索します。
 
 ---
 
 ## トラブルシューティング
 
-| 症状                                   | 考えられる原因               | 対策                                                                                      |
-| -------------------------------------- | ---------------------------- | ----------------------------------------------------------------------------------------- |
-| 定義への移動が機能しない               | サーバーが起動していない     | `@intlayer/lsp` がインストールされ、エディタがそれを起動しているか確認する                |
-| 誤ったワークスペースルートが検出される | 複数のワークスペースフォルダ | `intlayer.config.ts` が含まれるフォルダが最初のワークスペースフォルダであることを確認する |
-| キーの定義が見つからない               | 構成が解決されていない       | `intlayer.config.ts`（または `.js`）がワークスペースルートに存在することを確認する        |
-| 起動時にサーバーがクラッシュする       | Node.js バージョンが古すぎる | Node.js ≥ 14.18 が必要です                                                                |
+| 症状                                          | 考えられる原因                     | 対処                                                                              |
+| --------------------------------------------- | ---------------------------------- | --------------------------------------------------------------------------------- |
+| まったく何も起こらない                        | サーバーが動作していない           | `@intlayer/lsp` がインストールされ、エディターが起動しているか確認してください    |
+| エディターでは動くが Claude Code では動かない | セッション中にプラグインを導入した | Claude Code を再起動してください — 言語サーバーは起動時に読み込まれます           |
+| キーの定義が見つからない                      | 辞書がビルドされていない           | `npx intlayer build` を実行するか、開発サーバーを起動してください                 |
+| すべてのキーが未宣言として報告される          | 設定が解決されていない             | プロジェクトルートに `intlayer.config.ts`（または `.js`）があるか確認してください |
+| モノレポで誤ったプロジェクトが使われる        | パッケージごとの設定がない         | 独自のコンテンツを宣言する各パッケージに `intlayer.config.*` を追加してください   |
+| 起動時にサーバーがクラッシュする              | Node.js のバージョンが古すぎる     | Node.js 14.18 以上が必要です                                                      |
+
+VS Code では、サーバーは **表示 → 出力 →「Intlayer LSP」** にログを出力します。どの設定が解決され、辞書がいくつ見つかったかを確認するのに役立ちます。

package/docs/ja/readme.md

@@ -46,27 +46,27 @@ Intlayer は、ウェブおよびモバイルアプリ向けの**最新の i18n
 
 ## Intlayer の主な利点：
 
-| 機能                                                                                                                                                | 説明                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
-| --------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/frameworks.png?raw=true" alt="Feature" width="700">                          | **マルチフレームワーク対応**<br><br>Intlayer は、Next.js、React、Vite、Vue.js、Nuxt、Preact、Express など、主要なフレームワークやライブラリすべてに対応しています。                                                                                                                                                                                                                                                                                                |
-| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/javascript_content_management.jpg?raw=true" alt="Feature" width="700">       | **JavaScript 駆動のコンテンツ管理**<br><br>JavaScript の柔軟性を活用して、コンテンツを効率的に定義および管理します。<br><br> - [コンテンツ宣言](https://intlayer.org/doc/concept/content)                                                                                                                                                                                                                                                                          |
-| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/per_locale_content_declaration_file.png?raw=true" alt="Feature" width="700"> | **ロケール別コンテンツ宣言ファイル**<br><br>自動生成の前にコンテンツを一度宣言することで、開発をスピードアップします。<br><br> - [ロケール別コンテンツ宣言ファイル](https://intlayer.org/doc/concept/per-locale-file)                                                                                                                                                                                                                                              |
-| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/compiler.jpg?raw=true" alt="Feature" width="700">                            | **コンパイラ**<br><br>Intlayer コンパイラは、コンポーネントからコンテンツを自動的に抽出し、辞書ファイルを作成します。<br><br> - [コンパイラ](https://intlayer.org/doc/compiler)                                                                                                                                                                                                                                                                                    |
-| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/autocompletion.png?raw=true" alt="Feature" width="700">                      | **型安全な環境**<br><br>TypeScript を活用して、コンテンツ定義やコードのエラーを防ぎつつ、IDE の自動補完機能も利用できます。<br><br> - [TypeScript の設定](https://intlayer.org/doc/environment/vite-and-react#configure-typescript)                                                                                                                                                                                                                                |
-| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/config_file.png?raw=true" alt="Feature" width="700">                         | **簡素化されたセットアップ**<br><br>最小限の設定で迅速に開始できます。国際化、ルーティング、AI、ビルド、コンテンツ管理の設定を簡単に調整可能です。<br><br> - [Next.js 統合を探る](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                                                                                                     |
-| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/content_retrieval.png?raw=true" alt="Feature" width="700">                   | **簡素化されたコンテンツ取得**<br><br>各コンテンツごとに `t` 関数を呼び出す必要はありません。単一のフックを使ってすべてのコンテンツを直接取得できます。<br><br> - [React 統合](https://intlayer.org/doc/environment/create-react-app)                                                                                                                                                                                                                              |
-| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/server_component.png?raw=true" alt="Feature" width="700">                    | **一貫したサーバーコンポーネントの実装**<br><br>Next.js のサーバーコンポーネントに完全に適合し、クライアントコンポーネントとサーバーコンポーネントの両方で同じ実装を使用できます。各サーバーコンポーネントに `t` 関数を渡す必要はありません。<br><br> - [サーバーコンポーネント](https://intlayer.org/doc/environment/nextjs#step-7-utilize-content-in-your-code)                                                                                                  |
-| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/file_tree.png?raw=true" alt="Feature" width="700">                           | **整理されたコードベース**<br><br>コードベースをより整理された状態に保ちます：1つのコンポーネント = 同じフォルダ内の1つの辞書。翻訳をそれぞれのコンポーネントの近くに配置することで、保守性と明確さを向上させます。<br><br> - [Intlayer の仕組み](https://intlayer.org/doc/concept/how-works-intlayer)                                                                                                                                                             |
-| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/url_routing.png?raw=true" alt="Feature" width="700">                         | **強化されたルーティング**<br><br>Next.js、React、Vite、Vue.js などの複雑なアプリケーション構造にシームレスに対応し、アプリのルーティングを完全にサポートします。<br><br> - [Next.js 統合を探る](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                                                                                      |
-| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/markdown.png?raw=true" alt="Feature" width="700">                            | **Markdown サポート**<br><br>多言語コンテンツ（プライバシーポリシー、ドキュメントなど）向けに、ロケールファイルやリモートの Markdown をインポートして解釈します。Markdown のメタデータを解釈し、コード内でアクセス可能にします。<br><br> - [コンテンツファイル](https://intlayer.org/doc/concept/content/file)                                                                                                                                                     |
-| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/visual_editor.png?raw=true" alt="Feature" width="700">                       | **無料のビジュアルエディター ＆ CMS**<br><br>コンテンツライター向けに無料のビジュアルエディターと CMS が利用可能で、ローカリゼーションプラットフォームは不要です。Git を使ってコンテンツを同期させるか、CMS で完全または部分的に外部化できます。<br><br> - [Intlayer エディター](https://intlayer.org/doc/concept/editor) <br> - [Intlayer CMS](https://intlayer.org/doc/concept/cms)                                                                              |
-| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/bundle.png?raw=true" alt="Feature" width="700">                              | **ツリーシェイカブルコンテンツ**<br><br>ツリーシェイカブルコンテンツにより、最終バンドルのサイズを削減します。コンポーネントごとにコンテンツを読み込み、未使用のコンテンツはバンドルから除外されます。遅延読み込みをサポートし、アプリの読み込み効率を向上させます。<br><br> - [アプリビルドの最適化](https://intlayer.org/doc/concept/how-works-intlayer#app-build-optimization)                                                                                  |
-| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/static_rendering.png?raw=true" alt="Feature" width="700">                    | **静的レンダリング**<br><br>静的レンダリングを妨げません。<br><br> - [Next.js 統合](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                                                                                                                                                                                                   |
-| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/AI_translation.png?raw=true" alt="Feature" width="700">                      | **AI 駆動の翻訳**<br><br>Intlayer の高度な AI 駆動翻訳ツールを使用し、ご自身の AI プロバイダー / API キーを使って、ワンクリックでウェブサイトを 231 言語に変換します。 <br><br> - [CI/CD 統合](https://intlayer.org/doc/concept/ci-cd) <br> - [Intlayer CLI](https://intlayer.org/doc/concept/cli) <br> - [自動入力](https://intlayer.org/doc/concept/auto-fill)                                                                                                   |
-| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/mcp.png?raw=true" alt="Feature" width="700">                                 | **MCP サーバー統合**<br><br>IDE の自動化のための MCP（モデルコンテキストプロトコル）サーバーを提供し、開発環境内でシームレスなコンテンツ管理と国際化（i18n）ワークフローを可能にします。<br><br> - [MCP サーバー](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/mcp_server.md)                                                                                                                                                                     |
-| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/vscode_extension.png?raw=true" alt="Feature" width="700">                    | **VSCode 拡張機能**<br><br>Intlayer は、コンテンツと翻訳の管理、辞書の構築、コンテンツの翻訳などを支援する VSCode 拡張機能を提供します。<br><br> - [VSCode 拡張機能](https://intlayer.org/doc/vs-code-extension)                                                                                                                                                                                                                                                   |
-| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/interoperability.png?raw=true" alt="Feature" width="700">                    | **相互運用性**<br><br>react-i18next、next-i18next、next-intl, react-intl, vue-i18n との相互運用性を可能にします。<br><br> - [Intlayer と react-intl](https://intlayer.org/blog/intlayer-with-react-intl) <br> - [Intlayer と next-intl](https://intlayer.org/blog/intlayer-with-next-intl) <br> - [Intlayer と next-i18next](https://intlayer.org/blog/intlayer-with-next-i18next) <br> - [Intlayer と vue-i18n](https://intlayer.org/blog/intlayer-with-vue-i18n) |
-| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/benchmark.png?raw=true" alt="Feature" width="700">                           | **パフォーマンスとベンチマーク**<br><br>高度なツリーシェイキングと動的ローディングを使用してパフォーマンスを向上させ、ソリューションを可能な限り軽量に保ちます。 <br><br> - [パフォーマンスとベンチマーク](https://intlayer.org/doc/benchmark)                                                                                                                                                                                                                     |
+| 機能                                                                                                                                                | 説明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
+| --------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/frameworks.png?raw=true" alt="Feature" width="700">                          | **マルチフレームワーク対応**<br><br>Intlayer は、Next.js、React、Vite、Vue.js、Nuxt、Preact、Express など、主要なフレームワークやライブラリすべてに対応しています。                                                                                                                                                                                                                                                                                                                                                                           |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/javascript_content_management.jpg?raw=true" alt="Feature" width="700">       | **JavaScript 駆動のコンテンツ管理**<br><br>JavaScript の柔軟性を活用して、コンテンツを効率的に定義および管理します。<br><br> - [コンテンツ宣言](https://intlayer.org/doc/concept/content)                                                                                                                                                                                                                                                                                                                                                     |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/per_locale_content_declaration_file.png?raw=true" alt="Feature" width="700"> | **ロケール別コンテンツ宣言ファイル**<br><br>自動生成の前にコンテンツを一度宣言することで、開発をスピードアップします。<br><br> - [ロケール別コンテンツ宣言ファイル](https://intlayer.org/doc/concept/per-locale-file)                                                                                                                                                                                                                                                                                                                         |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/compiler.jpg?raw=true" alt="Feature" width="700">                            | **コンパイラ**<br><br>Intlayer コンパイラは、コンポーネントからコンテンツを自動的に抽出し、辞書ファイルを作成します。<br><br> - [コンパイラ](https://intlayer.org/doc/compiler)                                                                                                                                                                                                                                                                                                                                                               |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/autocompletion.png?raw=true" alt="Feature" width="700">                      | **型安全な環境**<br><br>TypeScript を活用して、コンテンツ定義やコードのエラーを防ぎつつ、IDE の自動補完機能も利用できます。<br><br> - [TypeScript の設定](https://intlayer.org/doc/environment/vite-and-react#configure-typescript)                                                                                                                                                                                                                                                                                                           |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/config_file.png?raw=true" alt="Feature" width="700">                         | **簡素化されたセットアップ**<br><br>最小限の設定で迅速に開始できます。国際化、ルーティング、AI、ビルド、コンテンツ管理の設定を簡単に調整可能です。<br><br> - [Next.js 統合を探る](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                                                                                                                                                                                |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/content_retrieval.png?raw=true" alt="Feature" width="700">                   | **簡素化されたコンテンツ取得**<br><br>各コンテンツごとに `t` 関数を呼び出す必要はありません。単一のフックを使ってすべてのコンテンツを直接取得できます。<br><br> - [React 統合](https://intlayer.org/doc/environment/create-react-app)                                                                                                                                                                                                                                                                                                         |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/server_component.png?raw=true" alt="Feature" width="700">                    | **一貫したサーバーコンポーネントの実装**<br><br>Next.js のサーバーコンポーネントに完全に適合し、クライアントコンポーネントとサーバーコンポーネントの両方で同じ実装を使用できます。各サーバーコンポーネントに `t` 関数を渡す必要はありません。<br><br> - [サーバーコンポーネント](https://intlayer.org/doc/environment/nextjs#step-7-utilize-content-in-your-code)                                                                                                                                                                             |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/file_tree.png?raw=true" alt="Feature" width="700">                           | **整理されたコードベース**<br><br>コードベースをより整理された状態に保ちます：1つのコンポーネント = 同じフォルダ内の1つの辞書。翻訳をそれぞれのコンポーネントの近くに配置することで、保守性と明確さを向上させます。<br><br> - [Intlayer の仕組み](https://intlayer.org/doc/concept/how-works-intlayer)                                                                                                                                                                                                                                        |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/url_routing.png?raw=true" alt="Feature" width="700">                         | **強化されたルーティング**<br><br>Next.js、React、Vite、Vue.js などの複雑なアプリケーション構造にシームレスに対応し、アプリのルーティングを完全にサポートします。<br><br> - [Next.js 統合を探る](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                                                                                                                                                                 |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/markdown.png?raw=true" alt="Feature" width="700">                            | **Markdown サポート**<br><br>多言語コンテンツ（プライバシーポリシー、ドキュメントなど）向けに、ロケールファイルやリモートの Markdown をインポートして解釈します。Markdown のメタデータを解釈し、コード内でアクセス可能にします。<br><br> - [コンテンツファイル](https://intlayer.org/doc/concept/content/file)                                                                                                                                                                                                                                |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/visual_editor.png?raw=true" alt="Feature" width="700">                       | **無料のビジュアルエディター ＆ CMS**<br><br>コンテンツライター向けに無料のビジュアルエディターと CMS が利用可能で、ローカリゼーションプラットフォームは不要です。Git を使ってコンテンツを同期させるか、CMS で完全または部分的に外部化できます。<br><br> - [Intlayer エディター](https://intlayer.org/doc/concept/editor) <br> - [Intlayer CMS](https://intlayer.org/doc/concept/cms)                                                                                                                                                         |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/bundle.png?raw=true" alt="Feature" width="700">                              | **ツリーシェイカブルコンテンツ**<br><br>ツリーシェイカブルコンテンツにより、最終バンドルのサイズを削減します。コンポーネントごとにコンテンツを読み込み、未使用のコンテンツはバンドルから除外されます。遅延読み込みをサポートし、アプリの読み込み効率を向上させます。<br><br> - [アプリビルドの最適化](https://intlayer.org/doc/concept/how-works-intlayer#app-build-optimization)                                                                                                                                                             |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/static_rendering.png?raw=true" alt="Feature" width="700">                    | **静的レンダリング**<br><br>静的レンダリングを妨げません。<br><br> - [Next.js 統合](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                                                                                                                                                                                                                                                                              |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/AI_translation.png?raw=true" alt="Feature" width="700">                      | **AI 駆動の翻訳**<br><br>Intlayer の高度な AI 駆動翻訳ツールを使用し、ご自身の AI プロバイダー / API キーを使って、ワンクリックでウェブサイトを 231 言語に変換します。 <br><br> - [CI/CD 統合](https://intlayer.org/doc/concept/ci-cd) <br> - [Intlayer CLI](https://intlayer.org/doc/concept/cli) <br> - [自動入力](https://intlayer.org/doc/concept/auto-fill)                                                                                                                                                                              |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/mcp.png?raw=true" alt="Feature" width="700">                                 | **MCP サーバー統合**<br><br>IDE の自動化のための MCP（モデルコンテキストプロトコル）サーバーを提供し、開発環境内でシームレスなコンテンツ管理と国際化（i18n）ワークフローを可能にします。<br><br> - [MCP サーバー](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/mcp_server.md)                                                                                                                                                                                                                                                |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/vscode_extension.png?raw=true" alt="Feature" width="700">                    | **VSCode 拡張機能**<br><br>Intlayer は、コンテンツと翻訳の管理、辞書の構築、コンテンツの翻訳などを支援する VSCode 拡張機能を提供します。<br><br> - [VSCode 拡張機能](https://intlayer.org/doc/vs-code-extension)                                                                                                                                                                                                                                                                                                                              |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/interoperability.png?raw=true" alt="Feature" width="700">                    | **相互運用性**<br><br>react-i18next、next-i18next、next-intl, react-intl, vue-i18n との相互運用性を可能にします。<br><br> - [Intlayer と react-intl](https://intlayer.org/blog/intlayer-with-react-intl) <br> - [Intlayer と next-intl](https://intlayer.org/blog/intlayer-with-next-intl) <br> - [Intlayer と next-i18next](https://intlayer.org/blog/intlayer-with-next-i18next) <br> - [Intlayer と vue-i18n](https://intlayer.org/blog/intlayer-with-vue-i18n) <br> - [Intlayer の互換アダプター](https://intlayer.org/doc/compatibility) |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/benchmark.png?raw=true" alt="Feature" width="700">                           | **パフォーマンスとベンチマーク**<br><br>高度なツリーシェイキングと動的ローディングを使用してパフォーマンスを向上させ、ソリューションを可能な限り軽量に保ちます。 <br><br> - [パフォーマンスとベンチマーク](https://intlayer.org/doc/benchmark)                                                                                                                                                                                                                                                                                                |
 
 ---
 
@@ -173,7 +173,7 @@ Intlayer の包括的なドキュメントを探索し、Intlayer の使い始
   <li><a href="https://intlayer.org/doc/concept/cms" rel=''>Intlayer CMS</a></li>
   <li><a href="https://intlayer.org/doc/concept/content" rel=''>辞書</a>
     <ul>
-      <li><a href="https://intlayer.org/doc/concept/content/per-locale-file" rel=''>ロケール別コンテンツ宣言ファイル</a></li>
+      <li><a href="https://intlayer.org/doc/concept/per-locale-file" rel=''>ロケール別コンテンツ宣言ファイル</a></li>
       <li><a href="https://intlayer.org/doc/concept/content/translation" rel=''>翻訳</a></li>
       <li><a href="https://intlayer.org/doc/concept/content/enumeration" rel=''>列挙</a></li>
       <li><a href="https://intlayer.org/doc/concept/content/condition" rel=''>条件</a></li>
@@ -194,7 +194,7 @@ Intlayer の包括的なドキュメントを探索し、Intlayer の使い始
     <ul>
       <li><a href="https://intlayer.org/doc/environment/nextjs/15" rel=''>Next.js 15</a></li>
       <li><a href="https://intlayer.org/doc/environment/nextjs/14" rel=''>Next.js 14（App Router）</a></li>
-      <li><a href="https://intlayer.org/doc/environment/nextjs/next-with-Page-Router" rel=''>Next.js Page Router</a></li>
+      <li><a href="https://intlayer.org/doc/environment/nextjs/next-with-page-router" rel=''>Next.js Page Router</a></li>
       <li><a href="https://intlayer.org/doc/environment/nextjs/compiler" rel=''>コンパイラを使用した Next.js</a></li>
     </ul>
   </li>
@@ -223,7 +223,7 @@ Intlayer の包括的なドキュメントを探索し、Intlayer の使い始
   <li><a href="https://intlayer.org/doc/environment/sveltekit" rel=''>SvelteKit</a></li>
   <li><a href="https://intlayer.org/doc/environment/vite-and-preact" rel=''>Vite + Preact</a></li>
   <li><a href="https://intlayer.org/doc/environment/vite-and-vue" rel=''>Vite + Vue</a></li>
-  <li><a href="https://intlayer.org/doc/environment/vite-and-nuxt" rel=''>Vite + Nuxt</a></li>
+  <li><a href="https://intlayer.org/doc/environment/nuxt-and-vue" rel=''>Vite + Nuxt</a></li>
   <li><a href="https://intlayer.org/doc/environment/vite-and-solid" rel=''>Vite + Solid</a></li>
   <li><a href="https://intlayer.org/doc/environment/angular" rel=''>Angular</a></li>
   <li>