@intlayer/docs 9.4.3 → 9.5.0

package/docs/ru/cli/doc-review.md

@@ -89,11 +89,15 @@ bun x intlayer doc review
 
 **Опции режима проверки:**
 
-- **`--log`**: Режим только логирования. Не переводить с помощью ИИ; вместо этого логировать блоки, требующие внимания (с номерами строк и содержимым) для базовой и целевой локалей, чтобы помочь другому агенту сгенерировать переводы.
+- **`--mode [mode]`**: Как выполняется проверка. По умолчанию `apply`.
 
-> Пример: `npx intlayer doc review --mode report`
+  - `apply`: перевести расходящиеся блоки с помощью ИИ и записать файлы.
+  - `report`: не вызывать ИИ; записывать блоки, требующие внимания (с номерами строк и содержимым) для базовой и целевой локалей, чтобы помочь другому агенту сгенерировать переводы.
+  - `synthesis`: не вызывать ИИ и пропустить вывод поблочно; вывести только итоговый отчет о документах, которые актуальны, и тех, которые содержат блоки для редактирования.
 
-> Пример: `npx intlayer doc review --log`
+  > Пример: `npx intlayer doc review --mode report`
+
+  > Пример: `npx intlayer doc review --mode synthesis`
 
 Независимо от режима, запуск завершается синтезом, в котором перечисляются документы, согласованные с их базовым документом, и документы, которые все еще содержат блоки для редактирования.
 

package/docs/ru/cli/index.md

@@ -70,14 +70,10 @@ author: aymericzip
 
 # Intlayer CLI - Все команды Intlayer CLI для вашего многоязычного сайта
 
----
-
 ## Содержание
 
 <TOC/>
 
----
-
 ## Установка пакета
 
 Установите необходимые пакеты с помощью npm:

package/docs/ru/cli/login.md

@@ -20,8 +20,6 @@ author: aymericzip
 
 # Команда входа Intlayer CLI
 
----
-
 ## Описание
 
 Команда `login` Intlayer CLI позволяет аутентифицироваться в Intlayer CMS. Эта команда автоматически открывает ваш браузер по умолчанию, чтобы завершить процесс аутентификации и получить необходимые учетные данные (Client ID и Client Secret) для использования сервисов Intlayer.

package/docs/ru/compiler.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-09-09
-updatedAt: 2026-06-23
+updatedAt: 2026-09-08
 title: Intlayer Compiler | Автоматизированное извлечение контента для i18n
 description: Автоматизируйте процесс интернационализации с помощью Intlayer Compiler. Извлекайте контент напрямую из ваших компонентов для более быстрого и эффективного i18n в Vite, Next.js и других.
 keywords:
@@ -68,7 +68,7 @@ author: aymericzip
 
 ## Использование
 
-> The quickest way to wire the compiler in is the interactive setup: run `npx intlayer init --interactive` and select **Compiler**. On Vite there is nothing to configure — the compiler is plugged in directly through the `intlayerCompiler()` plugin. On Next.js the command scaffolds the `babel.config.js` shown below. The non-interactive `intlayer init` leaves the compiler setup untouched.
+> Самый быстрый способ подключить компилятор — интерактивная настройка: выполните `npx intlayer init --interactive` и выберите **Compiler**. В Next.js и Vite он активируется автоматически, как только установлено `compiler.enabled` и настроен путь `compiler.output`.
 
 <Tabs>
  <Tab value='vite'>
@@ -92,19 +92,13 @@ import { defineConfig } from "vite";
 import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
