@intlayer/docs 8.11.2 → 8.11.3

package/docs/ru/introduction.md

@@ -2,7 +2,7 @@
 createdAt: 2025-08-23
 updatedAt: 2025-08-23
 title: Введение
-description: Узнайте, как работает Intlayer. Посмотрите шаги, используемые Intlayer в вашем приложении. Узнайте, что делают разные пакеты.
+description: Узнайте, как работает Intlayer. Ознакомьтесь с этапами, которые использует Intlayer в вашем приложении. Узнайте, для чего предназначены различные пакеты.
 keywords:
   - Введение
   - Начало работы
@@ -15,18 +15,18 @@ slugs:
 history:
   - version: 5.5.10
     date: 2025-06-29
-    changes: "Инициализация истории"
+    changes: "Init history"
 ---
 
 # Документация Intlayer
 
-Добро пожаловать в официальную документацию Intlayer! Здесь вы найдете все необходимое для интеграции, настройки и освоения Intlayer для всех ваших задач интернационализации (i18n), будь то работа с Next.js, React, Vite, Express или другой средой JavaScript.
+Добро пожаловать в официальную документацию Intlayer! Здесь вы найдете всё необходимое для интеграции, настройки и освоения Intlayer для всех ваших задач интернационализации (i18n), независимо от того, работаете ли вы с Next.js, React, Vite, Express или в другой среде JavaScript.
 
 ## Введение
 
 ### Что такое Intlayer?
 
-**Intlayer** - это библиотека интернационализации, разработанная специально для JavaScript-разработчиков. Она позволяет объявлять ваш контент в любом месте вашего кода. Она преобразует объявления многоязычного контента в структурированные словари для легкой интеграции в ваш код. Используя TypeScript, **Intlayer** делает вашу разработку более надежной и эффективной.
+**Intlayer** — это библиотека интернационализации, разработанная специально для JavaScript-разработчиков. Она позволяет объявлять ваш контент в любом месте вашего кода. Она преобразует объявление многоязычного контента в структурированные словари для легкой интеграции в ваш код. Использование TypeScript делает **Intlayer** более надежным и эффективным инструментом для вашей разработки.
 
 Intlayer также предоставляет опциональный визуальный редактор, который позволяет легко редактировать и управлять вашим контентом. Этот редактор особенно полезен для разработчиков, предпочитающих визуальный интерфейс для управления контентом, или для команд, создающих контент без необходимости беспокоиться о коде.
 
@@ -50,11 +50,11 @@ const componentContent = {
       en: "Hello World",
       es: "Hola Mundo",
       fr: "Bonjour le monde",
+      ru: "Привет мир",
     }),
   },
 } satisfies Dictionary;
 
