@intlayer/docs 9.4.4 → 9.5.0

package/docs/ru/migration_from_react-i18next_to_intlayer.md

@@ -34,7 +34,6 @@ author: aymericzip
 Вместо того чтобы загружать огромные JSON-файлы на ваших страницах, загружайте только необходимый контент. Intlayer помогает **сократить размер бандла и страниц до 50%**.
 
 </Accordion>
-
 <Accordion header="Поддерживаемость">
 
 Локализация контента на уровне компонентов и разделов делает крупные приложения **удобными для поддержки**. Вы можете дублировать или удалять целые директории с фичами без необходимости пересматривать всю базу контента. Кроме того, Intlayer **строго типизирован**, что гарантирует правильность вашего контента на уровне TypeScript.
@@ -42,25 +41,21 @@ author: aymericzip
 Intlayer также является **наиболее активно развивающимся** решением в экосистеме i18n — проблемы решаются быстро, регулярно добавляются адаптеры для новых фреймворков, а основное API постоянно дорабатывается на основе реальных отзывов разработчиков.
 
 </Accordion>
-
 <Accordion header="ИИ Агенты">
 
 Колокация контента **сокращает контекст, необходимый для работы** Больших Языковых Моделей (LLM). 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) еще более плавным для ИИ-агентов.
 
 </Accordion>
-
 <Accordion header="Автоматизация">
 
 Автоматизируйте переводы в вашем CI/CD-пайплайне, используя любую LLM по вашему выбору по цене вашего ИИ-провайдера. Intlayer также предоставляет **компилятор** для автоматического извлечения контента, а также [веб-платформу](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_CMS.md) для помощи с **фоновым переводом**.
 
 </Accordion>
-
 <Accordion header="Производительность">
 
 Привязка огромных JSON-файлов к компонентам может привести к проблемам с производительностью и реактивностью. Intlayer оптимизирует загрузку контента на этапе сборки (build-time).
 
 </Accordion>
-
 <Accordion header="Масштабируемость для не-разработчиков">
 
 Будучи больше, чем просто решением i18n, Intlayer предоставляет **[визуальный редактор](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)**, чтобы помочь вам управлять мультиязычным контентом в **реальном времени**, делая сотрудничество с переводчиками, копирайтерами и другими членами команды бесшовным. Контент может храниться как локально, так и/или удаленно.
@@ -68,8 +63,6 @@ Intlayer также является **наиболее активно разв
 </Accordion>
 </AccordionGroup>
 
----
-
 ## Стратегии миграции
 
 Существует две дополняющие друг друга стратегии миграции с `react-i18next` / `i18next` на Intlayer:
@@ -80,20 +73,15 @@ Intlayer также является **наиболее активно разв
 
 В этом руководстве сначала рассматривается **Стратегия 1** (адаптер совместимости), а затем — опциональная полная миграция.
 
----
-
 ## Оглавление
 
 <TOC/>
 
----
-
 ## Быстрая миграция
 
 Следующие шаги — это необходимый минимум для запуска вашего приложения `react-i18next` с Intlayer без изменений в коде компонентов.
 
 <Steps>
-
 <Step number={1} title="Установка зависимостей">
 
 Установите основные пакеты Intlayer и адаптер совместимости:
@@ -137,7 +125,6 @@ bun add intlayer react-intlayer @intlayer/react-i18next @intlayer/i18next @intla
 > Вы можете смело оставить установленными `react-i18next` и `i18next` — адаптер совместимости использует их как `devDependencies` / `peerDependencies` для типов TypeScript. Вам не нужно удалять какие-либо peer зависимости в `package.json`.
 
 </Step>
-
 <Step number={2} title="Настройка Intlayer">
 
 Команда `intlayer init` создает базовый файл `intlayer.config.ts`. Обновите его, указав ваши текущие локали, и настройте плагин `syncJSON` на ваши файлы сообщений:
@@ -172,7 +159,6 @@ export default config;
 > **`source`** сопоставляет локаль с путем к соответствующему JSON-файлу. **`location`** сообщает вотчеру (watcher) Intlayer, за какой папкой нужно следить для отслеживания изменений. Настройка `format: 'i18next'` гарантирует правильную обработку плейсхолдеров вроде `{{name}}`.
 
 </Step>
