@intlayer/docs 8.11.2 → 8.11.3

package/docs/uk/introduction.md

@@ -2,12 +2,12 @@
 createdAt: 2025-08-23
 updatedAt: 2025-08-23
 title: Вступ
-description: Дізнайтеся, як працює Intlayer. Перегляньте кроки, які Intlayer виконує у вашому застосунку. Дізнайтеся, що роблять різні пакети.
+description: Дізнайтеся, як працює Intlayer. Ознайомтеся з кроками, які Intlayer використовує у вашому додатку. Дізнайтеся, для чого призначені різні пакети.
 keywords:
   - Вступ
   - Початок роботи
   - Intlayer
-  - Застосунок
+  - Додаток
   - Пакети
 slugs:
   - doc
@@ -20,15 +20,15 @@ history:
 
 # Документація Intlayer
 
-Ласкаво просимо до офіційної документації Intlayer! Тут ви знайдете все, що потрібно для інтеграції, конфігурації та опанування Intlayer для всіх ваших потреб з інтернаціоналізації (i18n), незалежно від того, працюєте ви з Next.js, React, Vite, Express або іншим JavaScript-середовищем.
+Ласкаво просимо до офіційної документації Intlayer! Тут ви знайдете все необхідне для інтеграції, налаштування та освоєння Intlayer для всіх ваших завдань з інтернаціоналізації (i18n), незалежно від того, чи працюєте ви з Next.js, React, Vite, Express або в іншому середовищі JavaScript.
 
 ## Вступ
 
 ### Що таке Intlayer?
 
-**Intlayer**, бібліотека інтернаціоналізації (i18n), розроблена спеціально для JavaScript-розробників. Вона дозволяє оголошувати ваш контент у будь-якому місці коду. Intlayer перетворює оголошення багатомовного контенту на структуровані словники, щоб їх було легко інтегрувати у ваш код. Використовуючи TypeScript, **Intlayer** робить розробку більш надійною та ефективною.
+**Intlayer** — це бібліотека інтернаціоналізації, розроблена спеціально для JavaScript-розробників. Вона дозволяє оголошувати ваш контент у будь-якому місці вашого коду. Вона перетворює оголошення багатомовного контенту на структуровані словники для легкої інтеграції у ваш код. Використання TypeScript робить **Intlayer** більш надійним та ефективним інструментом для вашої розробки.
 
-Intlayer також надає необов'язковий візуальний редактор, який дозволяє легко редагувати та керувати контентом. Цей редактор особливо корисний для розробників, які віддають перевагу візуальному інтерфейсу для управління контентом, або для команд, що генерують контент без необхідності працювати з кодом.
+Intlayer також надає опціональний візуальний редактор, який дозволяє легко редагувати та управляти вашим контентом. Цей редактор є особливо корисним для розробників, які віддають перевагу візуальному інтерфейсу для управління контентом, або для команд, які створюють контент без необхідності турбуватися про код.
 
 ### Приклад використання
 
@@ -47,10 +47,10 @@ const componentContent = {
   key: "component-key",
   content: {
     myTranslatedContent: t({
-      uk: "Привіт, світ",
       en: "Hello World",
       es: "Hola Mundo",
       fr: "Bonjour le monde",
+      uk: "Привіт, світе",
     }),
   },
 } satisfies Dictionary;
@@ -66,10 +66,10 @@ export default componentContent;
     "myTranslatedContent": {
       "nodeType": "translation",
       "translation": {
-        "uk": "Привіт, світ",
         "en": "Hello World",
         "fr": "Bonjour le monde",
-        "es": "Hola Mundo"
+        "es": "Hola Mundo",
+        "uk": "Привіт, світе"
       }
     }
   }