-// Экспорт содержимого компонента по умолчанию
 export default componentContent;
 ```
 
@@ -68,7 +68,8 @@ export default componentContent;
       "translation": {
         "en": "Hello World",
         "fr": "Bonjour le monde",
-        "es": "Hola Mundo"
+        "es": "Hola Mundo",
+        "ru": "Привет мир"
       }
     }
   }
@@ -88,65 +89,102 @@ export const MyComponent: FC = () => {
 
 ## Основные возможности
 
-Intlayer предлагает множество функций, адаптированных для современных веб-разработок. Ниже приведены ключевые возможности с ссылками на подробную документацию по каждой из них:
+Intlayer предлагает множество функций, адаптированных для нужд современной веб-разработки. Ниже приведены ключевые функции со ссылками на подробную документацию по каждой из них:
 
-- **Поддержка интернационализации**: Расширьте глобальный охват вашего приложения с помощью встроенной поддержки интернационализации.
+- **Поддержка интернационализации**: Увеличьте глобальный охват вашего приложения с помощью встроенной поддержки интернационализации.
 - **Визуальный редактор**: Улучшите свой рабочий процесс разработки с помощью плагинов редактора, разработанных для Intlayer. Ознакомьтесь с [Руководством по визуальному редактору](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_visual_editor.md).
-- **Гибкость конфигурации**: Настраивайте вашу систему с помощью обширных опций конфигурации, подробно описанных в [Руководстве по конфигурации](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/configuration.md).
-- **Расширенные инструменты CLI**: Эффективно управляйте своими проектами с помощью командной строки Intlayer. Изучите возможности в [Документации по инструментам CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/index.md).
+- **Гибкость конфигурации**: Настройте свою среду с помощью широких возможностей конфигурации, подробно описанных в [Руководстве по настройке](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/configuration.md).
+- **Продвинутые CLI-инструменты**: Эффективно управляйте своими проектами с помощью интерфейса командной строки Intlayer. Изучите возможности в [Документации по инструментам CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/index.md).
 
 ## Основные концепции
 
-### Словарь
+### Словарь (Dictionary)
 
-Организуйте ваш многоязычный контент рядом с кодом, чтобы всё оставалось последовательным и удобным для поддержки.
+Организуйте свой многоязычный контент рядом с кодом, чтобы все было согласованно и удобно для обслуживания.
 
 - **[Начало работы](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/content_file.md)**  
   Изучите основы объявления вашего контента в Intlayer.
 
-- **[Перевод](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/translation.md)**  
-  Поймите, как создаются, хранятся и используются переводы в вашем приложении.
+- **[Перевод (Translation)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/translation.md)**  
+  Поймите, как переводы генерируются, хранятся и используются в вашем приложении.
 
-- **[Перечисление](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/enumeration.md)**  
+- **[Перечисление (Enumeration)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/enumeration.md)**  
   Легко управляйте повторяющимися или фиксированными наборами данных на разных языках.
 
-- **[Условие](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/condition.md)**  
+- **[Условие (Condition)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/condition.md)**  
   Узнайте, как использовать условную логику в Intlayer для создания динамического контента.
 
-- **[Вставка](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/insertion.md)**  
-  Узнайте, как вставлять значения в строку с помощью заполнителей вставки.
+- **[Вставка (Insertion)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/insertion.md)**  
+  Узнайте, как вставлять значения в строку с помощью плейсхолдеров (маркеров вставки).
 
-- **[Получение функций](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/function_fetching.md)**  
-  Узнайте, как динамически получать контент с помощью пользовательской логики, чтобы соответствовать рабочему процессу вашего проекта.
+- **[Получение с помощью функций (Function Fetching)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/function_fetching.md)**  
+  Посмотрите, как динамически получать контент с помощью пользовательской логики, чтобы соответствовать рабочему процессу вашего проекта.
 
 - **[Markdown](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/markdown.md)**  
-  Изучите, как использовать Markdown в Intlayer для создания насыщенного контента.
+  Узнайте, как использовать Markdown в Intlayer для создания богатого контента.
 
-- **[Встраивание файлов](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/file.md)**  
-  Узнайте, как встраивать внешние файлы в Intlayer для использования их в редакторе контента.
+- **[Встраивание файлов (File embeddings)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/file.md)**  
+  Узнайте, как встраивать внешние файлы в Intlayer для их использования в редакторе контента.
 
-- **[Вложенность](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/nesting.md)**  
-  Поймите, как создавать вложенный контент в Intlayer для построения сложных структур.
+- **[Вложенность (Nesting)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/nesting.md)**  
+  Поймите, как вкладывать контент в Intlayer для создания сложных структур.
 
 ### Окружения и интеграции
 
-Мы создали Intlayer с учетом гибкости, предлагая бесшовную интеграцию с популярными фреймворками и инструментами сборки:
+Мы создали Intlayer с учетом гибкости, обеспечив бесшовную интеграцию в популярные фреймворки и инструменты сборки:
 
+- **[Intlayer с Next.js 16](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_nextjs_16.md)**
 - **[Intlayer с Next.js 15](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_nextjs_15.md)**
 - **[Intlayer с Next.js 14 (App Router)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_nextjs_14.md)**
 - **[Intlayer с Next.js Page Router](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_nextjs_page_router.md)**
 - **[Intlayer с React CRA](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_create_react_app.md)**
 - **[Intlayer с Vite + React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_vite+react.md)**
+- **[Intlayer с React Router v7](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_react_router_v7.md)**
+- **[Intlayer с Tanstack Start](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_tanstack.md)**
 - **[Intlayer с React Native и Expo](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_react_native+expo.md)**
 - **[Intlayer с Lynx и React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_lynx+react.md)**
+- **[Intlayer с Vite + Preact](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_vite+preact.md)**
+- **[Intlayer с Vite + Vue](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_vite+vue.md)**
+- **[Intlayer с Nuxt](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_nuxt.md)**
+- **[Intlayer с Vite + Svelte](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_vite+svelte.md)**
+- **[Intlayer с SvelteKit](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_svelte_kit.md)**
 - **[Intlayer с Express](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_express.md)**
+- **[Intlayer с NestJS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_nestjs.md)**
+- **[Intlayer с Hono](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_hono.md)**
+- **[Intlayer с Angular](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_angular_21.md)**
 
-Каждое руководство по интеграции включает лучшие практики использования возможностей Intlayer, таких как **рендеринг на стороне сервера**, **динамическая маршрутизация** или **рендеринг на стороне клиента**, чтобы вы могли поддерживать быстрое, SEO-дружественное и высокомасштабируемое приложение.
+Каждое руководство по интеграции содержит лучшие практики использования функций Intlayer, такие как **рендеринг на стороне сервера (SSR)**, **динамическая маршрутизация** или **рендеринг на стороне клиента**, чтобы вы могли поддерживать быстрое, SEO-оптимизированное и высокомасштабируемое приложение.
 
-## Вклад и обратная связь
+## Участие в разработке и отзывы
 
-Мы ценим силу открытого исходного кода и разработки, управляемой сообществом. Если вы хотите предложить улучшения, добавить новое руководство или исправить любые ошибки в нашей документации, не стесняйтесь отправить 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/ru/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/mcp_server.md)** и **[навыки для агентов (agent skills)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/agent_skills.md)**, чтобы сделать процесс разработки (DX) еще более плавным для ИИ-агентов.
+
+**Автоматизация (Automation)**
+
+Используйте автоматизацию для перевода в вашем CI/CD конвейере с помощью выбранной вами LLM по стоимости вашего провайдера ИИ. Intlayer также предлагает **компилятор (compiler)** для автоматизации извлечения контента, а также [веб-платформу](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/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/ru/intlayer_visual_editor.md)**, который можно развернуть самостоятельно (self-hosted), и **[полноценную CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_CMS.md)**, чтобы помочь вам управлять вашим многоязычным контентом в **реальном времени**, делая сотрудничество с переводчиками, копирайтерами и другими членами команды бесшовным. Контент может храниться локально и/или удаленно.

package/docs/ru/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                                                          |

package/docs/ru/packages/vite-intlayer/exports.md

@@ -40,10 +40,10 @@ npm install vite-intlayer
 import "vite-intlayer";
 ```
 