-  plugins: [
-    intlayer({
-      proxy: {
-        ignore: (req) => req.url?.startsWith("/api"),
-      },
-    }),
-  ],
+  plugins: [intlayer()],
 });
 ```
 
 > Самостоятельный плагин `intlayerCompiler()` по-прежнему экспортируется для расширенных настроек. Его регистрация вместе с `intlayer()` безопасна — компилятор дедублирует себя и запускается только один раз.
 
-See complete tutorial: [Intlayer Compiler with Vite+React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_vite+react_compiler.md)
+See complete tutorial: [Translate Vite and React with Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_vite+react.md)
 
 #### Поддержка фреймворков
 
@@ -131,7 +125,33 @@ npm install @intlayer/svelte-compiler
  </Tab>
  <Tab value='nextjs'>
 
-### Next.js (Babel)
+### Next.js
+
+В Next.js компилятор работает как загрузчик бандлера, `next-intlayer/extractor-loader`. `withIntlayer` регистрирует его для вас **как** в Turbopack, так и в webpack, писать `babel.config.js` не требуется.
+
+#### Установка
+
+```bash
+npm install @intlayer/babel
+```
+
+#### Конфигурация
+
+Ничего настраивать не нужно. Пока ваш `next.config.ts` проходит через `withIntlayer`, установки `@intlayer/babel` достаточно для регистрации загрузчика:
+
+```ts fileName="next.config.ts"
+import { withIntlayer } from "next-intlayer/server";
+
+export default withIntlayer({});
+```
+
+Загрузчик выполняется для файлов `.tsx` и `.jsx` перед `next-swc-loader`, поэтому он читает ваш исходный JSX. Содержимое, объявленное в компонентах, извлекается в файлы `.content` и собирается в `.intlayer` по мере компиляции файла.
+
+</Tab>
+
+ <Tab value="Babel">
+
+### Babel
 
 Для Next.js или других приложений на основе Webpack с использованием Babel вы можете настроить компилятор с помощью плагина `@intlayer/babel`.
 
@@ -166,8 +186,6 @@ module.exports = {
 
 Эта конфигурация гарантирует, что контент, объявленный в ваших компонентах, автоматически извлекается и используется для генерации словарей во время процесса сборки.
 
-See complete tutorial: [Intlayer Compiler with Next.js](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_nextjs_compiler.md)
-
  </Tab>
 </Tabs>
 

package/docs/ru/configuration.md

@@ -122,14 +122,10 @@ author: aymericzip
 
 Файлы конфигурации Intlayer позволяют настраивать различные аспекты плагина, такие как интернационализация, middleware и управление контентом. Этот документ содержит подробное описание каждого свойства в конфигурации.
 
----
-
 ## Содержание
 
 <TOC/>
 
----
-
 ## Поддержка форматов конфигурационных файлов
 
 Intlayer принимает форматы файлов конфигурации JSON, JS, MJS и TS:
@@ -143,8 +139,6 @@ Intlayer принимает форматы файлов конфигурации
 - `intlayer.config.mjs`
 - `.intlayerrc`
 
----
-
 ## Пример конфигурационного файла
 
 ````typescript fileName="intlayer.config.ts" codeFormat="typescript"
@@ -695,14 +689,10 @@ const config: IntlayerConfig = {
 export default config;
 ````
 
----
-
 ## Справочник по конфигурации
 
 Ниже описаны различные параметры конфигурации, доступные в Intlayer.
 
----
-
 ### Конфигурация интернационализации (Internationalization)
 
 Определяет настройки, связанные с интернационализацией, включая доступные языки и язык по умолчанию.
@@ -714,8 +704,6 @@ export default config;
 | `strictMode`      | Обеспечивает надежную реализацию интернационализированного контента с помощью TypeScript. | `string`   | `'inclusive'`       |                      | • Если `"strict"`: функция `t` требует определения каждого объявленного языка - вызывает ошибку, если какой-то отсутствует или не объявлен.<br/>• Если `"inclusive"`: предупреждает об отсутствующих языках, но разрешает использование существующих необъявленных.<br/>• Если `"loose"`: принимает любой существующий язык. |
 | `defaultLocale`   | Язык по умолчанию, используемый как запасной, если запрошенный язык не найден.            | `string`   | `Locales.ENGLISH`   | `'en'`               | Используется для определения языка, когда он не указан в URL, куки или заголовке.                                                                                                                                                                                                                                            |
 
----
-
 ### Конфигурация редактора (Editor)
 
 Определяет настройки для встроенного визуального редактора, включая порт сервера и статус включения.
@@ -747,8 +735,6 @@ export default config;
 | `flushInterval` | Миллисекунды между автоматическими пакетными отправками на бэкенд.         | `number`  | `20000`      | `10000` |                                                                                                                                                                          |
 | `sampleRate`    | Доля сессий для записи, от `0` (ни одной) до `1` (все).                    | `number`  | `1`          | `0.5`   | Выборка детерминирована для каждой сессии, поэтому записанная сессия сообщает обо всех своих событиях (без частичных воронок).                                           |
 
----
-
 ### Конфигурация маршрутизации (Routing)
 
 Настройки, управляющие поведением маршрутизации, включая структуру URL, хранение языков и управление middleware.
@@ -950,8 +936,6 @@ const config: IntlayerConfig = {
 export default config;
 ```
 