@@ -89,49 +89,49 @@ export const MyComponent: FC = () => {
 
 ## Основні можливості
 
-Intlayer пропонує низку можливостей, адаптованих під потреби сучасної веб-розробки. Нижче наведено ключові функції з посиланнями на докладну документацію для кожної:
+Intlayer пропонує безліч функцій, адаптованих до потреб сучасної веб-розробки. Нижче наведено ключові функції з посиланнями на детальну документацію для кожної з них:
 
-- **Підтримка інтернаціоналізації**: Розширюйте глобальне охоплення вашого застосунку за допомогою вбудованої підтримки інтернаціоналізації.
-- **Візуальний редактор**: Покращуйте свій робочий процес розробки за допомогою плагінів для редактора, створених для Intlayer. Перегляньте [Посібник із візуального редактора](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/intlayer_visual_editor.md).
-- **Гнучкість конфігурації**: Налаштуйте ваше середовище за допомогою широких опцій конфігурації, детально описаних у [Довіднику з конфігурації](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/configuration.md).
-- **Розширені інструменти CLI**: Ефективно керуйте своїми проєктами за допомогою командного інтерфейсу Intlayer. Дослідіть можливості в [Документації інструментів CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/index.md).
+- **Підтримка інтернаціоналізації**: Збільште глобальне охоплення вашого додатка за допомогою вбудованої підтримки інтернаціоналізації.
+- **Візуальний редактор**: Покращуйте свій робочий процес розробки за допомогою плагінів редактора, створених для Intlayer. Ознайомтеся з [Посібником з візуального редактора](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/intlayer_visual_editor.md).
+- **Гнучкість налаштування**: Налаштуйте своє середовище за допомогою широких можливостей конфігурації, детально описаних у [Посібнику з налаштування](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/configuration.md).
+- **Просунуті інструменти CLI**: Ефективно керуйте своїми проектами за допомогою інтерфейсу командного рядка Intlayer. Досліджуйте можливості у [Документації з інструментів CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/index.md).
 
-## Основні поняття
+## Основні концепції
 
-### Словник
+### Словник (Dictionary)
 
-Організуйте ваш багатомовний контент поруч із кодом, щоб усе залишалося узгодженим і простим у підтримці.
+Організовуйте свій багатомовний контент поруч із кодом, щоб все було узгоджено та зручно для обслуговування.
 
 - **[Початок роботи](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dictionary/content_file.md)**  
-  Дізнайтеся основи декларування вашого контенту в Intlayer.
+  Вивчіть основи оголошення вашого контенту в Intlayer.
 
-- **[Переклад](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dictionary/translation.md)**  
-  Дізнайтеся, як переклади генеруються, зберігаються та використовуються у вашому застосунку.
+- **[Переклад (Translation)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dictionary/translation.md)**  
+  Зрозумійте, як переклади генеруються, зберігаються та використовуються у вашому додатку.
 
-- **[Перелічення](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dictionary/enumeration.md)**  
-  Легко керуйте повторюваними або фіксованими наборами даних для різних мов.
+- **[Перелік (Enumeration)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dictionary/enumeration.md)**  
+  Легко керуйте повторюваними або фіксованими наборами даних різними мовами.
 
-- **[Умова](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dictionary/condition.md)**  
+- **[Умова (Condition)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dictionary/condition.md)**  
   Дізнайтеся, як використовувати умовну логіку в Intlayer для створення динамічного контенту.
 
-- **[Вставлення](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dictionary/insertion.md)**
-  Дізнайтеся, як вставляти значення в рядок за допомогою плейсхолдерів вставки.
+- **[Вставка (Insertion)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dictionary/insertion.md)**  
+  Дізнайтеся, як вставляти значення в рядок за допомогою плейсхолдерів (маркерів вставки).
 
-- **[Отримання за допомогою функцій](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dictionary/function_fetching.md)**  
-  Дізнайтеся, як динамічно отримувати контент за допомогою кастомної логіки, щоб відповідати робочому процесу вашого проєкту.
+- **[Отримання за допомогою функцій (Function Fetching)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dictionary/function_fetching.md)**  
+  Подивіться, як динамічно отримувати контент за допомогою користувацької логіки, щоб відповідати робочому процесу вашого проекту.
 
 - **[Markdown](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dictionary/markdown.md)**  
-  Дізнайтеся, як використовувати Markdown в Intlayer для створення насиченого контенту.
+  Дізнайтеся, як використовувати Markdown у Intlayer для створення багатого контенту.
 
-- **[Вбудовування файлів](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dictionary/file.md)**  
-  Дізнайтеся, як вбудовувати зовнішні файли в Intlayer для використання їх у редакторі контенту.
+- **[Вбудовування файлів (File embeddings)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dictionary/file.md)**  
+  Дізнайтеся, як вбудовувати зовнішні файли в Intlayer для їх використання в редакторі контенту.
 
-- **[Вкладення](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dictionary/nesting.md)**  
-  Дізнайтеся, як вкладати контент в Intlayer для створення складних структур.
+- **[Вкладеність (Nesting)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dictionary/nesting.md)**  
+  Зрозумійте, як вкладати контент у Intlayer для створення складних структур.
 
 ### Середовища та інтеграції
 
-Intlayer створено з урахуванням гнучкості, забезпечуючи безшовну інтеграцію з популярними фреймворками та інструментами збірки:
+Ми створили Intlayer з урахуванням гнучкості, забезпечивши безшовну інтеграцію у популярні фреймворки та інструменти збірки:
 
 - **[Intlayer з Next.js 16](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/intlayer_with_nextjs_16.md)**
 - **[Intlayer з Next.js 15](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/intlayer_with_nextjs_15.md)**
@@ -147,17 +147,44 @@ Intlayer створено з урахуванням гнучкості, забе
 - **[Intlayer з Vite + Vue](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/intlayer_with_vite+vue.md)**
 - **[Intlayer з Nuxt](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/intlayer_with_nuxt.md)**
 - **[Intlayer з Vite + Svelte](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/intlayer_with_vite+svelte.md)**
-- **[Intlayer з SvelteKit](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/intlayer_with_svelte_kit.md)**
+- **[Intlayer зі SvelteKit](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/intlayer_with_svelte_kit.md)**
 - **[Intlayer з Express](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/intlayer_with_express.md)**
 - **[Intlayer з NestJS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/intlayer_with_nestjs.md)**
-- **[Intlayer з Angular](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/intlayer_with_angular.md)**
+- **[Intlayer з Hono](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/intlayer_with_hono.md)**
+- **[Intlayer з Angular](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/intlayer_with_angular_21.md)**
 
-Кожен посібник з інтеграції містить найкращі практики використання можливостей Intlayer, таких як **server-side rendering**, **dynamic routing** або **client-side rendering**, щоб ви могли підтримувати швидкий, SEO-дружній та високо масштабований застосунок.
+Кожен посібник з інтеграції містить найкращі практики використання функцій Intlayer, такі як **рендеринг на стороні сервера (SSR)**, **динамічна маршрутизація** або **рендеринг на стороні клієнта**, щоб ви могли підтримувати швидкий, SEO-дружній і високомасштабований додаток.
 
-## Внесок і відгуки
+## Участь у розробці та відгуки
 
-Ми цінуємо силу open-source та розробку, що керується спільнотою. Якщо ви хочете запропонувати покращення, додати новий посібник або виправити будь-які помилки в нашій документації, не соромтеся надіслати Pull Request або відкрити issue у нашому [репозиторії на GitHub](https://github.com/aymericzip/intlayer/blob/main/docs/docs).
+Ми цінуємо силу open-source та розробки, керованої спільнотою. Якщо ви хочете запропонувати покращення, додати новий посібник або виправити будь-які проблеми у нашій документації, сміливо надсилайте Pull Request або відкривайте Issue у нашому [репозиторії на GitHub](https://github.com/aymericzip/intlayer/blob/main/docs/docs).
 
-**Готові перекласти ваш додаток швидше та ефективніше?** Ознайомтеся з нашою документацією, щоб почати використовувати Intlayer вже сьогодні. Відчуйте надійний, оптимізований підхід до інтернаціоналізації, який зберігає ваш контент впорядкованим і підвищує продуктивність вашої команди.
+**Готові перекладати свій додаток швидше та ефективніше?** Зануртеся в нашу документацію, щоб почати використовувати Intlayer вже сьогодні. Відчуйте надійний і оптимізований підхід до інтернаціоналізації, який забезпечує організованість вашого контенту та підвищує продуктивність вашої команди.
 
----
+### Чому Intlayer краще за альтернативи?
+
+Порівняно з основними рішеннями, такими як `next-intl` або `i18next`, Intlayer — це рішення, у якому початково присутні інтегровані оптимізації, такі як:
+
+**Розмір збірки (Bundle size)**
+
+Замість того, щоб завантажувати масивні JSON-файли на свої сторінки, завантажуйте лише необхідний контент. Intlayer допомагає **скоротити розмір ваших збірок і сторінок до 50%**.
+
+**Простота обслуговування (Maintainability)**
+
+Локалізація контенту поруч із компонентами вашого додатка **полегшує обслуговування** великомасштабних додатків. Ви можете дублювати або видалити папку окремої функції без необхідності перевіряти всю кодову базу контенту. Крім того, Intlayer є **повністю типізованим (fully typed)**, щоб гарантувати точність вашого контенту.
+
+**AI Agent (ШІ Агенти)**
+
+Спільне розміщення контенту **скорочує контекст, необхідний** для великих мовних моделей (LLMs). Intlayer також постачається з набором інструментів, таких як **CLI** для перевірки відсутніх перекладів, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/mcp_server.md)** та **[навички для агентів (agent skills)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/agent_skills.md)**, щоб зробити процес розробки (DX) ще більш плавним для ШІ-агентів.
+
+**Автоматизація (Automation)**
+
+Використовуйте автоматизацію для перекладу у вашому CI/CD конвеєрі за допомогою обраної вами LLM за вартістю вашого провайдера ШІ. Intlayer також пропонує **компілятор (compiler)** для автоматизації вилучення контенту, а також [веб-платформу](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/intlayer_CMS.md), щоб допомогти **перекладати у фоновому режимі**.
+
+**Продуктивність (Performance)**
+
+Підключення масивних JSON-файлів до компонентів може призвести до проблем із продуктивністю та реактивністю. Intlayer оптимізує завантаження вашого контенту під час збірки (build time).
+
+**Масштабованість без участі розробників (Scaling with non-dev)**
+
+Intlayer — це більше, ніж просто i18n-рішення. Він надає **[візуальний редактор (visual editor)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/intlayer_visual_editor.md)**, який можна розгорнути самостійно (self-hosted), та **[повноцінну CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/intlayer_CMS.md)**, щоб допомогти вам управляти вашим багатомовним контентом у **реальному часі**, роблячи співпрацю з перекладачами, копірайтерами та іншими членами команди безшовною. Контент може зберігатися локально та/або віддалено.

package/docs/uk/lsp.md

@@ -0,0 +1,351 @@
+---
+createdAt: 2025-06-07
+updatedAt: 2026-05-31
+title: LSP-сервер Intlayer
+description: Дізнайтеся, як мовний сервер Intlayer надає функцію «Перейти до визначення» та інші можливості IDE для useIntlayer, getIntlayer та пов'язаних викликів у всіх підтримуваних редакторах.
+keywords:
+  - LSP
+  - Мовний сервер
+  - Перейти до визначення
+  - IDE
+  - Intlayer
+  - VS Code
+  - Neovim
+  - TypeScript
+slugs:
+  - doc
+  - lsp
+history:
+  - version: 8.12.0
+    date: 2026-06-01
+    changes: "Release LSP"
+---
+
+# LSP-сервер Intlayer
+
+**Мовний сервер Intlayer (LSP)** — це реалізація [протоколу мовного сервера (LSP)](https://microsoft.github.io/language-server-protocol/), яка розширює можливості вашої IDE за допомогою інтелектуальних функцій, адаптованих під Intlayer. Наразі він надає функцію **Перейти до визначення (Go to Definition)** для викликів ключів словника, дозволяючи переходити безпосередньо з `useIntlayer("my-key")` у вашому компоненті до файлу `.content.ts`, який його оголошує.
+
+---
+
+## Навіщо використовувати LSP?
+
+При використанні Intlayer зв'язок між викликом на кшталт `useIntlayer("homepage")` та його оголошенням у `src/homepage.content.ts` є неявним. Без інструментів вам доведеться шукати файл вручну. LSP робить цей зв'язок явним:
+
+**Розуміння ШІ-агентами**
+
+ШІ-агенти для кодингу (Cursor, Windsurf, GitHub Copilot, Claude Code, Codex) покладаються на мовний сервер для вирішення символів та розуміння зв'язків між файлами. За запущеного Intlayer LSP агенти можуть відстежувати шлях від `useIntlayer("key")` до місця оголошення ключа, отримуючи точний контекст про доступні ключі контенту, структуру кожного словника та про те, які файли слід читати чи редагувати.
+
+**Перейти до визначення**
+
+Помістіть курсор на будь-який рядок із ключем словника всередині підтримуваного виклику геттера та натисніть `F12` (або `Cmd/Ctrl+клік`). Редактор відкриє файл оголошення контенту і помістить курсор на рядок `key:`.
+
+**Підтримка об'єднаних словників**
+
+Ключ може бути розділений між кількома файлами контенту (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`, `adonis-intlayer`, `intlayer`).
+
+### Підтримувані виклики геттерів
+
+Сервер виявляє наступні виклики функцій та витягує перший строковий літерал як ключ словника:
+
+| Функція       | Приклад                       |
+| ------------- | ----------------------------- |
+| `useIntlayer` | `useIntlayer("hero")`         |
+| `getIntlayer` | `getIntlayer("hero", locale)` |
+
+Дженерики TypeScript та додаткові аргументи ігноруються — важливий лише ключ.
+
+> `useDictionary` та `getDictionary` приймають уже імпортований об'єкт `Dictionary` як перший аргумент замість строкового ключа, тому вони не підтримують функцію «Перейти до визначення» та не відстежуються сервером.
+
+---
+
+## Встановлення
+
+LSP-сервер поширюється у складі пакета `@intlayer/lsp`:
+
+```bash packageManager="npm"
+npm install --save-dev @intlayer/lsp
+```
+
+```bash packageManager="yarn"
+yarn add --dev @intlayer/lsp
+```
+
+```bash packageManager="pnpm"
+pnpm add --save-dev @intlayer/lsp
+```
+
+```bash packageManager="bun"
+bun add --dev @intlayer/lsp
+```
+
+Пакет надає бінарний файл `intlayer-lsp`, який редактори використовують як виконуваний файл сервера.
+
+---
+
+## Налаштування як плагіна Claude Code
+
+Intlayer LSP доступний як **плагін Claude Code**, розміщений безпосередньо в репозиторії Intlayer на GitHub. Його встановлення дає Claude Code нативну підтримку функції «Перейти до визначення» для всіх викликів `useIntlayer` / `getIntlayer`.
+
+### 1. Встановіть бінарний файл мовного сервера
+
+```bash packageManager="npm"
+npm install -g @intlayer/lsp
+```
+
+```bash packageManager="yarn"
+yarn global add @intlayer/lsp
+```
+
+```bash packageManager="pnpm"
+pnpm add -g @intlayer/lsp
+```
+
+Це помістить виконуваний файл `intlayer-lsp` у ваш PATH, який викликається записом `lspServers` у плагіні.
+
+### 2. Зареєструйте маркетплейс Intlayer та встановіть плагін
+
+```bash
+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`).
+
+### 3. Увімкніть інструмент LSP (якщо він ще не активний)
+
+Деякі версії Claude Code вимагають встановлення прапорця функції LSP. Додайте наступне до вашого файлу `~/.claude/settings.json`, якщо перехід до визначення не працює після встановлення:
+
+```json fileName="~/.claude/settings.json"
+{
+  "env": {
+    "ENABLE_LSP_TOOL": "1"
+  }
+}
+```
+
+Перезапустіть Claude Code — тепер він буде використовувати `goToDefinition`, `findReferences` та інші операції LSP при навігації по вашому коду Intlayer замість повернення до `grep`.
+
+---
+
+## Налаштування у VS Code (через розширення — рекомендується)
+
+Якщо у вас встановлено [розширення Intlayer для VS Code](https://marketplace.visualstudio.com/items?itemName=Intlayer.intlayer-vs-code-extension), мовний сервер запускається автоматично. Ніякого додаткового налаштування не потрібно.
+
+> Інструкції зі встановлення та опис інших функцій див. у [документації розширення 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
+
+[Zed](https://zed.dev/) має вбудовану підтримку LSP через налаштування мови. Додайте запис у користувацькі налаштування Zed (`~/.config/zed/settings.json`):
+
+```json fileName="~/.config/zed/settings.json"
+{
+  "lsp": {
+    "intlayer-lsp": {
+      "binary": {
+        "path": "npx",
+        "arguments": ["--yes", "@intlayer/lsp"]
+      }
+    }
+  },
+  "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", "..."]
+    }
+  }
+}
+```
+
+Плейсхолдер `"..."` вказує Zed зберігати стандартні мовні сервери разом із сервером Intlayer.
+
+---
+
+## Налаштування для інтерфейсів командного рядка ШІ-агентів (Claude Code, Codex тощо)
+
+**Claude Code** має першокласну підтримку плагінів LSP — дотримуйтесь інструкцій з [налаштування плагіна Claude Code](#налаштування-як-плагіна-claude-code) вище, щоб отримати повноцінну функцію «Перейти до визначення» прямо в сесіях термінала.
+
+**OpenAI Codex** та інші консольні інструменти поки не працюють як клієнти LSP — вони безпосередньо читають і записують файли, а не підтримують постійний сеанс мовного сервера. Для цих інструментів цінність працюючого LSP виявляється опосередковано: коли сервер активний у супутньому редакторі (VS Code, Cursor, Windsurf тощо), його живий індекс доступний будь-якому ШІ-агенту, який може запитати його через контекст редактора (наприклад, Cursor Composer, Windsurf Cascade, GitHub Copilot Chat).
+
+Якщо ви працюєте виключно в терміналі без відкритого редактора, ви можете запустити мовний сервер у фоновому режимі, щоб він був готовий до підключення будь-якого редактора:
+
+```bash
+# Підтримувати сервер активним у фоновому режимі
+npx @intlayer/lsp &
+```
+
+---
+
+## Ручне налаштування в Neovim
+
+Використовуючи [nvim-lspconfig](https://github.com/neovim/nvim-lspconfig), зареєструйте користувацьку конфігурацію сервера:
+
+```lua fileName="~/.config/nvim/init.lua"
+local lspconfig = require('lspconfig')
+local configs = require('lspconfig.configs')
+
+if not configs.intlayer_lsp then
+  configs.intlayer_lsp = {
+    default_config = {
+      -- Запуск сервера за допомогою npx, щоб не потрібне було глобальне встановлення
+      cmd = { 'npx', '--yes', '@intlayer/lsp' },
+      filetypes = {
+        'typescript',
+        'typescriptreact',
+        'javascript',
+        'javascriptreact',
+        'vue',
+        'svelte',
+      },
+      root_dir = lspconfig.util.root_pattern(
+        'intlayer.config.ts',
+        'intlayer.config.js',
+        'package.json'
+      ),
+    },
+  }
+end
+
+lspconfig.intlayer_lsp.setup({})
+```
+
+Після перезапуску Neovim натискання `gd` на ключі Intlayer викличе функцію переходу до визначення.
+
+---
+
+## Ручне налаштування в інших редакторах
+
+Будь-який редактор із підтримкою Language Server Protocol може використовувати `@intlayer/lsp`. Характеристики сервера:
+
+- **Транспорт** – 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
+
+```json fileName="~/.config/nvim/coc-settings.json"
+{
+  "languageserver": {
+    "intlayer": {
+      "command": "npx",
+      "args": ["@intlayer/lsp"],
+      "filetypes": [
+        "typescript",
+        "typescriptreact",
+        "javascript",
+        "javascriptreact",
+        "vue",
+        "svelte"
+      ],
+      "rootPatterns": [
+        "intlayer.config.ts",
+        "intlayer.config.js",
+        "package.json"
+      ]
+    }
+  }
+}
+```
+
+### Пример: Helix
+
+```toml fileName="~/.config/helix/languages.toml"
+[[language]]
+name = "typescript"
+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"]
+```
+
+---
+
+## Як це працює
+
+При запуску сервер зчитує конфігурацію Intlayer з кореня робочої області за допомогою `getConfiguration()`. Це вказує йому шляхи `build` та `system`, необхідні для пошуку скомпільованих словників.
+
+На кожен запит **Перейти до визначення**:
+
+1. Сервер зчитує весь текст відкритого документа.
+2. Він сканує виклики геттерів (`useIntlayer`, `getIntlayer` тощо) за допомогою регулярного вираження.
+3. Він перевіряє, чи потрапляє позиція курсора всередину одного з цих викликів.
+4. Якщо потрапляє, він витягує ключ словника (група захоплення 3 регулярного вираження) і викликає `getUnmergedDictionaries()` для пошуку кожного файлу контенту, який оголошує цей ключ.
+5. Він зчитує кожен відповідний файл і знаходить точний рядок із `key: "<key>"`, щоб точно позиціонувати курсор.
+6. Він повертає масив об'єктів `Location` — по одному на кожен вихідний файл.
+
+Конфігурація вирішується ліниво і кешується для кожного сеансу; вона скидається при кожному запиті `initialize` (наприклад, при відкритті нової папки робочої області).
+
+---
+
+## Усунення неполадок
+
+| Симптом                                   | Можлива причина              | Вирішення                                                                         |
+| ----------------------------------------- | ---------------------------- | --------------------------------------------------------------------------------- |
+| Перейти до визначення нічого не робить    | Сервер не запущений          | Переконайтеся, що `@intlayer/lsp` встановлений і редактор запускає його           |
+| Невірний корінь робочої області           | Кілька папок робочої області | Переконайтеся, що папка з `intlayer.config.ts` є першою папкою робочої області    |
+| Визначення не знайдено для ключа          | Конфігурація не вчинена      | Переконайтеся, що `intlayer.config.ts` (або `.js`) існує в корені робочої області |
+| Сервер аварійно завершує роботу на старті | Занадто стара версія Node.js | Потрібен Node.js ≥ 14.18                                                          |