-| Функция              | Описание                                                                            | Связанная документация                                                                                                 |
-| -------------------- | ----------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
-| `intlayer`           | Основной плагин Vite, который интегрирует Intlayer в процесс сборки.                | [intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/vite-intlayer/intlayer.md)           |
-| `intlayerPlugin`     | (**Устаревший**) Псевдоним для `intlayer`.                                          | [intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/vite-intlayer/intlayer.md)           |
-| `intlayerProxy`      | Плагин middleware для разработки, отвечающий за определение локали и маршрутизацию. | -                                                                                                                      |
-| `intlayerMiddleware` | (**Устаревший**) Псевдоним для `intlayerProxy`.                                     | -                                                                                                                      |
-| `intlayerPrune`      | Плагин для tree-shaking и удаления неиспользуемых словарей во время сборки.         | [intlayerPrune](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/vite-intlayer/intlayerPrune.md) |
+| Функция              | Описание                                                                                 | Связанная документация                                                                                                 |
+| -------------------- | ---------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
+| `intlayer`           | Основной плагин Vite, который интегрирует Intlayer в процесс сборки.                     | [intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/vite-intlayer/intlayer.md)           |
+| `intlayerPlugin`     | (**Устаревший**) Псевдоним для `intlayer`.                                               | [intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/vite-intlayer/intlayer.md)           |
+| `intlayerProxy`      | Плагин middleware для разработки, отвечающий за определение локали и маршрутизацию.      | -                                                                                                                      |
+| `intlayerMiddleware` | (**Устаревший**) Псевдоним для `intlayerProxy`.                                          | -                                                                                                                      |
+| `intlayerPrune`      | Плагин для tree-shaking и удаления неиспользуемых словарей во время сборки (build time). | [intlayerPrune](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/vite-intlayer/intlayerPrune.md) |