-
 <Step number={3} title="Добавление плагинов Intlayer в сборщик">
 
 Оберните вашу текущую конфигурацию сборщика плагином совместимости. Это подключает базовый плагин Intlayer, включает отслеживание контента и, что самое важное, **внедряет алиасы модулей**, так что во время сборки все импорты `import … from 'react-i18next'` (и `'i18next'`) прозрачно перенаправляются на `@intlayer/react-i18next` / `@intlayer/i18next`. Никаких изменений в исходном коде не требуется.
@@ -233,14 +219,11 @@ export default withIntlayer(nextConfig);
 > tAbout("counter.label"); // ✓ типизация
 > ```
 
----
-
 ## Полная миграция
 
 Следующие шаги необязательны и могут выполняться постепенно. Они открывают доступ ко всему набору функций Intlayer: визуальному редактору, CMS, строго типизированным файлам контента, ИИ-автоматизации переводов и многому другому.
 
 <Steps>
-
 <Step number={4} title="Явное переименование импортов (Опционально)" isOptional={true}>
 
 Плагин Intlayer уже справляется с подменой алиасов на уровне сборщика. Если вы хотите сделать зависимости явными в ваших исходных файлах, вы можете переименовать импорты вручную:
@@ -265,7 +248,6 @@ export default withIntlayer(nextConfig);
 | `import { useTranslation } from 'next-i18next'`                                | `import { useTranslation } from '@intlayer/next-i18next'`         |
 
 </Step>
-
 <Step number={5} title="Включение ИИ-автоматизации перевода" isOptional={true}>
 
 Когда Intlayer настроен, вы можете использовать CLI для автоматического заполнения недостающих переводов:
@@ -327,8 +309,6 @@ export default config;
 
 </Steps>
 
----
-
 ## Что можно удалить после миграции
 
 После настройки адаптера совместимости следующий стандартный бойлерплейт `react-i18next` / `i18next` можно удалить:
@@ -341,8 +321,6 @@ export default config;
 
 Когда вы будете готовы двигаться дальше, Intlayer **автоматически обнаружит все файлы `.content.ts` и `.content.json` в любом месте вашей кодовой базы** (по умолчанию, в любом месте внутри `./src`). Вы можете поместить файл `my-component.content.ts` прямо рядом с вашим кодом `MyComponent.tsx`, и Intlayer обнаружит его на этапе сборки без дополнительной настройки — не нужно никаких импортов, регистрации или центрального index-файла. Это делает совместное размещение переводов невероятно удобным.
 
----
-
 ## Настройка TypeScript
 
 Intlayer использует расширение модулей (module augmentation), чтобы предоставить полноценный IntelliSense в TypeScript для ключей перевода. Убедитесь, что ваш `tsconfig.json` включает автоматически сгенерированные типы:
@@ -357,8 +335,6 @@ Intlayer использует расширение модулей (module augmen
 }
 ```
 
----
-
 ## Настройка Git
 
 Добавьте сгенерированную директорию Intlayer в ваш `.gitignore`:
