@intlayer/docs 9.4.0-canary.0 → 9.4.0

package/docs/pt/self_hosting.md

@@ -21,12 +21,16 @@ author: aymericzip
 
 O Intlayer pode ser executado inteiramente na sua própria infraestrutura — nenhuma conta Intlayer Cloud é necessária. Um único comando inicializa uma stack pronta para produção:
 
+Um comando instala tudo:
+
 ```sh
 curl -fsSL https://intlayer.org/install.sh | sh
 ```
 
 O instalador baixa um `docker-compose.yml` e um `.env`, gera automaticamente os segredos necessários e inicia todos os containers com `docker compose up -d`.
 
+A única dependência externa é **MongoDB**: o backend se conecta a um cluster MongoDB **Atlas**, que você fornece. Tudo mais é executado dentro do container.
+
 ## Sumário
 
 <TOC/>
@@ -60,40 +64,82 @@ O Chromium (usado para a geração de screenshots do Puppeteer) é empacotado de
 - Portas `3000`, `3100`, `8025`, `9000` e `9001` disponíveis no host.
 - Um host Linux ou macOS (ou WSL2 no Windows).
 
+Tudo o resto — Bun, Redis, MinIO, Chromium — é enviado dentro da imagem.
+
 ---
 
-## Início Rápido
+## Início rápido
+
+### 1. Executar o instalador
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Ele verifica se o Docker está instalado e em execução, escreve `./intlayer.env` com `BETTER_AUTH_SECRET` e `S3_SECRET_ACCESS_KEY` já gerados, e baixa a imagem. Ele não inicia o contêiner — o backend não pode inicializar sem suas credenciais de banco de dados.
 