----
-
 ### Конфигурация контента (Content)
 
 Настройки, связанные с тем, как контент управляется в приложении, включая имена директорий, расширения файлов и производные конфигурации.
@@ -965,8 +949,6 @@ export default config;
 | `excludedPath`   | Директории, исключенные из сканирования контента.                                                         | `string[]` | `['**/node_modules/**', '**/dist/**', '**/build/**', '**/.intlayer/**', '**/.next/**', '**/.nuxt/**', '**/.expo/**', '**/.vercel/**', '**/.turbo/**', '**/.tanstack/**']` |                                                                                                                                                                                       | Пока не используется; планируется в будущем.                                                                                                                       |
 | `formatCommand`  | Команда для форматирования файлов контента при их локальной записи Intlayer.                              | `string`   | `undefined`                                                                                                                                                               | `'npx prettier --write "{{file}}" --log-level silent'` (Prettier), `'npx biome format "{{file}}" --write --log-level none'` (Biome), `'npx eslint --fix "{{file}}" --quiet'` (ESLint) | • `{{file}}` будет заменено на путь к файлу.<br/>• Если не определено, Intlayer определит автоматически (тестирует prettier, biome, eslint).                       |
 
----
-
 ### Конфигурация системы
 
 Параметры, связанные с внутренними путями и результатами вывода Intlayer. Эти параметры обычно являются внутренними и не должны требовать изменения пользователем.