package/docs/ru/releases/v6.md

@@ -224,9 +224,9 @@ bun x intlayer build
 
 ## Улучшения логирования
 
-Система логирования была улучшена для предоставления более подробной информации о том, что происходит во время сборки и выполнения трансформаций.
+Система логирования была улучшена для предоставления более подробной информации о том, что происходит во время сборки (build time) и выполнения трансформаций.
 
-> Включите подробные логи, чтобы лучше понимать, что происходит во время сборки и выполнения трансформаций.
+> Включите подробные логи, чтобы лучше понимать, что происходит во время сборки (build time) и выполнения трансформаций.
 
 ```ts fileName="intlayer.config.ts"
 export default {

package/docs/ru/releases/v7.md

@@ -32,7 +32,7 @@ slugs:
 - Новые режимы маршрутизации: `prefix-no-default`, `prefix-all`, `no-prefix`, `search-params`
 - Хранение локали в соответствии с GDPR с использованием localStorage по умолчанию
 - Гибкая конфигурация хранения: cookies, localStorage, sessionStorage или несколько одновременно
-- Размер пакета Visual Editor уменьшен на 30%
+- Размер бандла Visual Editor уменьшен на 30%
 - Расширенные опции конфигурации middleware
 - Обновленное поведение команды fill для лучшего управления контентом
 - Повышенная стабильность с полным обновлением файлов деклараций контента
@@ -66,7 +66,7 @@ bun x intlayer build
 
 - Сохраняет скомпилированные декларации контента, чтобы избежать повторной обработки
 - Обнаруживает изменения и перестраивает только изменённые файлы
-- Значительно сокращает время сборки для крупных проектов
+- Значительно сокращает время сборки (build time) для крупных проектов
 
 ---
 

package/docs/ru/roadmap.md

@@ -108,7 +108,7 @@ Intlayer предоставляет различные методы для вс
 
    Intlayer позволяет объявлять контент в виде функций, обеспечивая как синхронное, так и асинхронное получение контента.
 
-   Синхронные функции: контент генерируется динамически во время сборки.
+   Синхронные функции: контент генерируется динамически во время сборки (build time).
 
    Асинхронные функции: динамически получают данные из внешних источников (например, API, баз данных).
 

package/docs/ru/testing.md

@@ -29,7 +29,7 @@ history:
 
 - **Отсутствующие переводы**: провалить CI, если для любого словаря отсутствуют обязательные локали.
 - **Отрисовка локализованного UI**: рендерить компоненты с провайдером конкретной локали и проверять видимый текст/атрибуты.
-- **Аудиты во время сборки**: запускать быстрый аудит локально через CLI.
+- **Аудиты во время сборки (build time)**: запускать быстрый аудит локально через CLI.
 
 ---