@intlayer/docs 8.12.5-canary.0 → 9.0.0-canary.11

package/docs/pt/self_hosting.md

@@ -0,0 +1,349 @@
+---
+createdAt: 2026-06-30
+updatedAt: 2026-06-30
+title: Auto-hospedagem do Intlayer
+description: Execute uma instância completa do Intlayer na sua própria infraestrutura com um único comando. Nenhuma conta Intlayer Cloud é necessária.
+keywords:
+  - Auto-hospedagem
+  - Docker
+  - Docker Compose
+  - Intlayer
+  - CMS
+  - Instalação
+  - Infraestrutura
+slugs:
+  - doc
+  - self-hosting
+author: aymericzip
+---
+
+# Auto-hospedagem do Intlayer
+
+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:
+
+```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`.
+
+## Sumário
+
+<TOC/>
+
+---
+
+## Arquitetura
+
+```
+                ┌─────────────────────────────┐
+ browser ──────▶ │  app  (TanStack Start)  :3000│ ──┐
+                └─────────────────────────────┘   │ VITE_BACKEND_URL
+                ┌─────────────────────────────┐   │
+                │  backend (Fastify/Bun)  :3100│ ◀─┘
+                └──────────────┬──────────────┘
+          ┌──────────┬─────────┼──────────┬───────────┐
+          ▼          ▼         ▼          ▼           ▼
+     mongo:27017  redis:6379  minio:9000  mailpit:1025  Chromium
+     (1-node RS)             (S3 API)     (SMTP)        (in-image)
+                             minio:9001   mailpit:8025
+                             (console)    (web UI)
+```
+
+O Chromium (usado para a geração de screenshots do Puppeteer) é empacotado dentro da imagem do backend — nenhum container separado é necessário.
+
+---
+
+## Pré-requisitos
+
+- **Docker** ≥ 24 e **Docker Compose** ≥ v2. Se algum deles estiver faltando, o instalador exibe o link de instalação e sai.
+- Portas `3000`, `3100`, `8025`, `9000` e `9001` disponíveis no host.
+- Um host Linux ou macOS (ou WSL2 no Windows).
+
+---
+
+## Início rápido
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+O que o instalador faz:
+
+1. Verifica se `docker` e `docker compose` estão presentes.
+2. Baixa `docker-compose.yml` e `.env.example` para `./intlayer/`.
+3. Se nenhum `.env` existir, copia o exemplo e gera segredos aleatórios para `BETTER_AUTH_SECRET`, `S3_ACCESS_KEY_ID` e `S3_SECRET_ACCESS_KEY` via `openssl rand`.
+4. Executa `docker compose pull` + `docker compose up -d`.
+5. Imprime as URLs: dashboard `:3000`, API `:3100`, UI de e-mail `:8025`, console MinIO `:9001`.
+
+Após a stack estar ativa, abra **http://localhost:3000** e crie sua primeira conta.
+
+---
+
+## Serviços
+
+| Serviço     | Imagem                               | Porta(s) do Host               | Finalidade                                                             |
+| ----------- | ------------------------------------ | ------------------------------ | ---------------------------------------------------------------------- |
+| **app**     | built from `apps/app/Dockerfile`     | `3000`                         | Dashboard TanStack Start (UI do CMS)                                   |
+| **backend** | built from `apps/backend/Dockerfile` | `3100`                         | API REST Fastify (endpoint `/health`)                                  |
+| **mongo**   | `mongo:7`                            | internal                       | Conjunto de réplicas de nó único (`rs0`)                               |
+| **redis**   | `redis:7-alpine`                     | internal                       | Filas de trabalho (BullMQ) e cache (ioredis)                           |
+| **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`.
+
+---
+
+## Variáveis de ambiente
+
+O instalador gera um arquivo `.env` pronto para uso. A tabela abaixo descreve cada variável.
+
+### Obrigatórias (auto-geradas ou solicitadas)
+
+| Variável               | Exemplo                                         | Descrição                                                        |
+| ---------------------- | ----------------------------------------------- | ---------------------------------------------------------------- |
+| `NODE_ENV`             | `production`                                    | Ambiente de tempo de execução                                    |
+| `PORT`                 | `3100`                                          | Porta de escuta do backend                                       |
+| `BACKEND_URL`          | `http://localhost:3100`                         | URL pública da API do backend                                    |
+| `APP_URL`              | `http://localhost:3000`                         | URL pública do dashboard                                         |
+| `DOMAIN`               | `localhost`                                     | Domínio do cookie                                                |
+| `MONGODB_URI`          | `mongodb://mongo:27017/intlayer?replicaSet=rs0` | URI de conexão completa do MongoDB                               |
+| `REDIS_URL`            | `redis://redis:6379`                            | URL de conexão do Redis                                          |
+| `BETTER_AUTH_SECRET`   | _(generated)_                                   | Segredo de 32 bytes para assinatura de sessão                    |
+| `MAIL_PROVIDER`        | `smtp`                                          | Transporte de e-mail: `smtp` ou `resend`                         |
+| `MAIL_SMTP_HOST`       | `mailpit`                                       | Nome de host SMTP (nome do container Mailpit)                    |
+| `MAIL_SMTP_PORT`       | `1025`                                          | Porta SMTP                                                       |
+| `MAIL_FROM`            | `Intlayer <no-reply@localhost>`                 | Endereço do remetente                                            |
+| `S3_ENDPOINT`          | `http://minio:9000`                             | Endpoint compatível com S3                                       |
+| `S3_PUBLIC_URL`        | `http://localhost:9000/intlayer`                | URL pública para carregamento de ativos no navegador             |
+| `S3_BUCKET_NAME`       | `intlayer`                                      | Nome do bucket                                                   |
+| `S3_ACCESS_KEY_ID`     | _(generated)_                                   | Chave de acesso do MinIO                                         |
+| `S3_SECRET_ACCESS_KEY` | _(generated)_                                   | Chave secreta do MinIO                                           |
+| `VITE_BACKEND_URL`     | `http://localhost:3100`                         | URL do backend incorporada ao dashboard no momento da compilação |
+| `VITE_DOMAIN`          | `localhost`                                     | Domínio incorporado ao dashboard no momento da compilação        |
+
+### Opcionais (recursos são degradados graciosamente quando ausentes)
+
+| Variável                                                 | Recurso                                                              |
+| -------------------------------------------------------- | -------------------------------------------------------------------- |
+| `OPENAI_API_KEY`                                         | Tradução assistida por IA e auditoria de conteúdo                    |
+| `STRIPE_SECRET_KEY`, `STRIPE_WEBHOOK_SECRET`, `STRIPE_*` | Gerenciamento de faturamento e assinaturas                           |
+| `RESEND_API_KEY`                                         | E-mail transacional via Resend (sobrescreve Mailpit quando definido) |
+| `GITHUB_CLIENT_ID`, `GITHUB_CLIENT_SECRET`               | Login OAuth do GitHub                                                |
+| `GOOGLE_CLIENT_ID`, `GOOGLE_CLIENT_SECRET`               | Login OAuth do Google                                                |
+| `GITLAB_CLIENT_ID`, `GITLAB_CLIENT_SECRET`               | Login OAuth do GitLab                                                |
+| `MICROSOFT_CLIENT_ID`, `MICROSOFT_CLIENT_SECRET`         | Login OAuth da Microsoft                                             |
+| `LINKEDIN_CLIENT_ID`, `LINKEDIN_CLIENT_SECRET`           | Login OAuth do LinkedIn                                              |
+| `ATLASSIAN_CLIENT_ID`, `ATLASSIAN_CLIENT_SECRET`         | Login OAuth da Atlassian                                             |
+
+---
+
+## Conectando seu projeto Intlayer
+
+Uma vez que a stack esteja em execução, aponte seu projeto para o backend e dashboard auto-hospedados em vez de `intlayer.org`.
+
+### Configuração do projeto
+
+```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,
+
+    /**
+     * URL do dashboard CMS auto-hospedado.
+     * Padrão: https://app.intlayer.org
+     */
+    cmsURL: process.env.INTLAYER_CMS_URL, // e.g. http://localhost:3000
+
+    /**
+     * URL da API do backend auto-hospedado.
+     * Padrão: https://back.intlayer.org
+     */
+    backendURL: process.env.INTLAYER_BACKEND_URL, // e.g. http://localhost:3100
+  },
+};
+
+export default config;
+```
+
+Defina as variáveis de ambiente no arquivo `.env` do seu projeto:
+
+```sh
+INTLAYER_CMS_URL=http://localhost:3000
+INTLAYER_BACKEND_URL=http://localhost:3100
+INTLAYER_CLIENT_ID=<your-client-id>
+INTLAYER_CLIENT_SECRET=<your-client-secret>
+```
+
+Crie credenciais de acesso no seu dashboard auto-hospedado em **Projetos → Chaves de acesso** em `http://localhost:3000/projects`.
+
+### SDK `@intlayer/api`
+
+Ao usar o SDK `@intlayer/api` programaticamente, passe `backendURL` explicitamente:
+
+```typescript fileName="cms.ts" codeFormat="typescript"
+import { createIntlayerCMS } from "@intlayer/api";
+import { dictionaryEndpoint } from "@intlayer/api/dictionary";
+
+const cms = createIntlayerCMS({
+  editor: {
+    clientId: process.env.INTLAYER_CLIENT_ID,
+    clientSecret: process.env.INTLAYER_CLIENT_SECRET,
+    backendURL: process.env.INTLAYER_BACKEND_URL, // http://localhost:3100
+  },
+});
+
+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
+```
+
+---
+
+## Backup e restauração
+
+Todos os dados persistentes residem em três volumes Docker nomeados.
+
+### Backup
+
+```sh
+docker run --rm \
+  -v intlayer_mongo-data:/data \
+  -v "$(pwd)":/backup \
+  busybox tar czf /backup/mongo-data.tar.gz /data
+
+docker run --rm \
+  -v intlayer_redis-data:/data \
+  -v "$(pwd)":/backup \
+  busybox tar czf /backup/redis-data.tar.gz /data
+
+docker run --rm \
+  -v intlayer_minio-data:/data \
+  -v "$(pwd)":/backup \
+  busybox tar czf /backup/minio-data.tar.gz /data
+```
+
+### Restauração
+
+```sh
+docker run --rm \
+  -v intlayer_mongo-data:/data \
+  -v "$(pwd)":/backup \
+  busybox tar xzf /backup/mongo-data.tar.gz -C /
+
+# Repita para redis-data e minio-data
+```
+
+---
+
+## Usando um proxy reverso (Nginx / Caddy)
+
+Para implantações em produção, coloque um proxy reverso na frente dos containers do aplicativo e do backend, em vez de expô-los diretamente.
+
+### Exemplo de Nginx
+
+```nginx
+server {
+    listen 80;
+    server_name cms.example.com;
+
+    location / {
+        proxy_pass http://localhost:3000;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+    }
+}
+
+server {
+    listen 80;
+    server_name api.example.com;
+
+    location / {
+        proxy_pass http://localhost:3100;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+    }
+}
+```
+
+Atualize as seguintes variáveis `.env` para corresponder aos seus domínios públicos:
+
+```sh
+BACKEND_URL=https://api.example.com
+APP_URL=https://cms.example.com
+DOMAIN=example.com
+VITE_BACKEND_URL=https://api.example.com
+VITE_DOMAIN=example.com
+```
+
+> As variáveis `VITE_*` são incorporadas à imagem do dashboard no momento da compilação. Se você as alterar após a imagem ser construída, precisará reconstruir a imagem do `app` (`docker compose build app`) ou usar a injeção de configuração em tempo de execução.
+
+---
+
+## Solução de problemas
+
+### Backend em loop de falha na primeira inicialização
+
+MongoDB e Redis devem estar saudáveis antes que o backend possa iniciar. O arquivo compose usa `depends_on` com `condition: service_healthy`. Se você notar reinícios repetidos do backend, verifique se os healthchecks do `mongo` e `redis` estão passando:
+
+```sh
+docker compose ps
+docker compose logs mongo
+docker compose logs redis
+```
+
+### 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
+```
+
+### E-mail não está sendo enviado
+
+Por padrão, todos os e-mails de saída são capturados pelo Mailpit. Abra `http://localhost:8025` para ver as mensagens enviadas. Para enviar e-mails reais, defina `MAIL_PROVIDER=resend` e `RESEND_API_KEY=<sua-chave>` no `.env`, então reinicie o backend:
+
+```sh
+docker compose restart backend
+```
+
+### 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:
+
+```sh
+docker compose run --rm minio-init
+```
+
+---
+
+## Links úteis
+
+- [Documentação do Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_CMS.md)
+- [Referência de configuração](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/configuration.md)
+- [SDK do CMS — `@intlayer/api`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_CMS.md#programmatic-access-with-the-intlayerapi-sdk)

package/docs/ru/CI_CD.md

@@ -26,6 +26,10 @@ author: aymericzip
 
 Intlayer позволяет автоматически генерировать переводы для ваших файлов декларации контента. Существует несколько способов достичь этого в зависимости от вашего рабочего процесса.
 
+## Содержание
+
+<TOC/>
+
 ## Использование CMS
 
 С Intlayer вы можете использовать рабочий процесс, при котором локально объявляется только одна локаль, а все переводы управляются удаленно через CMS. Это позволяет полностью отделить контент и переводы от кодовой базы, обеспечивая большую гибкость для редакторов контента и позволяя горячую перезагрузку контента (нет необходимости пересобирать приложение для применения изменений).

package/docs/ru/autoFill.md

@@ -28,6 +28,53 @@ history:
 author: aymericzip
 ---
 
+# Автоматическое заполнение файлов объявления контента переводов
+
+**Автоматическое заполнение файлов объявления контента** в вашей CI — это способ ускорить рабочий процесс разработки.
+
+## Понимание поведения
+
+Команда `fill` включает два режима:
+
+- **Complete**: Автоматически заполняет все недостающее содержимое для каждой локали и редактирует текущий файл или другой файл, если он указан. То есть режим complete пропустит перевод существующего содержимого, если оно уже переведено.
+- **Review**: Автоматически заполняет **все** содержимое для каждой локали и генерирует для конкретного файла или другого файла, если он указан.
+
+Команда fill будет обрабатывать все ваши файлы объявления содержимого локали. То есть она не будет обрабатывать ваше удаленное содержимое из CMS. CMS включает собственное управление переводами.
+Если вы используете плагины, такие как `@intlayer/sync-json-plugin`, Intlayer преобразует файлы JSON в файлы объявления содержимого локали. То есть они будут обработаны командой `fill`.
+
+Новые сгенерированные файлы включают инструкцию `filled` в качестве метаданных словаря. Эта инструкция будет использоваться Intlayer для определения того, был ли файл автоматически заполнен или нет, и пропустит этот файл от повторного перевода, если она присутствует.
+
+Intlayer также будет учитывать следующую инструкцию для автоматического заполнения:
+
+- Из вашего `.content.{ts|js|json}` → инструкция `fill`
+- Из вашего файла конфигурации `.intlayer.config.ts` → инструкция `dictionary.fill`
+- По умолчанию будет установлено значение `true`
+
+Для файлов объявления содержимого для каждой локали инструкция `true` будет заменена на `./{{fileName}}.fill.content.json`. Это потому, что файл объявления содержимого для каждой локали не может получать дополнительное локализованное содержимое. Поэтому он будет генерировать новый файл, чтобы не перезаписать существующий файл.
+
+## Поведение по умолчанию
+
+По умолчанию `fill` установлено в `true` глобально, что означает, что Intlayer будет автоматически заполнять все файлы контента и редактировать сам файл. Это поведение можно настроить несколькими способами:
+
+### Глобальные параметры конфигурации
+
+1. **`fill: true` (по умолчанию)** - Автоматически заполнить все локали и отредактировать текущий файл
+2. **`fill: false`** - Отключить автоматическое заполнение для этого файла контента
+3. **`fill: "./relative/path/to/file"`** - Создать/обновить указанный файл без редактирования текущего, указав относительный путь, разрешенный на основе расположения текущего файла
+4. **`fill: "/absolute/path/to/file"`** - Создать/обновить указанный файл без редактирования текущего, указав относительный путь, разрешенный на основе расположения базовой директории (поле `baseDir` в файле конфигурации `.intlayer.config.ts`)
+5. **`fill: "C:\\absolute\path\to\file"`** - Создать/обновить указанный файл без редактирования текущего, указав абсолютный путь, разрешенный на основе вашей операционной системы
+6. **`fill: { [key in Locales]?: string }`** - Создать/обновить указанный файл для каждой локали
+
+### Изменения поведения в v7
+
+В v7 поведение команды `fill` было обновлено:
+
+- **`fill: true`** - Перезаписывает текущий файл с заполненным содержимым для всех локалей
+- **`fill: "path/to/file"`** - Заполняет указанный файл без изменения текущего файла
+- **`fill: false`** - Полностью отключает автоматическое заполнение
+
+При использовании опции пути для записи в другой файл механизм заполнения работает через отношение _master-slave_ между файлами объявления содержимого. Основной файл (master) служит источником истины, и при его обновлении Intlayer автоматически применит эти изменения к производным (заполненным) файлам объявления, указанным в пути.
+
 # Переводы файлов декларации автозаполнения контента
 
 **Файлы декларации автозаполнения контента**, это способ ускорить ваш процесс разработки.
@@ -88,6 +135,40 @@ Intlayer автоматически сгенерирует производны
 
 После этого оба файла деклараций будут объединены в один словарь, доступный через стандартный хук `useIntlayer("example")` (react) / композицию (vue).
 
+## Глобальная конфигурация
+
+Вы можете настроить глобальную конфигурацию автозаполнения в файле `intlayer.config.ts`.
+
+```ts fileName="intlayer.config.ts"
+import { type IntlayerConfig, Locales } from "intlayer";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+    requiredLocales: [Locales.ENGLISH, Locales.FRENCH],
+  },
+  dictionary: {
+    // Автогенерация отсутствующих переводов для всех словарей
+    fill: "./{{fileName}}Filled.content.ts",
+    //
+    // fill: "/messages/{{locale}}/{{key}}/{{fileName}}.content.json",
+    //
+    // fill: true, // автогенерация отсутствующих переводов для всех словарей, как при использовании "./{{fileName}}.content.json"
+    //
+    // fill: {
+    //   en: "./{{fileName}}.en.content.json",
+    //   fr: "./{{fileName}}.fr.content.json",
+    //   es: "./{{fileName}}.es.content.json",
+    // },
+  },
+};
+
+export default config;
+```
+
+Вы по-прежнему можете настраивать каждый словарь отдельно, используя поле `fill` в файлах содержимого. Intlayer сначала рассмотрит конфигурацию каждого словаря, а затем вернётся к глобальной конфигурации.
+
 ## Формат автозаполненного файла
 
 Рекомендуемый формат для автоматически заполняемых файлов деклараций, **JSON**, который помогает избежать ограничений форматирования. Однако Intlayer также поддерживает форматы `.ts`, `.js`, `.mjs`, `.cjs` и другие.

package/docs/ru/benchmark/solid.md

@@ -117,6 +117,28 @@ history:
 - **Локальная статическая (Scoped static)**: Позволяет организовать код (логическое разделение) без сложных дополнительных сетевых запросов.
 - **Локальная динамическая (Scoped dynamic)**: Лучший подход для _разделения кода_ и производительности. Минимизирует использование памяти, загружая только то, что нужно для текущего представления и активной локали.
 
+### Что я измерял:
+
+Я запустил одно и то же многоязычное приложение в реальном браузере для каждого стека, а затем записал, что фактически появилось в сети и сколько времени это заняло. Размеры указаны **после обычного сжатия веб-контента**, поскольку это ближе к тому, что люди загружают, чем к подсчету необработанного исходного кода.
+
+- **Размер библиотеки интернационализации**: После объединения, удаления неиспользуемого кода и минификации размер библиотеки i18n — это размер поставщиков + код hooks/primitives в пустом компоненте. Это не включает загрузку файлов переводов. Это показывает, насколько дорогостоящей является библиотека до того, как ваш контент вступит в игру.
+
+- **JavaScript на странице**: Для каждого маршрута бенчмарка — сколько скрипта браузер загружает при посещении, усредненное по страницам в наборе (и по языкам, где отчет их объединяет). Тяжелые страницы — медленные страницы.
+
+- **Утечка из других языков**: Это контент той же страницы, но на другом языке, который может быть случайно загружен на проверяемую страницу. Этот контент является ненужным и должен быть избегнут. (например, содержимое страницы `/fr/about` в пакете страницы `/en/about`)
+
+- **Утечка из других маршрутов**: То же самое для **других экранов** приложения: загружается ли их контент вместе с ними при открытии только одной страницы. (например, содержимое страницы `/en/about` в пакете страницы `/en/contact`). Высокий результат указывает на слабое разделение или слишком широкие пакеты.
+
+- **Средний размер пакета компонента**: Общие элементы пользовательского интерфейса измеряются **по одному** вместо того, чтобы скрываться внутри одного огромного числа приложения. Это показывает, незаметно ли интернационализация увеличивает повседневные компоненты. Например, если ваш компонент перерисовывается, он загружает все эти данные из памяти. Присоединение большого JSON к любому компоненту похоже на подключение большого хранилища неиспользуемых данных, которое замедлит производительность ваших компонентов.
+
+- **Отзывчивость переключения языка**: Я переключаю язык с помощью элемента управления приложением и отсчитываю время до четкого переключения страницы, что заметит посетитель, а не микрошаг в лаборатории.
+
+- **Работа отрисовки после смены языка**: Более узкое продолжение: сколько усилий потребовалось интерфейсу на перерисовку для нового языка после инициирования переключения. Полезно, когда "субъективное" время и затраты фреймворка расходятся.
+
+- **Время начальной загрузки страницы**: От навигации до того, как браузер считает страницу полностью загруженной для проверенных сценариев. Хорошо подходит для сравнения холодных запусков.
+
+- **Время гидратации**: Когда приложение это раскрывает, сколько времени клиент тратит на преобразование HTML сервера в то, на что вы фактически можете щелкнуть. Прочерк в таблицах означает, что эта реализация не предоставила надежное значение гидратации в этом бенчмарке.
+
 ## Звезды на GitHub
 
 Звезды на GitHub - это сильный индикатор популярности проекта, доверия сообщества и долгосрочной актуальности. Хотя они не являются прямым показателем технического качества, они отражают, сколько разработчиков считают проект полезным, следят за его прогрессом и, вероятно, будут его использовать. Для оценки ценности проекта звезды помогают сравнивать популярность альтернатив и дают представление о росте экосистемы.

package/docs/ru/benchmark/svelte.md

@@ -116,6 +116,28 @@ style="border:none;"
 - **Локальная статическая (Scoped static)**: Позволяет организовать код (логическое разделение) без сложных дополнительных сетевых запросов.
 - **Локальная динамическая (Scoped dynamic)**: Лучший подход для _разделения кода_ и производительности. Минимизирует использование памяти, загружая только то, что нужно для текущего представления и активной локали.
 
+### Что я измерял:
+
+Я запустил одно и то же многоязычное приложение в реальном браузере для каждого стека, а затем записал, что действительно появилось на сети и сколько времени это заняло. Размеры указаны **после обычного веб-сжатия**, поскольку это ближе к тому, что люди загружают, чем к подсчёту исходного кода.
+
+- **Размер библиотеки интернационализации**: После объединения, встряхивания дерева и минификации размер библиотеки i18n — это размер кода провайдеров и хранилищ в пустом компоненте. Это не включает загрузку файлов переводов. Это показывает, насколько дорога библиотека до того, как ваше содержимое попадёт в картину.
+
+- **JavaScript на странице**: Для каждого маршрута тестирования, сколько скриптов браузер подгружает при этом посещении, усреднённое по страницам в наборе (и по локалям, где отчёт их объединяет). Тяжёлые страницы — это медленные страницы.
+
+- **Утечка из других локалей**: Это содержимое той же страницы, но на другом языке, которое может быть загружено по ошибке в проверяемую страницу. Это содержимое не нужно и его следует избегать. (например, содержимое страницы `/fr/about` в пакете страницы `/en/about`)
+
+- **Утечка из других маршрутов**: Та же идея для **других экранов** в приложении: загружается ли их копия, когда вы открыли только одну страницу. (например, содержимое страницы `/en/about` в пакете страницы `/en/contact`). Высокий результат указывает на слабое разделение или чрезмерно широкие пакеты.
+
+- **Средний размер пакета компонента**: Общие элементы пользовательского интерфейса измеряются **по одному** вместо того, чтобы скрываться внутри одного гигантского числа приложения. Это показывает, скрытно ли интернационализация увеличивает повседневные компоненты. Например, если ваш компонент перерисовывается, он загружает все эти данные из памяти. Присоединение большого JSON к любому компоненту похоже на подключение большого хранилища неиспользуемых данных, которое замедлит производительность ваших компонентов.
+
+- **Отзывчивость переключения языка**: Я переключаю язык с помощью собственного элемента управления приложения и измеряю, сколько времени проходит, пока страница явно не переключится, что заметил бы посетитель, а не лабораторный микрошаг.
+
+- **Работа рендеринга после изменения языка**: Более узкое продолжение: сколько усилий потребовалось интерфейсу, чтобы перерисовать новый язык, когда переключение уже в пути. Полезно, когда «субъективное» время и стоимость фреймворка расходятся.
+
+- **Время начальной загрузки страницы**: От навигации до того, как браузер считает страницу полностью загруженной для протестированных сценариев. Хорошо для сравнения холодных запусков.
+
+- **Время гидратации**: Когда приложение это раскрывает, сколько времени клиент тратит на превращение HTML-кода сервера во что-то, на что можно действительно щёлкнуть. Тире в таблицах означает, что эта реализация не предоставила надёжную цифру гидратации в этом тесте.
+
 ## Звезды на GitHub
 
 Звезды на GitHub - это сильный индикатор популярности проекта, доверия сообщества и долгосрочной актуальности. Хотя они не являются прямым показателем технического качества, они отражают, сколько разработчиков считают проект полезным, следят за его прогрессом и, вероятно, будут его использовать. Для оценки ценности проекта звезды помогают сравнивать популярность альтернатив и дают представление о росте экосистемы.

package/docs/ru/benchmark/tanstack.md

@@ -124,6 +124,28 @@ history:
 - **Локальная статическая (Scoped static)**: Позволяет организовать код (логическое разделение) без сложных дополнительных сетевых запросов.
 - **Локальная динамическая (Scoped dynamic)**: Лучший подход для _разделения кода_ и производительности. Минимизирует использование памяти, загружая только то, что нужно для текущего представления и активной локали.
 
+### Что я измерял:
+
+Я запустил одно и то же многоязычное приложение в реальном браузере для каждого стека, а затем записал, что фактически показалось в сети и сколько времени это заняло. Размеры указаны **после стандартного веб-сжатия**, потому что это ближе к тому, что люди скачивают, чем к подсчёту исходного кода.
+
+- **Размер библиотеки интернационализации**: После bundling, tree-shaking и minification размер библиотеки i18n — это размер поставщиков (например `NextIntlClientProvider`) + код hooks (например `useTranslations`) в пустом компоненте. Это не включает загрузку файлов переводов. Это показывает, насколько дорогой является библиотека, прежде чем в игру вступит ваш контент.
+
+- **JavaScript на странице**: Для каждого маршрута тестирования, сколько скрипта браузер загружает при каждом посещении, усреднённые по страницам в наборе (и по локалям, где отчёт их объединяет). Тяжёлые страницы — медленные страницы.
+
+- **Утечка из других локалей**: Это контент той же страницы, но на другом языке, который по ошибке загружается на проверяемую страницу. Этот контент не нужен и его следует избегать. (например, контент страницы `/fr/about` в пакете страницы `/en/about`)
+
+- **Утечка из других маршрутов**: То же самое для **других экранов** приложения: загружается ли их копия вместе с тем, когда вы открыли только одну страницу. (например, контент страницы `/en/about` в пакете страницы `/en/contact`). Высокий результат указывает на слабое разбиение или слишком широкие пакеты.
+
+- **Средний размер пакета компонента**: Обычные элементы пользовательского интерфейса измеряются **по одному** вместо того, чтобы скрываться внутри одного гигантского числа приложения. Это показывает, скрывает ли интернационализация незаметно раздуванием обычные компоненты. Например, если ваш компонент переуходит, он загружает все эти данные из памяти. Привязка большого JSON к любому компоненту — это как подключение большого хранилища неиспользуемых данных, которое замедлит производительность ваших компонентов.
+
+- **Скорость переключения языка**: Я переключаю язык с помощью собственного элемента управления приложения и замеряю, сколько времени проходит до того, как страница явно переключится, что заметит посетитель, а не лабораторный микро-шаг.
+
+- **Работа по рендерингу после смены языка**: Более узкое продолжение: сколько усилий затратил интерфейс на перерисовку нового языка после того, как переключение началось. Полезно, когда "ощущаемое" время и стоимость framework расходятся.
+
+- **Время первоначальной загрузки страницы**: От навигации до того момента, когда браузер считает страницу полностью загруженной для тестируемых сценариев. Хорошо подходит для сравнения холодных запусков.
+
+- **Время гидратации**: Когда приложение это предоставляет, как долго клиент потратит на превращение серверного HTML во что-то, на что вы действительно можете нажать. Прочерк в таблицах означает, что эта реализация не предоставила надежный показатель гидратации в этом тесте.
+
 ## Звезды на GitHub
 
 Звезды на GitHub - это сильный индикатор популярности проекта, доверия сообщества и долгосрочной актуальности. Хотя они не являются прямым показателем технического качества, они отражают, сколько разработчиков считают проект полезным, следят за его прогрессом и, вероятно, будут его использовать. Для оценки ценности проекта звезды помогают сравнивать популярность альтернатив и дают представление о росте экосистемы.

package/docs/ru/cli/ci.md

@@ -140,6 +140,28 @@ steps:
     run: npx intlayer ci fill
 ```
 
+## Строительные блоки GitHub Actions
+
+При запуске `intlayer init`, Intlayer определяет ваш package manager (npm, yarn, pnpm или bun) и создает два workflow'а GitHub Actions в папке `.github/workflows/`, с командами, соответствующими вашему package manager'у:
+
+- **`intlayer-fill.yml`** — При каждом pull request'е собирает словари и запускает `intlayer fill --git-diff --mode complete` для генерации недостающих переводов в измененных словарях, а затем коммитит результат обратно в ветку PR.
+- **`intlayer-test.yml`** — При каждом pull request'е собирает словари и запускает `intlayer test`, не пропуская проверку, когда требуемым локалям не хватает переводов.
+
+Существующие файлы workflow никогда не перезаписываются. Чтобы полностью пропустить создание строительных блоков, запустите:
+
+```bash
+npx intlayer init --no-github-actions
+```
+
+### Предоставление доступа к ИИ для рабочего процесса fill
+
+Созданный файл `intlayer-fill.yml` требует доступа к ИИ. Доступны два варианта (настраиваются в блоке `env` рабочего процесса):
+
+1. **Ваш собственный ключ поставщика ИИ** — добавьте секрет `AI_API_KEY` в настройки репозитория (Settings → Secrets and variables → Actions). Рабочий процесс передает его через `--provider`, `--model` и `--api-key`.
+2. **Ключи доступа Intlayer CMS** — добавьте секреты `INTLAYER_CLIENT_ID` и `INTLAYER_CLIENT_SECRET` и свяжите их с разделом `editor` в вашем `intlayer.config`. Ключи доступа CMS предоставляют доступ к ИИ через backend Intlayer.
+
+Рабочий процесс `intlayer-test.yml` не требует доступа к ИИ.
+
 ## Обработка ошибок
 
 - Если `INTLAYER_PROJECT_CREDENTIALS` не установлена, команда завершится с ошибкой.