@@ -368,8 +344,6 @@ Intlayer использует расширение модулей (module augmen
 .intlayer
 ```
 
----
-
 ## Узнать больше
 
 - **Визуальный редактор** — Управляйте переводами визуально прямо в браузере: [Intlayer Visual Editor](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_visual_editor.md)

package/docs/ru/migration_from_vue-i18n_to_intlayer.md

@@ -33,7 +33,6 @@ author: aymericzip
 Вместо того чтобы загружать огромные JSON-файлы на ваших страницах, загружайте только необходимый контент. Intlayer помогает **сократить размер бандла и страниц до 50%**.
 
 </Accordion>
-
 <Accordion header="Поддерживаемость">
 
 Локализация контента на уровне компонентов и разделов делает крупные приложения **удобными для поддержки**. Вы можете дублировать или удалять целые директории с фичами без необходимости пересматривать всю базу контента. Кроме того, Intlayer **строго типизирован**, что гарантирует правильность вашего контента на уровне TypeScript.
@@ -41,25 +40,21 @@ author: aymericzip
 Intlayer также является **наиболее активно развивающимся** решением в экосистеме i18n — проблемы решаются быстро, регулярно добавляются адаптеры для новых фреймворков, а основное API постоянно дорабатывается на основе реальных отзывов разработчиков.
 
 </Accordion>
-
 <Accordion header="ИИ Агенты">
 
 Колокация контента **сокращает контекст, необходимый для работы** Больших Языковых Моделей (LLM). 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) еще более плавным для ИИ-агентов.
 
 </Accordion>
-
 <Accordion header="Автоматизация">
 
 Автоматизируйте переводы в вашем CI/CD-пайплайне, используя любую LLM по вашему выбору по цене вашего ИИ-провайдера. Intlayer также предоставляет **компилятор** для автоматического извлечения контента, а также [веб-платформу](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_CMS.md) для помощи с **фоновым переводом**.
 
 </Accordion>
-
 <Accordion header="Производительность">
 
 Привязка огромных JSON-файлов к компонентам может привести к проблемам с производительностью и реактивностью. Intlayer оптимизирует загрузку контента на этапе сборки (build-time).
 
 </Accordion>
-
 <Accordion header="Масштабируемость для не-разработчиков">
 
 Будучи больше, чем просто решением i18n, Intlayer предоставляет **[визуальный редактор](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)**, чтобы помочь вам управлять мультиязычным контентом в **реальном времени**, делая сотрудничество с переводчиками, копирайтерами и другими членами команды бесшовным. Контент может храниться как локально, так и/или удаленно.
@@ -67,8 +62,6 @@ Intlayer также является **наиболее активно разв
 </Accordion>
 </AccordionGroup>
 
----
-
 ## Стратегии миграции
 
 Существует две дополняющие друг друга стратегии миграции с `vue-i18n` на Intlayer:
@@ -79,20 +72,15 @@ Intlayer также является **наиболее активно разв
 
 В этом руководстве сначала рассматривается **Стратегия 1** (адаптер совместимости), а затем — опциональная полная миграция.
 
----
-
 ## Оглавление
 
 <TOC/>
 
----
-
 ## Быстрая миграция
 
 Следующие шаги — это необходимый минимум для запуска вашего приложения `vue-i18n` с Intlayer без изменений в коде компонентов.
 
 <Steps>
-
 <Step number={1} title="Установка зависимостей">
 
 Установите основные пакеты Intlayer и адаптер совместимости:
@@ -136,7 +124,6 @@ bun add intlayer vue-intlayer @intlayer/vue-i18n @intlayer/sync-json-plugin
 > Вы можете смело оставить установленным `vue-i18n` — адаптер совместимости использует его как `devDependency` / `peerDependency` для типов TypeScript.
 
 </Step>
-
 <Step number={2} title="Настройка Intlayer">
 
 Команда `intlayer init` создает базовый файл `intlayer.config.ts`. Обновите его, указав ваши текущие локали, и настройте плагин `syncJSON` на ваши файлы сообщений:
@@ -171,7 +158,6 @@ export default config;
 > **`source`** сопоставляет локаль с путем к соответствующему JSON-файлу. **`location`** сообщает вотчеру (watcher) Intlayer, за какой папкой нужно следить для отслеживания изменений. Настройка `format: 'icu'` гарантирует правильную обработку плейсхолдеров вроде `vue-i18n`.
 
 </Step>
-
 <Step number={3} title="Добавление плагинов Intlayer в сборщик">
 
 Оберните вашу текущую конфигурацию сборщика плагином совместимости. Это подключает базовый плагин Intlayer, включает отслеживание контента и, что самое важное, **внедряет алиасы модулей**, так что во время сборки все импорты `import … from 'vue-i18n'` прозрачно перенаправляются на `@intlayer/vue-i18n`. Никаких изменений в исходном коде не требуется.
@@ -222,14 +208,11 @@ export default defineNuxtConfig({
 > t("does.not.exist"); // ✗ Ошибка TypeScript
 > ```
 
----
-
 ## Полная миграция
 
 Следующие шаги необязательны и могут выполняться постепенно. Они открывают доступ ко всему набору функций Intlayer: визуальному редактору, CMS, строго типизированным файлам контента, ИИ-автоматизации переводов и многому другому.
 
 <Steps>
-
 <Step number={4} title="Явное переименование импортов (Опционально)" isOptional={true}>
 
 Плагин Intlayer уже справляется с подменой алиасов на уровне сборщика. Если вы хотите сделать зависимости явными в ваших исходных файлах, вы можете переименовать импорты вручную:
@@ -242,7 +225,6 @@ export default defineNuxtConfig({
 Это **прямые замены** — вам не нужно менять сигнатуры вызовов, аргументы или возвращаемые типы.
 
 </Step>
-
 <Step number={5} title="Включение ИИ-автоматизации перевода" isOptional={true}>
 
 Когда Intlayer настроен, вы можете использовать CLI для автоматического заполнения недостающих переводов:
@@ -304,8 +286,6 @@ export default config;
 
 </Steps>
 
----
-
 ## Что можно удалить после миграции
 
 После настройки адаптера совместимости следующий стандартный бойлерплейт `vue-i18n` можно удалить:
@@ -318,8 +298,6 @@ export default config;
 
 Когда вы будете готовы двигаться дальше, Intlayer **автоматически обнаружит все файлы `.content.ts` и `.content.json` в любом месте вашей кодовой базы** (по умолчанию, в любом месте внутри `./src`). Вы можете поместить файл `my-component.content.ts` прямо рядом с вашим кодом `MyComponent.vue`, и Intlayer обнаружит его на этапе сборки без дополнительной настройки — не нужно никаких импортов, регистрации или центрального index-файла. Это делает совместное размещение переводов невероятно удобным.
 
----
-
 ## Настройка TypeScript
 
 Intlayer использует расширение модулей (module augmentation), чтобы предоставить полноценный IntelliSense в TypeScript для ключей перевода. Убедитесь, что ваш `tsconfig.json` включает автоматически сгенерированные типы:
@@ -334,8 +312,6 @@ Intlayer использует расширение модулей (module augmen
 }
 ```
 
----
-
 ## Настройка Git
 
 Добавьте сгенерированную директорию Intlayer в ваш `.gitignore`:
@@ -345,8 +321,6 @@ Intlayer использует расширение модулей (module augmen
 .intlayer
 ```
 
----
-
 ## Узнать больше
 
 - **Визуальный редактор** — Управляйте переводами визуально прямо в браузере: [Intlayer Visual Editor](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_visual_editor.md)

package/docs/ru/packages/@intlayer_babel/export.md

@@ -43,8 +43,6 @@ npm install @intlayer/babel
 import { ... } from "@intlayer/babel";
 ```
 
----
-
 ### Плагины
 
 | Функция / Класс                | Описание                                                                                                                                                                                                           |
@@ -57,8 +55,6 @@ import { ... } from "@intlayer/babel";
 | `makeUsageAnalyzerBabelPlugin` | Фабричная функция, создающая плагин Babel для анализа использования `useIntlayer` / `getIntlayer` в исходном коде и агрегирования данных об использовании полей в общем `PruneContext`.                            |
 | `getSharedPruneContext`        | Вспомогательная функция, которая возвращает общий объект `PruneContext` для указанного базового каталога или `null`, если он еще не был инициализирован.                                                           |
 
----
-
 ### Утилиты настройки плагинов
 
 | Функция                    | Описание                                                                                                                                                     |
@@ -68,8 +64,6 @@ import { ... } from "@intlayer/babel";
 | `getPurgePluginOptions`    | Загружает конфигурацию Intlayer и возвращает `PurgePluginOptions`, готовые для использования с `intlayerPurgeBabelPlugin`.                                   |
 | `getMinifyPluginOptions`   | Загружает конфигурацию Intlayer и возвращает `MinifyPluginOptions`, готовые для использования с `intlayerMinifyBabelPlugin`.                                 |
 
----
-
 ### Типы
 
 | Тип                     | Описание                                                                                                                           |
@@ -87,8 +81,6 @@ import { ... } from "@intlayer/babel";
 | `CompatCallerConfig`    | Конфигурация совместимого анализатора использования для пакетов `compat-adapter` (имя вызывающего модуля и параметры обработки).   |
 | `ScriptBlock`           | Блок скрипта, извлеченный из SFC-файла (Vue или Svelte): содержимое, смещение начала и смещение конца.                             |
 
----
-
 ### Вспомогательные функции
 
 | Функция                           | Описание                                                                                                                                                          |
@@ -100,8 +92,6 @@ import { ... } from "@intlayer/babel";
 | `BABEL_PARSER_OPTIONS`            | Константа, представляющая параметры парсера Babel, охватывающие поддерживаемые фреймворки (React/Vue/Svelte/Angular/...).                                         |
 | `INTLAYER_CALLER_NAMES`           | Константный список исходных имен вызывающих модулей Intlayer: `['useIntlayer', 'getIntlayer']`.                                                                   |
 
----
-
 ## Пример использования
 
 ```js

package/docs/ru/packages/adonis-intlayer/t.md

@@ -27,14 +27,10 @@ author: aymericzip
 
 Функция `t` в пакете `adonis-intlayer` является основным инструментом для предоставления локализованных ответов в вашем приложении AdonisJS. Она упрощает интернационализацию (i18n), динамически выбирая контент на основе предпочтительного языка пользователя.
 
----
-
 ## Обзор
 
 Функция `t` используется для определения и получения переводов для заданного набора языков. Она автоматически определяет соответствующий язык для возврата на основе настроек запроса клиента, таких как заголовок `Accept-Language`. Если предпочтительный язык недоступен, она плавно переключается на локаль по умолчанию, указанную в вашей конфигурации.
 
----
-
 ## Ключевые особенности
 
 - **Динамическая локализация**: Автоматически выбирает наиболее подходящий перевод для клиента.
@@ -42,8 +38,6 @@ author: aymericzip
 - **Асинхронный контекст**: Беспрепятственно работает в рамках жизненного цикла запроса AdonisJS с использованием Async Local Storage.
 - **Поддержка TypeScript**: Обеспечивает типизацию для ваших переводов.
 
----
-
 ## Сигнатура функции
 
 ```typescript
@@ -58,8 +52,6 @@ t(translations: Record<string, any>): any;
 
 - Контент, соответствующий предпочтительному языку клиента.
 
----
-
 ## Загрузка промежуточного ПО (Middleware)
 
 Чтобы функция `t` работала правильно, вы **должны** зарегистрировать промежуточное ПО `intlayer` в вашем приложении AdonisJS.
@@ -68,8 +60,6 @@ t(translations: Record<string, any>): any;
 router.use([() => import("adonis-intlayer/middleware")]);
 ```
 
----
-
 ## Примеры использования
 
 ### Базовый пример
@@ -105,8 +95,6 @@ export default class ExampleController {
 }
 ```
 
----
-
 ## Продвинутые темы
 
 ### Механизм Fallback

package/docs/ru/packages/express-intlayer/t.md

@@ -28,14 +28,10 @@ author: aymericzip
 
 Функция `t` в пакете `express-intlayer` является основным инструментом для предоставления локализованных ответов в вашем приложении Express. Она упрощает интернационализацию (i18n), динамически выбирая контент на основе предпочтительного языка пользователя.
 
----
-
 ## Обзор
 
 Функция `t` используется для определения и получения переводов для заданного набора языков. Она автоматически определяет подходящий язык для возврата на основе настроек запроса клиента, таких как заголовок `Accept-Language`. Если предпочтительный язык недоступен, функция плавно переключается на язык по умолчанию, указанный в вашей конфигурации.
 
----
-
 ## Основные возможности
 
 - **Динамическая локализация**: Автоматически выбирает наиболее подходящий перевод для клиента.
@@ -43,8 +39,6 @@ author: aymericzip
 - **Легковесность и высокая скорость**: Разработано для высокопроизводительных приложений с минимальными накладными расходами.
 - **Поддержка строгого режима**: Обеспечивает строгое соблюдение объявленных локалей для надежного поведения.
 
----
-
 ## Сигнатура функции
 
 ```typescript
@@ -59,8 +53,6 @@ t(translations: Record<string, string>): string;
 
 - Строку, представляющую содержимое на предпочтительном языке клиента.
 
----
-
 ## Загрузка обработчика запросов интернационализации
 
 Чтобы обеспечить корректную работу функционала интернационализации, предоставляемого `express-intlayer`, вы **должны** загрузить промежуточное ПО интернационализации в начале вашего Express-приложения. Это активирует функцию `t` и гарантирует правильную обработку определения локали и перевода.
@@ -94,8 +86,6 @@ app.get("/", (_req, res) => {
 - **Контекст перевода**: Устанавливает необходимый контекст для корректной работы функции `t`, обеспечивая возврат переводов на нужном языке.
 - **Предотвращение ошибок**: Без этого промежуточного ПО использование функции `t` приведет к ошибкам во время выполнения, так как необходимая информация о локали будет недоступна.
 
----
-
 ## Примеры использования
 
 ### Простой пример
@@ -136,8 +126,6 @@ app.get("/error", (_req, res) => {
 });
 ```
 
----
-
 ### Использование вариантов локалей
 
 Укажите переводы для локальных вариантов:
@@ -184,8 +172,6 @@ app.get("/greet", (_req, res) => {
 });
 ```
 
----
-
 ## Продвинутые темы
 
 ### Механизм резервного варианта
@@ -210,8 +196,6 @@ export default config;
 - Если `defaultLocale` установлен в `Locales.CHINESE`, а клиент запрашивает `Locales.DUTCH`, возвращаемый перевод будет по умолчанию из `Locales.CHINESE`.
 - Если `defaultLocale` не определён, функция `t` будет использовать значение по умолчанию из `Locales.ENGLISH`.
 
----
-
 ### Принудительное соблюдение строгого режима
 
 Настройте функцию `t` для строгого соблюдения объявленных локалей:
@@ -238,8 +222,6 @@ const config = {
 export default config;
 ```
 
----
-
 ### Интеграция с TypeScript
 
 Функция `t` является типобезопасной при использовании с TypeScript. Определите типобезопасный объект переводов:
@@ -258,8 +240,6 @@ app.get("/morning", (_req, res) => {
 });
 ```
 
----
-
 ### Распространённые ошибки и их устранение
 
 | Проблема                       | Причина                                | Решение                                                     |
@@ -267,8 +247,6 @@ app.get("/morning", (_req, res) => {
 | Функция `t` не работает        | Middleware не подключен                | Убедитесь, что `app.use(intlayer())` добавлен до маршрутов. |
 | Ошибка отсутствующих переводов | Включён строгий режим без всех локалей | Предоставьте все необходимые переводы.                      |
 
----
-
 ## Советы по эффективному использованию
 
 1. **Централизуйте переводы**: Используйте централизованный модуль или JSON-файлы для управления переводами, чтобы повысить удобство сопровождения.
@@ -276,8 +254,6 @@ app.get("/morning", (_req, res) => {
 3. **Интегрируйте с фронтенд i18n**: Синхронизируйте с системой интернационализации на фронтенде для обеспечения бесшовного пользовательского опыта во всём приложении.
 4. **Оценивайте производительность**: Тестируйте время отклика вашего приложения при добавлении переводов, чтобы гарантировать минимальное влияние на производительность.
 
----
-
 ## Заключение
 
 Функция `t` является мощным инструментом для интернационализации на стороне сервера. Эффективно используя её, вы можете создать более инклюзивное и удобное для пользователя приложение для глобальной аудитории. Для продвинутого использования и подробных вариантов настройки обратитесь к [документации](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/configuration.md).

package/docs/ru/packages/hono-intlayer/t.md

@@ -27,14 +27,10 @@ author: aymericzip
 
 Функция `t` в пакете `hono-intlayer` является основным инструментом для предоставления локализованных ответов в вашем приложении Hono. Она упрощает интернационализацию (i18n), динамически выбирая контент на основе предпочтительного языка пользователя.
 
----
-
 ## Обзор
 
 Функция `t` используется для определения и получения переводов для заданного набора языков. Она автоматически определяет соответствующий язык для возврата на основе настроек запроса клиента, таких как заголовок `Accept-Language`. Если предпочтительный язык недоступен, она плавно переключается на локаль по умолчанию, указанную в вашей конфигурации.
 
----
-
 ## Ключевые особенности
 
 - **Динамическая локализация**: автоматически выбирает наиболее подходящий перевод для клиента.
@@ -42,8 +38,6 @@ author: aymericzip
 - **Легкость и скорость**: разработана для высокопроизводительных приложений с минимальными накладными расходами.
 - **Поддержка строгого режима**: обеспечивает строгое соблюдение объявленных локалей для надежной работы.
 
----
-
 ## Сигнатура функции
 
 ```typescript
@@ -58,8 +52,6 @@ t(translations: Record<string, string>): string;
 
 - Строка, представляющая контент на предпочтительном языке клиента.
 
----
-
 ## Загрузка обработчика запросов интернационализации
 
 Чтобы обеспечить корректную работу функций интернационализации, предоставляемых `hono-intlayer`, вы **должны** загрузить промежуточное ПО (middleware) интернационализации в начале вашего приложения Hono. Это активирует функцию `t` и обеспечит правильную обработку определения локали и перевода.
@@ -94,8 +86,6 @@ app.get("/", (c) => {
 - **Контекст перевода**: настраивает необходимый контекст для правильной работы функции `t`, гарантируя, что переводы возвращаются на правильном языке.
 - **Предотвращение ошибок**: без этого промежуточного ПО использование функции `t` приведет к ошибкам во время выполнения, так как необходимая информация о локали будет недоступна.
 
----
-
 ## Примеры использования
 
 ### Базовый пример
@@ -137,8 +127,6 @@ app.get("/error", (c) => {
 });
 ```
 
----
-
 ### Использование вариантов локали
 
 Укажите переводы для конкретных вариантов локалей:
@@ -156,8 +144,6 @@ app.get("/greet", (c) => {
 });
 ```
 
----
-
 ## Расширенные темы
 
 ### Механизм возврата (Fallback)
@@ -177,8 +163,6 @@ const config = {
 export default config;
 ```
 
----
-
 ### Принудительное использование строгого режима
 
 Настройте функцию `t` для обеспечения строгого соблюдения объявленных локалей:
@@ -189,8 +173,6 @@ export default config;
 | `inclusive` | Объявленные локали должны иметь переводы. Отсутствие перевода вызывает предупреждение, но контент принимается. |
 | `loose`     | Принимается любая существующая локаль, даже если она не объявлена.                                             |
 
----
-
 ### Интеграция с TypeScript
 
 Функция `t` является типобезопасной при использовании с TypeScript. Определите типобезопасный объект переводов:
@@ -209,8 +191,6 @@ app.get("/morning", (c) => {
 });
 ```
 
----
-
 ### Общие ошибки и устранение неполадок
 
 | Проблема                   | Причина                                | Решение                                                               |
@@ -218,8 +198,6 @@ app.get("/morning", (c) => {
 | Функция `t` не работает    | Промежуточное ПО не загружено          | Убедитесь, что `app.use("*", intlayer())` добавлено перед маршрутами. |
 | Ошибка отсутствия перевода | Включен строгий режим без всех локалей | Предоставьте все необходимые переводы.                                |
 
----
-
 ## Заключение
 
 Функция `t`, мощный инструмент для интернационализации бэкенда. Эффективно используя ее, вы можете создать более инклюзивное и удобное приложение для глобальной аудитории. Для получения информации о расширенном использовании и детальных параметрах конфигурации обратитесь к [документации](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/configuration.md).

package/docs/ru/packages/intlayer/comparePaths.md

@@ -45,8 +45,6 @@ author: aymericzip
 - Допускает отсутствие начальных слэшей и пустые значения (нормализуется к `/`)
 - Легковесная — построена поверх `getPathWithoutLocale`
 
----
-
 ## Сигнатура функции
 
 ```typescript
@@ -62,8 +60,6 @@ normalizePath(
 ): string
 ```
 
----
-
 ## Параметры
 
 - `pathname: string`
@@ -86,8 +82,6 @@ normalizePath(
 - **Тип**: `boolean`
 - **Описание**: `true`, когда оба входа разрешаются в один и тот же путь, независимый от локали, иначе `false`.
 
----
-
 ## Пример использования
 
 ### Базовое использование
@@ -132,8 +126,6 @@ const NavLink = ({ href, children }) => {
 };
 ```
 
----
-
 ## normalizePath
 
 `normalizePath` возвращает канонический путь, независимый от локали, используемый `comparePaths`. Он удаляет сегмент локали, протокол/хост, строку запроса и хэш, обеспечивает наличие одного начального слэша, удаляет любые конечные слэши (кроме корня) и возвращает `/` для пустых значений.
@@ -150,16 +142,12 @@ normalizePath(""); // "/"
 normalizePath("https://example.com/ru/path"); // "/path"
 ```
 
----
-
 ## Связанные функции
 
 - [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/intlayer/getPathWithoutLocale.md): Удаляет сегмент локали из URL или пути.
 - [`getPrefix`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/intlayer/getPrefix.md): Определяет префикс URL для заданной локали.
 - [`getLocalizedUrl`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/intlayer/getLocalizedUrl.md): Генерирует локализованный URL для указанной локали.
 
----
-
 ## TypeScript
 
 ```typescript