@@ -1021,8 +1003,6 @@ dictionary: {
 };
 ```
 
----
-
 ### Конфигурация логгера (Log)
 
 Параметры для настройки вывода логов Intlayer.
@@ -1093,8 +1073,6 @@ Intlayer поддерживает несколько ИИ-провайдеров
 | `outputFormat`        | Управляет выходным форматом словарей.                                                                                            | `('esm' &#124; 'cjs')[]`         | `['esm', 'cjs']`                                                                                                                                                                  | `['cjs']`                                                                     |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
 | `traversePattern`     | Шаблоны, определяющие, какие файлы сканировать во время оптимизации.                                                             | `string[]`                       | `['**/*.{tsx,ts,js,mjs,cjs,jsx,vue,svelte,svte}', '!**/node_modules/**', '!**/dist/**', '!**/.intlayer/**', '!**/*.config.*', '!**/*.test.*', '!**/*.spec.*', '!**/*.stories.*']` | `['src/**/*.{ts,tsx}', '../ui-library/**/*.{ts,tsx}', '!**/node_modules/**']` | • Ограничьте оптимизацию релевантными файлами для повышения производительности сборки.<br/>• Игнорирует, если `optimize` выключен.<br/>• Использует шаблоны glob.                                                                                                                                                                                                                                                                                                                                                                                               |
 
----
-
 ### Конфигурация компилятора (Compiler)
 
 Настройки, управляющие компилятором Intlayer, который извлекает словари напрямую из ваших компонентов.
@@ -1114,8 +1092,6 @@ Intlayer поддерживает несколько ИИ-провайдеров
 | --------- | ---------------------------------------------------------------------- | --------------------------- |
 | `schemas` | Позволяет определять схемы Zod для валидации структуры ваших словарей. | `Record<string, ZodSchema>` |
 
----
-
 ### Плагины (Plugins)
 
 | Поле      | Описание                                | Тип                |
@@ -1131,25 +1107,21 @@ Intlayer поддерживает несколько ИИ-провайдеров
 В корне вашего проекта, рядом с `package.json`. Intlayer также принимает `intlayer.config.js`, `intlayer.config.mjs`, `intlayer.config.cjs` и JSON, поэтому файл соответствует той модульной системе, которую использует ваш проект.
 
 </Question>
-
 <Question title="Насколько i18n увеличивает размер моего бандла?">
 
 Гораздо меньше, чем при подходе на основе пространств имён, потому что страница никогда не загружает каталог, который не отображает. Разметка, отрендеренная на сервере, разрешает свой контент на сервере, и компилятор во время сборки заменяет вызовы `useIntlayer` точными записями словаря, которые использует компонент, поэтому неиспользуемые ключи и неиспользуемые языки отбрасываются. [Динамические словари](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dynamic_dictionaries/index.md) разделяют остальное по локалям. По сравнению с обычными альтернативами Intlayer сокращает размер бандла и страницы до 50%. См. [оптимизацию бандла](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/bundle_optimization.md) и [бенчмарк](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/benchmark/index.md).
 
 </Question>
-
 <Question title="Могу ли я мигрировать с `i18next`, `next-intl` или `react-i18next`, не переписывая свои компоненты?">
 
 Да, и есть два пути. Вы можете мигрировать контент постепенно с помощью [руководства по миграции с i18next](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/migration_from_i18next_to_intlayer.md) или [руководства по миграции с next-intl](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/migration_from_next-intl_to_intlayer.md). Или вы можете полностью сохранить свой текущий API: [адаптеры совместимости](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/compat/index.md) предоставляют точно такой же API, как `i18next`, `react-i18next`, `next-intl`, `next-i18next`, `react-intl`, `use-intl`, `vue-i18n` и `Lingui`, но обслуживаемый словарями Intlayer, поэтому меняются импорты, а код компонентов - нет.
 
 </Question>
-
 <Question title="Могу ли я сохранить свои существующие файлы переводов JSON?">
 
 Да. [Плагин синхронизации JSON](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/plugins/sync-json.md) сохраняет ваши файлы `/messages/{locale}/{namespace}.json` как источник истины и генерирует из них словари Intlayer, в обоих направлениях. [Плагин синхронизации PO](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/plugins/sync-po.md) делает то же самое для каталогов gettext, а [файлы по локали](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/per_locale_file.md) позволяют разделить контент по языкам вместо группировки локалей в одном файле.
 
 </Question>
-
 <Question title="Должен ли я переносить свой контент ключ за ключом?">
 
 Нет. Запустите `npx intlayer extract`, и Intlayer прочитает ваши исходные файлы, извлечёт строки, видимые пользователю, и запишет файл `.content` рядом с каждым из них, так что вы просматриваете diff вместо копирования строк в каталог по одной. См. [команду extract](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/extract.md).
@@ -1157,7 +1129,6 @@ Intlayer поддерживает несколько ИИ-провайдеров
 Для полностью автоматизированного конвейера [Компилятор Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/compiler.md) делает то же самое во время сборки на исходном коде JSX, TSX, Vue и Svelte, генерируя словари при каждом изменении, поэтому нет ключей, которые нужно поддерживать вручную. Он работает через статический анализ, поэтому строки, существующие только во время выполнения, остаются недоступными, и ему нужно несколько аннотаций, чтобы отличать текст, видимый пользователю, от логики приложения.
 
 </Question>
-
 <Question title="Какие инструменты для редактора и ИИ-агентов доступны?">
 
 Пять компонентов, все опциональные:
@@ -1169,49 +1140,41 @@ Intlayer поддерживает несколько ИИ-провайдеров
 - **[Плагин ESLint](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/eslint.md)**: `no-raw-text` помечает жёстко закодированные строки, с дополнительными правилами для статических ключей словаря и неиспользуемого контента.
 
 </Question>
-
 <Question title="Как добавить новый язык в моё приложение?">
 
 Добавьте локаль в `internationalization.locales`, затем запустите `npx intlayer fill`, чтобы перевести существующий контент на неё. Сгенерированные типы обновляются одновременно, поэтому любой файл контента без новой локали становится ошибкой типа, а не молчаливым откатом.
 
 </Question>
-
 <Question title="Как убрать префикс локали из моих URL?">
 
 Установите `routing.mode`. Значение по умолчанию `"prefix-no-default"` даёт `/about` для локали по умолчанию и `/fr/about` для остальных. `"prefix-all"` добавляет префикс каждой локали. `"no-prefix"` полностью держит локаль вне пути и разрешает её из cookie, заголовка или домена. `"search-params"` помещает её в строку запроса как `/about?locale=fr`.
 
 </Question>
-
 <Question title="Могу ли я обслуживать каждый язык с его собственного домена?">
 
 Да. `routing.domains` сопоставляет локаль с именем хоста, например `{ fr: 'example.fr', en: 'example.com' }`. Домен идентифицирует локаль, поэтому префикс к пути не добавляется, а `getLocalizedUrl` возвращает абсолютный URL на правильном домене.
 
 </Question>
-
 <Question title="Как определяется язык пользователя?">
 
 Через `routing.storage`, который перечисляет источники для чтения по порядку, обычно URL, затем cookie, затем заголовок `Accept-Language`. Явный выбор пользователя сохраняется, поэтому он побеждает при следующем визите.
 
 </Question>
-
 <Question title="Что делает routing.enableProxy?">
 
 Она управляет прокси маршрутизации локали - middleware, который разрешает префиксы и редиректы. Если не задано, прокси работает, но серверы разработки и предпросмотра игнорируют сохранённую локаль как источник редиректа, что избегает переброски на язык, который вы не тестируете; в продакшене поведение такое, как если бы значение было `true`. Установите `false`, чтобы обрабатывать маршрутизацию локали самостоятельно.
 
 </Question>
-
 <Question title="В чём разница между importMode static, dynamic и fetch?">
 
 `"static"`, значение по умолчанию, импортирует словари статически, поэтому они упакованы и читаются синхронно. `"dynamic"` импортирует их через Suspense, поэтому локаль загружается только когда компонент её отображает, что и нужно для больших наборов контента. `"fetch"` получает их из API живой синхронизации и откатывается к `"dynamic"` при сбое. См. [оптимизацию бандла](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/bundle_optimization.md) и [динамические словари](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dynamic_dictionaries/index.md).
 
 </Question>
-
 <Question title="Где указать ИИ-провайдера и API-ключ для автоматического перевода?">
 
 Либо в файле конфигурации, либо в командной строке с `--provider`, `--model` и `--api-key`. Ключ остаётся вашим: вызовы перевода идут с вашей машины или из вашего CI-раннера к выбранному вами провайдеру, поэтому ничего не проходит через третью сторону. См. [команду fill](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/fill.md).
 
 </Question>
-
 <Question title="Нужно ли перезапускать dev-сервер после изменения конфигурации?">
 
 Обычно нет. Watcher Intlayer следит за самим `intlayer.config.ts`: при сохранении он перезагружает конфигурацию и снова подготавливает словари, поэтому добавление локали или смена режима маршрутизации подхватывается как изменение контента. Однако конфигурация может кэшироваться системами. Перезапуск вашего приложения может быть хорошим решением.

package/docs/ru/dictionary/html.md

@@ -122,8 +122,6 @@ const myContent = html(
 
 При использовании метода `.use()` для HTML-узла предоставленные вами компоненты будут проверяться на соответствие определению, указанному в функции `html()` (если оно доступно).
 
----
-
 ## Рендеринг HTML
 
 Рендеринг можно осуществлять автоматически с помощью системы контента Intlayer или вручную с использованием специализированных инструментов.
@@ -477,8 +475,6 @@ const myContent = html(
   </Tab>
 </Tabs>
 
----
-
 ### Ручной рендеринг и расширенные инструменты
 
 Если вам нужно рендерить сырые HTML-строки или иметь больший контроль над маппингом компонентов, используйте следующие инструменты.
@@ -652,8 +648,6 @@ const myContent = html(
   </Tab>
 </Tabs>
 
----
-
 ## Справочник опций
 
 Эти опции могут быть переданы в `HTMLProvider`, `HTMLRenderer`, `useHTMLRenderer` и `renderHTML`.

package/docs/ru/dictionary/markdown.md

@@ -1178,8 +1178,6 @@ export class MyComponent {
   </Tab>
 </Tabs>
 
----
-
 ## Рендеринг на стороне сервера (SSR) и гидратация
 
 По сравнению с другими парсерами Markdown, такими как remark / rehype, Intlayer Markdown не имеет зависимостей и работает как на клиенте, так и на сервере.

package/docs/ru/dictionary/translation.md

@@ -27,47 +27,46 @@ author: aymericzip
 
 ## Определение переводов
 
-With `react-intlayer`, you can use translations in React components. Here's an example:
-
-  <Tab label="Next.js" value="nextjs">
+Функция `t` в `intlayer` позволяет объявлять контент на нескольких языках. Эта функция обеспечивает типобезопасность, вызывая ошибку при отсутствии каких-либо переводов, что особенно полезно в средах TypeScript.
 
-```tsx fileName="**/*.tsx" codeFormat={["typescript", "esm"]}
-"use client";
+Вот пример того, как объявлять контент с переводами.
 
-import type { FC } from "react";
-import { useIntlayer } from "next-intlayer";
-
-const MyComponent: FC = () => {
-  const content = useIntlayer("multi_lang");
+```typescript fileName="**/*.content.ts" contentDeclarationFormat={["typescript", "esm", "commonjs"]}
+import { t, type Dictionary } from "intlayer";
 
-  return (
-    <div>
-      <p>{content.welcomeMessage}</p>
-    </div>
-  );
-};
+interface Content {
+  welcomeMessage: string;
+}
 
-export default MyComponent;
+export default {
+  key: "multi_lang",
+  content: {
+    welcomeMessage: t({
+      en: "Welcome to our application",
+      fr: "Bienvenue dans notre application",
+      es: "Bienvenido a nuestra aplicación",
+    }),
+  },
+} satisfies Dictionary<Content>;
 ```
 
-```tsx fileName="**/*.tsx" codeFormat={["typescript", "esm"]}
-import type { Component } from "solid-js";
-import { useIntlayer } from "solid-intlayer";
-
-const MyComponent: Component = () => {
-  const content = useIntlayer("multi_lang");
-
-  return (
-    <div>
-      <p>{content.welcomeMessage}</p>
-    </div>
-  );
-};
-
-export default MyComponent;
+```json fileName="**/*.content.json" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "multi_lang",
+  "content": {
+    "welcomeMessage": {
+      "nodeType": "translation",
+      "translation": {
+        "en": "Welcome to our application",
+        "fr": "Bienvenue dans notre application",
+        "es": "Bienvenido a nuestra aplicación"
+      }
+    }
+  }
+}
 ```
 
-  </Tab>
 ## Конфигурация локалей
 
 Для обеспечения правильной обработки переводов вы можете настроить поддерживаемые локали в файле `intlayer.config.ts`. Эта конфигурация позволяет определить языки, которые поддерживает ваше приложение:

package/docs/ru/how_works_intlayer.md

@@ -269,25 +269,21 @@ Intlayer состоит из нескольких пакетов, каждый
 Во время сборки. Плагин сборщика или `npx intlayer build` сканирует ваши файлы `.content.ts`, разрешает их в словари в папке `.intlayer` и генерирует соответствующие типы TypeScript. Во время выполнения ваши компоненты только читают результат, поэтому на пути запроса не происходит ни разбора, ни загрузки файлов.
 
 </Question>
-
 <Question title="Насколько i18n увеличивает размер моего бандла?">
 
 Гораздо меньше, чем при подходе на основе пространств имён, потому что страница никогда не загружает каталог, который не отображает. Разметка, отрендеренная на сервере, разрешает свой контент на сервере, и компилятор во время сборки заменяет вызовы `useIntlayer` точными записями словаря, которые использует компонент, поэтому неиспользуемые ключи и неиспользуемые языки отбрасываются. [Динамические словари](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dynamic_dictionaries/index.md) разделяют остальное по локалям. По сравнению с обычными альтернативами Intlayer сокращает размер бандла и страницы до 50%. См. [оптимизацию бандла](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/bundle_optimization.md) и [бенчмарк](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/benchmark/index.md).
 
 </Question>
-
 <Question title="Могу ли я мигрировать с `i18next`, `next-intl` или `react-i18next`, не переписывая свои компоненты?">
 
 Да, и есть два пути. Вы можете мигрировать контент постепенно с помощью [руководства по миграции с i18next](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/migration_from_i18next_to_intlayer.md) или [руководства по миграции с next-intl](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/migration_from_next-intl_to_intlayer.md). Или вы можете полностью сохранить свой текущий API: [адаптеры совместимости](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/compat/index.md) предоставляют точно такой же API, как `i18next`, `react-i18next`, `next-intl`, `next-i18next`, `react-intl`, `use-intl`, `vue-i18n` и `Lingui`, но обслуживаемый словарями Intlayer, поэтому меняются импорты, а код компонентов - нет.
 
 </Question>
-
 <Question title="Могу ли я сохранить свои существующие файлы переводов JSON?">
 
 Да. [Плагин синхронизации JSON](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/plugins/sync-json.md) сохраняет ваши файлы `/messages/{locale}/{namespace}.json` как источник истины и генерирует из них словари Intlayer, в обоих направлениях. [Плагин синхронизации PO](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/plugins/sync-po.md) делает то же самое для каталогов gettext, а [файлы по локали](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/per_locale_file.md) позволяют разделить контент по языкам вместо группировки локалей в одном файле.
 
 </Question>
-
 <Question title="Должен ли я переносить свой контент ключ за ключом?">
 
 Нет. Запустите `npx intlayer extract`, и Intlayer прочитает ваши исходные файлы, извлечёт строки, видимые пользователю, и запишет файл `.content` рядом с каждым из них, так что вы просматриваете diff вместо копирования строк в каталог по одной. См. [команду extract](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/extract.md).
@@ -295,7 +291,6 @@ Intlayer состоит из нескольких пакетов, каждый
 Для полностью автоматизированного конвейера [Компилятор Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/compiler.md) делает то же самое во время сборки на исходном коде JSX, TSX, Vue и Svelte, генерируя словари при каждом изменении, поэтому нет ключей, которые нужно поддерживать вручную. Он работает через статический анализ, поэтому строки, существующие только во время выполнения, остаются недоступными, и ему нужно несколько аннотаций, чтобы отличать текст, видимый пользователю, от логики приложения.
 
 </Question>
-
 <Question title="Какие инструменты для редактора и ИИ-агентов доступны?">
 
 Пять компонентов, все опциональные:
@@ -307,43 +302,36 @@ Intlayer состоит из нескольких пакетов, каждый
 - **[Плагин ESLint](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/eslint.md)**: `no-raw-text` помечает жёстко закодированные строки, с дополнительными правилами для статических ключей словаря и неиспользуемого контента.
 
 </Question>
-
 <Question title="Что такое папка .intlayer и нужно ли её коммитить?">
 
 Это сгенерированный вывод: скомпилированные словари и сгенерированные типы. Он выводится из ваших файлов контента, поэтому должен быть указан в `.gitignore` и пересобираться вашим шагом сборки, точно как папка `dist`.
 
 </Question>
-
 <Question title="Как определяется активная локаль?">
 
 Из источников, перечисленных в `routing.storage`, по порядку: префикс URL, когда `routing.mode` его использует, затем cookie, затем заголовок `Accept-Language`, затем ваша локаль по умолчанию. Локаль, которую пользователь выбирает явно, сохраняется, поэтому переживает следующий визит. См. [справочник по конфигурации](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/configuration.md).
 
 </Question>
-
 <Question title="В чём разница между локальными и удалёнными словарями?">
 
 Локальный словарь объявляется в вашей кодовой базе и компилируется вместе с приложением. Удалённый словарь управляется в [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_CMS.md) и разрешается во время выполнения, поэтому может меняться без развёртывания. Оба читаются через одни и те же хуки, и удалённый контент откатывается к локальному объявлению, когда недоступен.
 
 </Question>
-
 <Question title="Работает ли Intlayer без TypeScript?">
 
 Да. Файлы контента можно писать на TypeScript, JavaScript, ESM, CommonJS или JSON. Именно TypeScript открывает сгенерированные типы и автодополнение, поэтому это рекомендуемая настройка, но она не обязательна.
 
 </Question>
-
 <Question title="Как серверный рендеринг и клиентский рендеринг используют один и тот же контент?">
 
 Сервер разрешает контент серверно отрендеренных компонентов напрямую, поэтому для этой разметки клиенту не отправляется никакой словарь. Клиентские компоненты читают те же словари через провайдер, который получает локаль, разрешённую на сервере, поэтому первый клиентский рендер совпадает с серверным HTML и не вспыхивает другим языком.
 
 </Question>
-
 <Question title="Как Intlayer избегает несоответствия гидратации по локали?">
 
 Локаль разрешается один раз на сервере и передаётся провайдеру, а не определяется снова в браузере. Поскольку клиент стартует с той же локали, что отрендерил сервер, разметка совпадает, что и ломается обычно при клиентском определении локали.
 
 </Question>
-
 <Question title="Нужно ли пересобирать проект, когда я добавляю перевод?">
 
 В разработке - нет: плагин следит за вашими файлами контента и пересобирает затронутые словари при сохранении. В продакшене словари являются частью сборки, если только контент не удалённый - в этом случае [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_CMS.md) и [живая синхронизация](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/live.md) применяют изменение без развёртывания.