@intlayer/docs 9.3.0 → 9.3.2

package/docs/uk/intlayer_with_tanstack.md

@@ -270,13 +270,15 @@ export default config;
 ```tsx fileName="src/routes/__root.tsx"
 import {
   createRootRouteWithContext,
+  getRouteApi,
   HeadContent,
   Scripts,
 } from "@tanstack/react-router";
 import { defaultLocale, getHTMLTextDir } from "intlayer";
 import { type ReactNode } from "react";
 import { IntlayerProvider } from "react-intlayer";
-import { Route as LocaleRoute } from "./{-$locale}/route";
+
+const localeRoute = getRouteApi("/{-$locale}");
 
 export const Route = createRootRouteWithContext<{}>()({
   head: () => ({
@@ -298,7 +300,7 @@ export const Route = createRootRouteWithContext<{}>()({
 });
 
 function RootDocument({ children }: { children: ReactNode }) {
-  const params = LocaleRoute.useParams();
+  const params = localeRoute.useParams();
   const locale = params?.locale ?? defaultLocale;
 
   return (
@@ -631,7 +633,7 @@ export const LocaleSwitcher: FC = () => {
 
 ```tsx fileName="src/routes/__root.tsx"
 function RootDocument({ children }: { children: ReactNode }) {
-  const params = LocaleRoute.useParams();
+  const params = localeRoute.useParams();
   const locale = params?.locale ?? defaultLocale;
 
   return (

package/docs/uk/lsp.md

@@ -1,12 +1,14 @@
 ---
 createdAt: 2025-06-07
-updatedAt: 2026-05-31
+updatedAt: 2026-08-10
 title: LSP-сервер Intlayer
-description: Дізнайтеся, як мовний сервер Intlayer надає функцію «Перейти до визначення» та інші можливості IDE для useIntlayer, getIntlayer та пов'язаних викликів у всіх підтримуваних редакторах.
+description: Дізнайтеся, як мовний сервер Intlayer додає перехід до визначення, пошук посилань, спливаючі підказки, автодоповнення ключів і діагностику до вашої IDE та вашого ШІ-агента.
 keywords:
   - LSP
   - Мовний сервер
-  - Перейти до визначення
+  - 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
 
 # LSP-сервер Intlayer
 
-**Мовний сервер Intlayer (LSP)** — це реалізація [протоколу мовного сервера (LSP)](https://microsoft.github.io/language-server-protocol/), яка розширює можливості вашої IDE за допомогою інтелектуальних функцій, адаптованих під Intlayer. Наразі він надає функцію **Перейти до визначення (Go to Definition)** для викликів ключів словника, дозволяючи переходити безпосередньо з `useIntlayer("my-key")` у вашому компоненті до файлу `.content.ts`, який його оголошує.
+**Мовний сервер Intlayer** — це реалізація [Language Server Protocol (LSP)](https://microsoft.github.io/language-server-protocol/), яка робить вашу IDE — і вашого ШІ-агента — обізнаними про Intlayer. Він пов’язує виклик на кшталт `useIntlayer("home")` із файлом `.content.ts`, який його оголошує, в обидва боки.
 
 ---
 
-## Навіщо використовувати LSP?
+## Можливості
 
-При використанні Intlayer зв'язок між викликом на кшталт `useIntlayer("homepage")` та його оголошенням у `src/homepage.content.ts` є неявним. Без інструментів вам доведеться шукати файл вручну. LSP робить цей зв'язок явним:
+| Можливість                | Комбінація клавіш   | Що робить                                                                                                      |
+| ------------------------- | ------------------- | -------------------------------------------------------------------------------------------------------------- |
+| **Перейти до визначення** | `F12` / `Cmd+Клік`  | Перейти від ключа словника або використання поля до його оголошення у файлі контенту                           |
+| **Знайти всі посилання**  | `Shift+F12`         | З файлу контенту показати всі місця виклику, що використовують цей ключ або поле                               |
+| **Спливаюча підказка**    | навести курсор      | Переглянути поля словника або перекладене значення поля, не залишаючи файл                                     |
+| **Автодоповнення**        | `"` `'` `` ` `` `.` | Пропонувати оголошені ключі словників усередині ґетера та поля контенту після `.` або під час деструктуризації |
+| **Діагностика**           | автоматично         | Попереджати, коли ключ не оголошено в жодному файлі контенту                                                   |
 
-**Розуміння ШІ-агентами**
+Варто знати ще про дві особливості:
 
-ШІ-агенти для кодингу (Cursor, Windsurf, GitHub Copilot, Claude Code, Codex) покладаються на мовний сервер для вирішення символів та розуміння зв'язків між файлами. За запущеного Intlayer LSP агенти можуть відстежувати шлях від `useIntlayer("key")` до місця оголошення ключа, отримуючи точний контекст про доступні ключі контенту, структуру кожного словника та про те, які файли слід читати чи редагувати.
+- **Об’єднані словники** — ключ, розділений між кількома файлами контенту, повертає по одному результату на файл, тож ви можете перейти до кожного оголошення.
+- **Підтримка монорепозиторіїв** — сервер знаходить _найближчий_ до кожного файлу `intlayer.config.*`, тож кілька проєктів в одному робочому просторі отримують власні словники.
 
-**Перейти до визначення**
+### Підтримувані виклики
 
-Помістіть курсор на будь-який рядок із ключем словника всередині підтримуваного виклику геттера та натисніть `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 об'єднує їх). Сервер повертає одне місцеположення (`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.
 
-**Працює всюди**
-
-Підтримує всі пакети `*-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` — або тримайте dev-сервер запущеним — щоб серверу було що розв’язувати.
 
 ---
 
 ## Встановлення
 
-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`, який редактори використовують як виконуваний файл сервера.
+Встановіть його глобально (`npm install -g @intlayer/lsp`), якщо вашому редактору потрібен `intlayer-lsp` у `PATH` — це стосується плагіна Claude Code та будь-якої конфігурації нижче, що викликає бінарний файл напряму.
 
 ---
 
-## Налаштування як плагіна Claude Code
+## Налаштування
 
-Intlayer LSP доступний як **плагін Claude Code**, розміщений безпосередньо в репозиторії Intlayer на GitHub. Його встановлення дає 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 постачає **плагін для Claude Code**, розміщений у репозиторії Intlayer. Він дає 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 додасть `"intlayer-lsp@intlayer": true` до списку ваших `enabledPlugins` і автоматично запустить мовний сервер для підтримуваних типів файлів (`.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 додасть `"intlayer-lsp@intlayer": true` до списку в
 }
 ```
 
-Перезапустіть Claude Code — тепер він буде використовувати `goToDefinition`, `findReferences` та інші операції LSP при навігації по вашому коду Intlayer замість повернення до `grep`.
-
----
-
-## Налаштування у VS Code (через розширення — рекомендується)
-
-Якщо у вас встановлено [розширення Intlayer для VS Code](https://marketplace.visualstudio.com/items?itemName=Intlayer.intlayer-vs-code-extension), мовний сервер запускається автоматично. Ніякого додаткового налаштування не потрібно. LSP безпосередньо інтегровано в розширення VSCode, починаючи з версії 8.12.0.
-
-> Інструкції зі встановлення та опис інших функцій див. у [документації розширення VS Code](https://intlayer.org/doc/vs-code-extension).
-
----
-
-## Ручне налаштування у VS Code
-
-Якщо ви не використовуєте розширення Intlayer, ви можете підключити мовний сервер вручну, використовуючи універсальне розширення клієнта LSP, таке як [**vscode-glspc**](https://marketplace.visualstudio.com/items?itemName=sibiraj-s.vscode-scss-formatter), або написавши власне невелике розширення. Рекомендований підхід — використовувати розширення Intlayer.
-
-Для довідки, сервер запускається через бінарний файл `intlayer-lsp` через stdio:
-
-```json fileName=".vscode/settings.json"
-{
-  "intlayer.languageServer.command": "npx",
-  "intlayer.languageServer.args": ["@intlayer/lsp"]
-}
-```
-
-Розширення Intlayer зчитує ці налаштування для запуску сервера. Якщо ви використовуєте лише розширення, ручні налаштування не потрібні.
-
----
-
-## Налаштування в Cursor
-
-[Cursor](https://www.cursor.com/) — це форк VS Code з вбудованими функціями ШІ. Він використовує ту саму екосистему розширень, тому **розширення Intlayer для VS Code** працює без додаткового налаштування — встановіть його один раз, і Cursor підхопить його автоматично.
-
-Якщо ви віддаєте перевагу ручному налаштуванню, Cursor також зчитує файл `.vscode/settings.json` з кореня робочої області, тому наведений вище фрагмент коду для VS Code застосовується безпосередньо.
-
----
-
-## Налаштування в Windsurf
-
-[Windsurf](https://windsurf.com/) (від Codeium) — ще один редактор на базі VS Code. Встановіть розширення Intlayer з VS Code Marketplace, і мовний сервер активується автоматично, точно так само, як у 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 @@ Claude Code додасть `"intlayer-lsp@intlayer": true` до списку в
     }
   },
   "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", "..."] }
   }
 }
 ```
 
-Плейсхолдер `"..."` вказує Zed зберігати стандартні мовні сервери разом із сервером Intlayer.
-
----
-
-## Налаштування для інтерфейсів командного рядка ШІ-агентів (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).
+  </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 натискання `gd` на ключі Intlayer викличе функцію переходу до визначення.
-
----
-
-## Ручне налаштування в інших редакторах
-
-Будь-який редактор із підтримкою Language Server Protocol може використовувати `@intlayer/lsp`. Характеристики сервера:
+Після перезапуску Neovim `gd` на ключі словника виконує перехід до визначення, а `gr` — пошук посилань.
 
-- **Транспорт** – Node.js IPC / stdio (стандартний)
-- **Виконуваний файл** – `npx @intlayer/lsp` (або локально встановлений бінарний файл `intlayer-lsp`)
-- **Можливості** – `definitionProvider: true`, `textDocumentSync: Incremental`
-
-Формат конфігурації для вашого редактора (наприклад, `languageserver.json` для [coc.nvim](https://github.com/neoclide/coc.nvim) або налаштування клієнта LSP в [Helix](https://helix-editor.com)) дивіться в його документації.
-
-### Приклад: coc.nvim
+  </Tab>
+  <Tab label="coc.nvim" value="coc">
 
 ```json fileName="~/.config/nvim/coc-settings.json"
 {
@@ -307,9 +223,14 @@ lspconfig.intlayer_lsp.setup({})
 }
 ```
 
-### Пример: 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` (символи-тригери `"` `'` `` ` `` `.`), push-діагностика, `textDocumentSync: Incremental`
+- **Шаблони кореня** — `intlayer.config.ts`, `intlayer.config.js`, `package.json`
+
+Точний формат конфігурації дивіться в документації LSP вашого редактора.
+
+  </Tab>
+</Tabs>
+
 ---
 
-## Як це працює
+## Примітка про ШІ-агентів у терміналі
 
-При запуску сервер зчитує конфігурацію Intlayer з кореня робочої області за допомогою `getConfiguration()`. Це вказує йому шляхи `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` — по одному на кожен вихідний файл.
+---
 
-Конфігурація вирішується ліниво і кешується для кожного сеансу; вона скидається при кожному запиті `initialize` (наприклад, при відкритті нової папки робочої області).
+## Як це працює
+
+Для кожного файлу сервер знаходить найближчий `intlayer.config.*` і завантажує конфігурацію цього проєкту, щоб знайти скомпільовані словники. Конфігурація, словники та список вихідних файлів кешуються з коротким TTL і скидаються при зміні відстежуваного файлу контенту.
+
+На запит сервер розбирає документ (через [oxc](https://oxc.rs/)) і аналізує позицію курсора:
+
+1. **На рядку ключа** (`useIntlayer("home")`) → повертає кожен файл контенту, що оголошує цей ключ, із позицією на рядку `key:`.
+2. **На використанні поля** (`content.title`, деструктуризована властивість, `t('path.to.field')`, `<Trans>`, …) → зводить змінну назад до її словника й повертає відповідне поле у файлах контенту.
+3. **З файлу контенту** → виконує зворотний пошук, переглядаючи джерела проєкту в пошуках місць виклику цього ключа або поля.
 
 ---
 
-## Усунення неполадок
+## Усунення несправностей
+
+| Симптом                                     | Ймовірна причина                 | Рішення                                                                    |
+| ------------------------------------------- | -------------------------------- | -------------------------------------------------------------------------- |
+| Нічого не відбувається                      | Сервер не запущено               | Переконайтеся, що `@intlayer/lsp` встановлено і редактор його запускає     |
+| Працює в редакторі, але не в Claude Code    | Плагін встановлено під час сесії | Перезапустіть Claude Code — мовні сервери завантажуються під час старту    |
+| Визначення для ключа не знайдено            | Словники не зібрано              | Виконайте `npx intlayer build` або запустіть dev-сервер                    |
+| Усі ключі позначені як неоголошені          | Конфігурацію не розв’язано       | Перевірте, що `intlayer.config.ts` (або `.js`) є в корені проєкту          |
+| У монорепозиторії використано не той проєкт | Немає конфігурації в пакеті      | Додайте `intlayer.config.*` до кожного пакета, що оголошує власний контент |
+| Сервер падає при запуску                    | Застара версія Node.js           | Потрібен Node.js ≥ 14.18                                                   |
 
-| Симптом                                   | Можлива причина              | Вирішення                                                                         |
-| ----------------------------------------- | ---------------------------- | --------------------------------------------------------------------------------- |
-| Перейти до визначення нічого не робить    | Сервер не запущений          | Переконайтеся, що `@intlayer/lsp` встановлений і редактор запускає його           |
-| Невірний корінь робочої області           | Кілька папок робочої області | Переконайтеся, що папка з `intlayer.config.ts` є першою папкою робочої області    |
-| Визначення не знайдено для ключа          | Конфігурація не вчинена      | Переконайтеся, що `intlayer.config.ts` (або `.js`) існує в корені робочої області |
-| Сервер аварійно завершує роботу на старті | Занадто стара версія Node.js | Потрібен Node.js ≥ 14.18                                                          |
+У VS Code сервер пише логи у **Вигляд → Вивід → «Intlayer LSP»** — це допомагає з’ясувати, яку конфігурацію було розв’язано і скільки словників знайдено.

package/docs/uk/packages/angular-intlayer/exports.md

@@ -50,14 +50,14 @@ import "angular-intlayer";
 ### Хуки
 
 | Хук                    | Опис                                                                                                               | Пов'язаний документ                                                                                                   |
-| ---------------------- | ------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------- | --- |
+| ---------------------- | ------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------- |
 | `useIntlayer`          | На основі `useDictionary`, але інжектує оптимізовану версію словника з згенерованої декларації.                    | -                                                                                                                     |
 | `useDictionary`        | Обробляє об'єкти, що схожі на словники (ключ, вміст). Обробляє переклади `t()`, перелічення (enumerations) тощо.   | -                                                                                                                     |
 | `useDictionaryAsync`   | Те саме, що `useDictionary`, але працює з асинхронними словниками.                                                 | -                                                                                                                     |
 | `useDictionaryDynamic` | Те саме, що `useDictionary`, але працює з динамічними словниками.                                                  | -                                                                                                                     |
 | `useLocale`            | Повертає поточну локаль і функцію для її встановлення.                                                             | -                                                                                                                     |
 | `usePathname`          | Повертає поточний шлях як `Signal<string>` з видаленим сегментом локалі. Реакгує на `popstate` через `DestroyRef`. | [usePathname](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/packages/angular-intlayer/usePathname.md) |
-| `useIntl`              | Повертає об'єкт Intl для поточної локалі.                                                                          | -                                                                                                                     |     |
+| `useIntl`              | Повертає об'єкт Intl для поточної локалі.                                                                          | -                                                                                                                     |
 | `useLoadDynamic`       | Хук для завантаження динамічних словників.                                                                         | -                                                                                                                     |
 
 ### Компоненти

package/docs/uk/per_locale_file.md

@@ -112,7 +112,7 @@ const config: IntlayerConfig = {
 export default config;
 ```
 
-Використовуючи цю конфігурацію, усі файли для кожної локалі будуть згенеровані з мовою за замовчуванням, встановленою на English. Вона також включає генерацію `.content` файлів за допомогою команди `transform` та компілятора. (Див. [Компілятор](https://intlayer.org/doc/compiler) або [Transform](https://intlayer.org/doc/concept/cli/transform) для докладнішої інформації.)
+Використовуючи цю конфігурацію, усі файли для кожної локалі будуть згенеровані з мовою за замовчуванням, встановленою на English. Вона також включає генерацію `.content` файлів за допомогою команди `transform` та компілятора. (Див. [Компілятор](https://intlayer.org/doc/compiler) або [Transform](https://intlayer.org/doc/concept/cli/extract) для докладнішої інформації.)
 
 ## Один файл з кількома перекладами