-Puxe e execute a imagem publicada, fornecendo suas credenciais e secrets do MongoDB Atlas:
+Executar o instalador novamente é seguro: um `intlayer.env` existente nunca será sobrescrito, então ele funciona também como o caminho para atualização.
+
+### 2. Preencha suas credenciais
+
+Abra `intlayer.env` e complete os valores marcados como `TODO`:
+
+```sh fileName="intlayer.env"
+DB_ID=<atlas-user>
+DB_MDP=<atlas-password>
+DB_CLUSTER=<cluster>.xxxxx.mongodb.net
+RESEND_API_KEY=<your-resend-key>
+```
+
+O arquivo também contém blocos comentados para recursos opcionais — [SMTP mailer](#global-mailer), `OPENAI_API_KEY` e os provedores OAuth. Descomente o que você precisar.
+
+> O arquivo é lido por `docker run --env-file`, que não remove aspas e trata tudo após `=` como o valor. Escreva valores simples e mantenha comentários em suas próprias linhas.
+
+### 3. Iniciar o container
+
+Este é o comando que o instalador imprime quando termina:
 
 ```sh
 docker run -d --name intlayer \
+  --restart unless-stopped \
   -p 3000:3000 \
   -p 3100:3100 \
   -p 9000:9000 \
   -p 9001:9001 \
   -v intlayer-data:/data \
-  -e DB_ID="<atlas-user>" \
-  -e DB_MDP="<atlas-password>" \
-  -e DB_CLUSTER="<cluster>.xxxxx.mongodb.net" \
-  -e BETTER_AUTH_SECRET="$(openssl rand -hex 32)" \
-  -e S3_SECRET_ACCESS_KEY="$(openssl rand -hex 16)" \
-  -e RESEND_API_KEY="<your-resend-key>" \
-  aymericzip/intlayer-selfhost
+  --env-file ./intlayer.env \
+  ghcr.io/aymericzip/intlayer-selfhost:latest
 ```
 
-Em seguida, abra **http://localhost:3000**.
+Em seguida, abra **http://localhost:3000**. O primeiro boot inicializa os datastores, então aguarde um minuto.
 
-> O dashboard é servido em `localhost`. Veja [Limitações](#limitations) — domínios personalizados não são suportados pela imagem publicada.
+> O dashboard é servido em `localhost`. Consulte [Limitações](#limitations) — domínios personalizados não são suportados pela imagem publicada.
 
----
+### Configurações do instalador
 
-## Início rápido
+O instalador lê algumas variáveis de ambiente. Como é canalizado para `sh`, passe-as para o shell em vez de para `curl`:
 
 ```sh
-curl -fsSL https://intlayer.org/install.sh | sh
+curl -fsSL https://intlayer.org/install.sh | INTLAYER_ENV_FILE=./config/intlayer.env sh
 ```
 
+| Variável                  | Padrão                                        | Descrição                          |
+| ------------------------- | --------------------------------------------- | ---------------------------------- |
+| `INTLAYER_IMAGE`          | `ghcr.io/aymericzip/intlayer-selfhost:latest` | Imagem a descarregar               |
+| `INTLAYER_ENV_FILE`       | `./intlayer.env`                              | Onde escrever o arquivo env        |
+| `INTLAYER_CONTAINER_NAME` | `intlayer`                                    | Nome do container                  |
+| `INTLAYER_DATA_VOLUME`    | `intlayer-data`                               | Volume nomeado montado em `/data`  |
+| `INTLAYER_APP_PORT`       | `3000`                                        | Porta do host para o painel        |
+| `INTLAYER_API_PORT`       | `3100`                                        | Porta do host para a API           |
+| `INTLAYER_S3_PORT`        | `9000`                                        | Porta do host para a API MinIO S3  |
+| `INTLAYER_CONSOLE_PORT`   | `9001`                                        | Porta do host para o console MinIO |
+
+> As quatro variáveis de porta apenas mudam o lado **host** do mapeamento impresso no comando `docker run`. A imagem publicada tem `http://localhost:3000`, `http://localhost:3100` e `http://localhost:9000` compilados no pacote do painel no momento da compilação, portanto remapeá-los deixa o navegador apontando para as portas antigas. Mantenha os padrões a menos que esteja criando sua própria imagem — veja [Limitações](#limitations).
+
+---
+
+## Início rápido
+
 O que o instalador faz:
 
 1. Verifica se `docker` e `docker compose` estão presentes.
@@ -117,8 +163,6 @@ Após a stack estar ativa, abra **http://localhost:3000** e crie sua primeira co
 | **minio**   | `minio/minio`                        | `9000` (S3), `9001` (console)  | Armazenamento de objetos compatível com S3 para avatares e screenshots |
 | **mailpit** | `axllent/mailpit`                    | `1025` (SMTP), `8025` (web UI) | Sink local de e-mail transacional                                      |
 
-As portas internas (mongo, redis) não são expostas ao host por padrão.
-
 > A porta `9000` do MinIO deve ser acessível pelo navegador porque os ativos carregados (avatares, screenshots) são carregados diretamente de `S3_PUBLIC_URL=http://localhost:9000/intlayer`.
 
 ---
@@ -174,8 +218,6 @@ As portas internas (mongo, redis) não são expostas ao host por padrão.
 | `LINKEDIN_CLIENT_ID`, `LINKEDIN_CLIENT_SECRET`           | Login OAuth do LinkedIn                                              |
 | `ATLASSIAN_CLIENT_ID`, `ATLASSIAN_CLIENT_SECRET`         | Login OAuth da Atlassian                                             |
 
----
-
 ### Global mailer
 
 Por padrão, todos os emails transacionais são enviados através do Resend usando `RESEND_API_KEY`. Implantações auto-hospedadas podem, em vez disso, rotear **todos** os emails — incluindo emails não-organizacionais, como redefinições de senha e magic links — através de um mailer global configurado com variáveis de ambiente.
@@ -261,16 +303,8 @@ const { data: dictionaries } = await dictionaryEndpoint(cms).getDictionaries();
 
 ## Atualizando
 
-Reexecutar o instalador em uma implantação existente realiza uma atualização contínua:
-
-```sh
-curl -fsSL https://intlayer.org/install.sh | sh
-```
-
 Isso baixa as imagens mais recentes e reinicia os containers com `docker compose pull && docker compose up -d`. Os volumes existentes (`mongo-data`, `redis-data`, `minio-data`) são preservados — sem perda de dados.
 
-Para atualizar manualmente de dentro do diretório `./intlayer/`:
-
 ```sh
 docker compose pull
 docker compose up -d
@@ -334,15 +368,12 @@ docker compose logs mongo
 docker compose logs redis
 ```
 
+Procure por `MongoDB connection error` próximo ao topo do log.
+
 ### Dashboard não consegue acessar a API
 
 Verifique se `VITE_BACKEND_URL` corresponde à URL onde o backend é acessível a partir do **navegador** (não da rede Docker). Se você alterou a porta do backend ou adicionou um proxy reverso, reconstrua a imagem do dashboard:
 
-```sh
-docker compose build app
-docker compose up -d app
-```
-
 ### Bucket MinIO ausente
 
 Se o serviço `minio-init` de execução única não foi executado (ou executou antes que o MinIO estivesse pronto), crie o bucket manualmente:

package/docs/ru/analytics.md

@@ -123,17 +123,6 @@ export default config;
 
 Удаление `@intlayer/analytics` даёт тот же эффект, что и `enabled: false`. Полный список полей см. в [справочнике по конфигурации](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/configuration.md).
 
-## Поддержка фреймворков
-
-Аналитика встроена в общий `IntlayerProvider` из `react-intlayer`, поэтому она доступна уже сегодня везде, где используется этот провайдер:
-
-| Фреймворк                                                | Статус                                                                                                      |
-| -------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
-| React                                                    | ✅ Доступно                                                                                                 |
-| Next.js (`next-intlayer`)                                | ✅ Доступно (через `react-intlayer`)                                                                        |
-| React Native / Expo (`react-native-intlayer`)            | ✅ Доступно (через `react-intlayer`)                                                                        |
-| Vue, Svelte, Angular, Solid, Preact, Lit, Astro, Vanilla | 🚧 Запланировано — тот же клиент, привязки на уровне провайдера по образцу развертывания `@intlayer/editor` |
-
 ## Использование
 
 ### Автоматическое отслеживание на уровне провайдера
@@ -177,6 +166,34 @@ const CTAButton = () => {
 
 ### Разрешение варианта на стороне клиента
 
+  </Tab>
+</Tabs>
+
+Weights необязательны — передайте один на вариант, чтобы изменить распределение, например `useExperiment("homepage-hero", ["default", "black_friday"], [9, 1])`.
+
+Затем дочерний компонент читает [Variant](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dynamic_dictionaries/variants.md) словаря, который совпадает:
+
+```tsx fileName="HeroBanner.tsx"
+import { useIntlayer } from "react-intlayer";
+
+export const HeroBanner = ({ variant }: { variant: string }) => {
+  const { headline, cta } = useIntlayer("hero-banner", { variant });
+
+  return (
+    <section>
+      <h1>{headline}</h1>
+      <a>{cta}</a>
+    </section>
+  );
+};
+```
+
+> Чтение варианта в **дочернем** компоненте — это то, что делает это работающим вне React: в Vue, Svelte, Solid и Angular селектор, передаваемый в `useIntlayer`, захватывается при инициализации компонента, поэтому чтение должно происходить в компоненте, который монтируется только после того, как вариант известен.
+
+Если эксперимент охватывает целую страницу, а не отдельный словарь, поместите вариант на provider вместо этого — см. [Ambient variant](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dynamic_dictionaries/variants.md#ambient-variant). Каждый `useIntlayer` ниже затем разрешается против него без изменения места вызова.
+
+Если вам нужно получить необработанное значение переменной за пределами компонента, обратитесь непосредственно к клиенту:
+
 ```tsx fileName="useHeroVariant.ts" codeFormat="tsx"
 import { getGlobalAnalyticsClient } from "@intlayer/analytics/client";
 
@@ -187,6 +204,8 @@ const variant = client?.getVariant("homepage-hero", [
 ]);
 ```
 
+> `getVariant` только присваивает — он не записывает экспозицию. Предпочитайте `useExperiment()`, иначе коэффициент конверсии не будет иметь знаменателя.
+
 ## Конфиденциальность и производительность
 
 - **Анонимность по дизайну**: сессии идентифицируются по ротируемому id; сервер когда-либо сохраняет только **SHA-256 хэш** этого id — никогда сам id и никогда IP-адрес.
@@ -236,6 +255,8 @@ const cms = createIntlayerCMS();
 const { data: audience } = await analyticsEndpoint(cms).getAudience(30);
 ```
 
+> **Только на стороне сервера.** `createIntlayerCMS()` аутентифицируется с помощью `clientId` + `clientSecret`, и секрет никогда не доступен в браузере — этот фрагмент кода выполнял бы неаутентифицированные запросы, если бы он там работал. Держите его в обработчике маршрута, серверном действии или скрипте.
+
 ## Полезные ссылки
 
 - [Динамические словари - Коллекции и варианты](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dynamic_dictionaries/index.md)

package/docs/ru/benchmark/tanstack.md

@@ -194,6 +194,8 @@ history:
 
 `Tolgee` решает многие из упомянутых ранее проблем. Мне показалось, что начать работу с ним сложнее, чем с другими инструментами с похожими подходами. Он не обеспечивает типобезопасность, что значительно затрудняет отлов отсутствующих ключей на этапе компиляции. Мне пришлось обернуть API Tolgee своими собственными, чтобы добавить обнаружение отсутствующих ключей.
 
+Пакет довольно тяжелый (~11.1kb, что более чем в 2 раза больше чем `react-intlayer`).
+
 На TanStack Start у меня также были проблемы с реактивностью: при смене локали мне приходилось принудительно перерендеривать провайдер и подписываться на события смены локали, чтобы загрузка на другом языке вела себя корректно.
 
 **(use-intl)** (`use-intl@4.9.1`):
@@ -208,6 +210,8 @@ history:
 
 Тем не менее, у него те же основные недостатки, что и у стеков, построенных на `t('a.b.c')`: оптимизация возможна, но отнимает очень много времени, а большие проекты рискуют столкнуться с плохими практиками.
 
+Пакет особенно тяжелый (~17.3kb, что примерно в 3.5× раз больше `react-intlayer`).
+
 Форматы сообщений также расходятся: `use-intl` использует ICU MessageFormat, в то время как `i18next` использует свой собственный формат, что усложняет инструментарий или миграцию при их смешивании.
 
 **(Lingui)** (`@lingui/core@5.3.0`):
@@ -218,6 +222,8 @@ history:
 
 `react-intl` - это производительная реализация от команды Format.js. DX остается многословным: `const intl = useIntl()` + `intl.formatMessage({ id: "xx.xx" })` добавляет сложности, лишней работы для JavaScript и привязывает глобальный экземппляр i18n ко многим узлам в дереве React.
 
+Пакет также тяжёлый (~14.4kb, что примерно в 3 раза больше, чем `react-intlayer`).
+
 ### 4 - Рекомендации
 
 В этом бенчмарке TanStack Start нет прямого эквивалента `next-translate` (плагин Next.js + `getStaticProps`). Для команд, которые действительно хотят API `t()` со зрелой экосистемой, `react-i18next` и `use-intl` остаются "разумным" выбором, но будьте готовы потратить много времени на оптимизацию, чтобы избежать утечек.

package/docs/ru/cli/ci.md

@@ -128,6 +128,8 @@ bun x intlayer ci fill --verbose --mode complete
 
 ### Использование в CI/CD конвейерах
 
+Запуск `intlayer init` создает две готовые к использованию GitHub Actions workflows для вас (см. [Scaffolded GitHub Actions](#scaffolded-github-actions) ниже). Пример здесь показывает эквивалентную настройку с использованием команды `ci` для монорепозитория, где учетные данные внедряются для каждого проекта из `INTLAYER_PROJECT_CREDENTIALS`.
+
 В вашей конфигурации CI/CD (например, GitHub Actions, GitLab CI) установите `INTLAYER_PROJECT_CREDENTIALS` как секрет:
 
 ```yaml

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

@@ -91,7 +91,13 @@ bun x intlayer doc review
 
 - **`--log`**: Режим только логирования. Не переводить с помощью ИИ; вместо этого логировать блоки, требующие внимания (с номерами строк и содержимым) для базовой и целевой локалей, чтобы помочь другому агенту сгенерировать переводы.
 
-  > Пример: `npx intlayer doc review --log`
+I'm ready to assist you with the translation audit. However, I notice that:
+
+> Пример: `npx intlayer doc review --mode report`
+
+> Пример: `npx intlayer doc review --log`
+
+Независимо от режима, запуск завершается синтезом, в котором перечисляются документы, согласованные с их базовым документом, и документы, которые все еще содержат блоки для редактирования.
 
 **Опции вывода записей:**
 

package/docs/ru/cli/fill.md

@@ -39,14 +39,6 @@ bun x intlayer fill
 
 Эта команда анализирует ваши файлы деклараций контента на предмет возможных проблем, таких как отсутствующие переводы, структурные несоответствия или несоответствия типов. Если будут обнаружены какие-либо проблемы, **intlayer fill** предложит или применит обновления для поддержания ваших словарей в согласованном и полном состоянии.
 
-Ключевые моменты:
-
-- Разделяет большие JSON-файлы на части, чтобы оставаться в пределах окна контекста модели ИИ.
-- Повторяет перевод, если формат вывода неверен.
-- Включает контекст, специфичный для приложения и файла, для повышения точности перевода.
-- Сохраняет существующие переводы, не перезаписывая их.
-- Обрабатывает файлы, части и локали параллельно с использованием системы очередей для увеличения скорости.
-
 ## Ключевые моменты:
 
 - Разделяет большие JSON файлы на chunks, чтобы оставаться в пределах контекстного окна AI модели.

package/docs/ru/cli/index.md

@@ -127,6 +127,8 @@ Intlayer принимает несколько форматов файлов к
 
 - **[Login](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/login.md)** - Аутентификация в Intlayer CMS и получение учетных данных для доступа
 
+> `intlayer login` выдает **ключ доступа** (`clientId` / `clientSecret`), который используется всеми командами с учетными данными. Секрет является учетными данными на стороне сервера и никогда не попадает в ваш пакет клиента — см. [Keeping the access key safe](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/login.md#keeping-the-access-key-safe).
+
 ### Основные команды
 
 - **[Build Dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/build.md)** - Сборка словарей из файлов объявления контента

package/docs/ru/cli/list_projects.md

@@ -52,8 +52,6 @@ bun x intlayer projects list
 
   > Пример: `npx intlayer projects list --base-dir /path/to/workspace`
 
-  > Пример: `npx intlayer projects list --base-dir /path/to/workspace`
-
 - **`--git-root`**: Выполнять поиск из корня git-репозитория вместо базовой директории. Это полезно для поиска всех проектов Intlayer в монорепозитории или git-репозитории.
 
   > Пример: `npx intlayer projects list --git-root`

package/docs/ru/cli/login.md

@@ -118,6 +118,34 @@ INTLAYER_CLIENT_SECRET=your_client_secret
 }
 ```
 
+## Безопасность ключа доступа
+
+`intlayer login` выдает **ключ доступа**: пару `clientId` / `clientSecret`, которую используют все аутентифицированные команды (`push`, `pull`, `fill`, `configuration push`, `live`, …) для аутентификации.
+
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  editor: {
+    clientId: process.env.INTLAYER_CLIENT_ID,
+    clientSecret: process.env.INTLAYER_CLIENT_SECRET,
+  },
+};
+
+export default config;
+```
+
+> **`clientSecret` — это учетные данные на стороне сервера.** Он предоставляет полный доступ к API в области проекта — чтение и запись ваших словарей, вашего проекта и вашей организации. Сохраняйте его в `.env` (игнорируется git) или в хранилище секретов CI, и никогда не встраивайте его непосредственно в файл конфигурации.
+
+Intlayer это обеспечивает, а не только документирует:
+
+- `clientSecret` **удаляется из конфигурации, которую встраивает ваш bundler**, поэтому он не может попасть в bundle браузера, независимо от того, какую интеграцию framework вы используете. Он читается только на стороне сервера, во время выполнения, из окружения.
+- `clientId` отличается: это **открытый** ключ проекта, безопасный для распространения и используемый [`@intlayer/analytics`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/analytics.md#how-events-are-authenticated) для получения краткосрочного токена только для приема.
+
+Достаточно закомментировать `clientId`, чтобы отключить все аутентифицированное поведение — получение удаленных словарей, доступ к CMS, аналитику — даже если переменные окружения все еще определены.
+
+Для CI pipelines предпочитайте [`ci` команду](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/ci.md), которая внедряет учетные данные на время одного запуска вместо их сохранения.
+
 ## Ручная настройка
 
 Если браузер не откроется автоматически, вы можете вручную перейти по URL, отображаемому в терминале.

package/docs/ru/cli/watch.md

@@ -48,5 +48,3 @@ bun x intlayer watch
 - **`--with`**: Запустить команду параллельно с наблюдением.
 
   > Пример: `npx intlayer watch --with "next dev --turbopack"`
-
-  > Пример: `npx intlayer watch --with "next dev --turbopack"`

package/docs/ru/compiler.md

@@ -40,6 +40,12 @@ author: aymericzip
 
 ## Почему стоит использовать Intlayer Compiler?
 
+- **Автоматизация**: Исключает необходимость ручного копирования содержимого в словари.
+
+- **Speed**: Оптимизированное извлечение контента, обеспечивающее быстроту вашего процесса сборки.
+
+- **Developer Experience**: Храните объявления контента в том месте, где они используются, улучшая поддерживаемость.
+
 - **Автоматизация**: устраняет необходимость вручную копировать и вставлять контент в словари.
 - **Скорость**: оптимизированное извлечение контента обеспечивает быструю сборку.
 - **Опыт разработчика**: храните объявления контента прямо там, где они используются, что улучшает поддерживаемость.
@@ -54,6 +60,8 @@ author: aymericzip
 - **Эвристическая неоднозначность**: Компилятор должен угадывать, что является пользовательским контентом, а что - логикой приложения (например, `className="active"`, коды состояния, ID продуктов). В сложных кодовых базах это может привести к ложным срабатываниям или пропущенным строкам, которые требуют ручных аннотаций и исключений.
 - **Только статическое извлечение**: Извлечение на основе компилятора полагается на статический анализ. Строки, которые существуют только во время выполнения (коды ошибок API, поля CMS и т.д.), не могут быть обнаружены или переведены компилятором в одиночку, поэтому вам все еще нужна дополнительная стратегия i18n времени выполнения.
 
+- **Извлечение только статических элементов**: Извлечение на основе компилятора полагается на статический анализ. Строки, которые существуют только во время выполнения (коды ошибок API, поля CMS и т. д.), не могут быть обнаружены или переведены самим компилятором, поэтому вам все еще нужна дополнительная стратегия i18n во время выполнения.
+
 Для более глубокого архитектурного сравнения см. блог-пост [Compiler vs. Declarative i18n](https://github.com/aymericzip/intlayer/blob/main/docs/blog/ru/compiler_vs_declarative_i18n.md).
 
 В качестве альтернативы, для автоматизации процесса i18n при сохранении полного контроля над контентом, Intlayer также предоставляет команду автоматического извлечения `intlayer extract` (см. [документацию CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/extract.md)) или команду `Intlayer: extract content to Dictionary` из расширения Intlayer VS Code (см. [документацию расширения VS Code](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/vs_code_extension.md)).
@@ -94,12 +102,18 @@ export default defineConfig({
 });
 ```
 
+> Самостоятельный плагин `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)
 
 #### Поддержка фреймворков
 
 Плагин Vite автоматически обнаруживает и обрабатывает различные типы файлов:
 
+- **React / JSX / TSX**: Обрабатывается нативно.
+
+- **Vue**: Requires `@intlayer/vue-compiler`.
+
 - **React / JSX / TSX**: Обрабатывается нативно.
 - **Vue**: Требуется `@intlayer/vue-compiler`.
 - **Svelte**: Требуется `@intlayer/svelte-compiler`.

package/docs/ru/configuration.md

@@ -735,8 +735,6 @@ export default config;
 | `liveSyncPort`               | Порт сервера live sync.                                                                                                                                                      | `number`                          | `4000`                              | `4000`                                                                                          |                                                                                                                                                                                                                                                  |
 | `liveSyncURL`                | URL сервера live sync.                                                                                                                                                       | `string`                          | `'http://localhost:{liveSyncPort}'` | `'https://example.com'`                                                                         | По умолчанию указывает на localhost; может быть изменен на удаленный сервер live sync.                                                                                                                                                           |
 
----
-
 ### Конфигурация аналитики (Analytics)
 
 Определяет настройки, связанные с аналитикой Intlayer: сбор данных о том, какой контент действительно показывается пользователям (просмотры страниц, показы контента), и поддержку A/B-тестирования контента.
@@ -988,6 +986,13 @@ export default config;
 
 Параметры, управляющие операциями со словарями, включая поведение автоматического заполнения и генерацию контента.
 
+Эта конфигурация словаря служит двум основным целям:
+
+1. **Default Values**: Определите значения по умолчанию при создании файлов объявления контента
+2. **Fallback Behavior**: Предоставьте резервные значения, когда определенные поля не определены, позволяя вам глобально определить поведение операций словаря
+
+Для получения дополнительной информации о файлах объявления контента и способе применения значений конфигурации см. [Документацию по файлам контента](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/content_file.md).
+
 | Поле                        | Описание                                                                                                                                                 | Тип                                                                                                             | По умолчанию   | Пример                                                                                      | Примечание                                                                                                                                                                                                                                                                                                                                                                                      |
 | --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | -------------- | ------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `fill`                      | Управляет тем, как генерируются выходные файлы автозаполнения (ИИ-перевод).                                                                              | `boolean` &#124; <br/> `FilePathPattern` &#124; <br/> `Partial<Record<Locale, boolean &#124; FilePathPattern>>` | `true`         | `{ en: '/locales/en/{{key}}.json', fr: ({ key }) => '/locales/fr/${key}.json', es: false }` | • `true`: путь по умолчанию (тот же файл, что и источник).<br/>• `false`: отключить.<br/>• Шаблон строка/функция генерирует файлы по языкам.<br/>• Объект по языкам: каждый язык соответствует своему шаблону; `false` игнорирует этот язык.<br/>• Включение `{{locale}}` активирует генерацию по языкам.<br/>• `fill` на уровне словаря всегда имеет приоритет над этой глобальной настройкой. |
@@ -1027,8 +1032,6 @@ dictionary: {
 | `mode`   | Указывает режим логгера.           | `'default'` &#124; <br/> `'verbose'` &#124; <br/> `'disabled'` | `'default'`     | `'verbose'`      | • `'verbose'`: логирует больше информации для отладки.<br/>• `'disabled'`: полностью отключает логгер. |
 | `prefix` | Префикс для всех сообщений в логе. | `string`                                                       | `'[intlayer] '` | `'[my prefix] '` |                                                                                                        |
 
----
-
 ### Конфигурация ИИ (AI)
 
 Настройки, управляющие ИИ-функциями Intlayer, включая провайдера, модель и API-ключ.
@@ -1068,8 +1071,6 @@ Intlayer поддерживает несколько ИИ-провайдеров
 | `baseURL`            | Базовый URL для ИИ API.                                                                                                                       | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                             | Нет          | `'https://api.openai.com/v1'` <br/> `'http://localhost:5000'` | Может указывать на локальный или кастомный эндпоинт ИИ API.                                                                                                                                                 |
 | `dataSerialization`  | Формат сериализации данных для ИИ-функций.                                                                                                    | `'json'` &#124; <br/> `'toon'`                                                                                                                                                                                                                                                                                                                                                                                                                       | `undefined`  | `'toon'`                                                      | • `'json'`: по умолчанию, надежно; потребляет больше токенов.<br/>• `'toon'`: меньше токенов, менее стабильно.<br/>• Дополнительные параметры передаются в модель как контекст (усилия рассуждения и т.д.). |
 
----
-
 ### Конфигурация сборки (Build)
 
 Параметры, управляющие тем, как Intlayer оптимизирует и компилирует интернационализацию вашего приложения.
@@ -1107,8 +1108,6 @@ Intlayer поддерживает несколько ИИ-провайдеров
 | `noMetadata`          | Если `true`, компилятор опускает метаданные словаря (ключ, обертку контента) из вывода.                                                                                                                                                                                                                               | `boolean`                                                                                                       | `false`      | `false` → `{"key":"my-key","content":{"key":"value"}}` <br/> `true` → `{"key":"value"}`                                                                  | • Полезно для вывода в формате i18next или ICU MessageFormat JSON.<br/>• Хорошо работает с плагином `loadJSON`.                                                                                         |
 | `dictionaryKeyPrefix` | Префикс ключа словаря                                                                                                                                                                                                                                                                                                 | `string`                                                                                                        | `''`         |                                                                                                                                                          | Добавить опциональный префикс для извлеченных ключей словарей                                                                                                                                           |
 
----
-
 ### Пользовательские схемы (Custom Schemas)
 
 | Поле      | Описание                                                               | Тип                         |

package/docs/ru/custom_domains.md

@@ -138,6 +138,38 @@ getMultilingualUrls("/about", { currentDomain: "intlayer.org" });
 
 Эти абсолютные URL готовы к использованию в тегах `<link rel="alternate" hreflang="...">` для SEO.
 
+## Вывод типов
+
+`routing.domains` сериализуется в созданное расширение модуля, поэтому
+`getLocalizedUrl` и `getLocalizedPath` сужают тип возвращаемого значения до точного
+URL-адреса, на который разрешается локаль с маршрутизацией по доменам — включая подавление префикса.
+
+```ts
+// routing: { mode: 'prefix-no-default', domains: { en: 'intlayer.org', zh: 'intlayer.zh' } }
+
+getLocalizedUrl("/about", "zh");
+//     ^? "https://intlayer.zh/about" | "/about"
+
+getLocalizedPath("/about", "zh");
+//     ^? "/about"   (никогда не является origin, и нет префикса /zh/)
+```
+
+Тип URL является **объединением** двух значений, которые может вернуть функция: абсолютный
+URL-адрес на домене локали и относительный, который она возвращает, когда
+визуализируемая страница уже находится на этом домене. `getLocalizedPath` не имеет такой
+неоднозначности — она никогда не выдает origin — поэтому остается одним литералом.
+
+Локали, которые используют один домен, сохраняют свой обычный префикс в типе:
+
+```ts
+getLocalizedUrl("/about", "fr");
+//     ^? "https://intlayer.org/fr/about" | "/fr/about"
+```
+
+> Повторно создайте типы (`npx intlayer build` или любой запуск dev server) после
+> изменения `routing.domains` — сужение берется из созданного
+> `__RoutingRegistry`, а не из самого файла конфигурации.
+
 ## Поведение прокси
 
 ### Next.js
@@ -170,6 +202,8 @@ GET intlayer.zh/about
 
 Плагин Vite `intlayerProxy` применяет ту же логику во время разработки:
 
+> Начиная с Intlayer v9, `intlayerProxy()` встроен непосредственно в плагин `intlayer()` и включен по умолчанию через опцию `routing.enableProxy` (`true` по умолчанию). Регистрация его отдельно, как показано ниже, теперь опциональна — она сохранена для обратной совместимости и для конфигураций, которым нужно контролировать порядок плагинов. Установите `routing.enableProxy: false`, чтобы отказаться. См. [примечания к выпуску v9](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/releases/v9.md).
+
 ```typescript fileName="vite.config.ts"
 import { defineConfig } from "vite";
 import { intlayer } from "vite-intlayer";

package/docs/ru/custom_url_rewrites.md

@@ -246,7 +246,7 @@ Intlayer внутренне нормализует эти паттерны в е
 
 <Tabs group='framework'>
   <Tab label="Next.js" value="nextjs">
-  
+
     ```tsx
     'use client';
 
@@ -261,7 +261,7 @@ Intlayer внутренне нормализует эти паттерны в е
   </Tab>
 
   <Tab label="React Router" value="reactrouter">
-  
+
     ```tsx
     'use client';
 
@@ -277,7 +277,7 @@ Intlayer внутренне нормализует эти паттерны в е
   </Tab>
 
   <Tab label="Vue" value="vue">
-  
+
     ```vue
     <script setup>
     import { useRewriteURL } from "vue-intlayer";
@@ -289,7 +289,7 @@ Intlayer внутренне нормализует эти паттерны в е
 
   </Tab>
   <Tab label="Solid" value="solid">
-  
+
     ```tsx
     import { useRewriteURL } from "solid-intlayer";
 
@@ -301,7 +301,7 @@ Intlayer внутренне нормализует эти паттерны в е
 
   </Tab>
   <Tab label="Svelte" value="svelte">
-  
+
     ```svelte
     <script>
     import { useRewriteURL } from "svelte-intlayer";
@@ -338,6 +338,8 @@ export function middleware(request: NextRequest) {
 
 Для SolidJS, Vue и Svelte плагин Vite `intlayerProxy` управляет правилами переписывания (rewrites) во время разработки.
 
+> Начиная с Intlayer v9, `intlayerProxy()` встроен непосредственно в плагин `intlayer()` и включен по умолчанию через опцию `routing.enableProxy` (`true` по умолчанию). Регистрация его отдельно, как показано ниже, теперь необязательна — она сохранена для обратной совместимости и для настроек, которым необходимо контролировать порядок плагинов. Установите `routing.enableProxy: false` для отказа. Смотрите [примечания к выпуску v9](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/releases/v9.md).
+
 ```typescript fileName="vite.config.ts"
 import { defineConfig } from "vite";
 import { intlayer } from "vite-intlayer";