@intlayer/docs 9.3.3 → 9.4.0

package/docs/pt/packages/react-intlayer/useI18n.md

@@ -77,6 +77,34 @@ Todas as chaves do dicionário devem ser declaradas dentro dos arquivos de decla
 
 Exemplos de uso do hook `useI18n` dentro de componentes React:
 
+<Tabs>
+ <Tab label='Intlayer >=9.4' value='>=9.4'>
+
+```tsx fileName="src/App.tsx" codeFormat={["typescript", "esm"]}
+import type { FC } from "react";
+import { ClientComponentExample, ServerComponentExample } from "@components";
+import { IntlayerProvider } from "react-intlayer";
+import { useI18n } from "react-intlayer/server";
+import { Locales } from "intlayer";
+
+const App: FC<{ locale: Locales }> = ({ locale }) => {
+  const t = useI18n("home-page", locale);
+
+  return (
+    <>
+      <p>{t("introduction")}</p>
+      <IntlayerProvider locale={locale}>
+        <ClientComponentExample />
+      </IntlayerProvider>
+      <ServerComponentExample />
+    </>
+  );
+};
+```
+
+ </Tab>
+ <Tab label='Intlayer <9.4' value='<9.4'>
+
 ```tsx fileName="src/App.tsx" codeFormat={["typescript", "esm"]}
 import type { FC } from "react";
 import { ClientComponentExample, ServerComponentExample } from "@components";
@@ -101,6 +129,9 @@ const App: FC<{ locale: Locales }> = ({ locale }) => {
 };
 ```
 
+</Tab>
+</Tabs>
+
 ```tsx fileName="src/components/ComponentExample.tsx" codeFormat={["typescript", "esm"]}
 import type { FC } from "react";
 import { useI18n } from "react-intlayer";

package/docs/pt/packages/react-intlayer/useIntlayer.md

@@ -31,48 +31,6 @@ Esta seção fornece orientações detalhadas sobre o uso do hook `useIntlayer`
 
 ## Exemplo de Uso em React
 
-Demonstrando o hook `useIntlayer` dentro de um componente React:
-
-```tsx fileName="src/app.tsx" codeFormat={["typescript", "esm"]}
-import type { FC } from "react";
-import { ClientComponentExample, ServerComponentExample } from "@components";
-import { IntlayerProvider } from "react-intlayer";
-import { useIntlayer, IntlayerServerProvider } from "react-intlayer/server";
-import { Locales } from "intlayer";
-
-const App: FC<{ locale: Locales }> = ({ locale }) => {
-  const content = useIntlayer("homepage", locale);
-
-  return (
-    <>
-      <p>{content.introduction}</p>
-      <IntlayerProvider locale={locale}>
-        <ClientComponentExample />
-      </IntlayerProvider>
-      <IntlayerServerProvider locale={locale}>
-        <ServerComponentExample />
-      </IntlayerServerProvider>
-    </>
-  );
-};
-```
-
-```tsx fileName="src/components/ComponentExample.tsx" codeFormat={["typescript", "esm"]}
-import type { FC } from "react";
-import { useIntlayer } from "react-intlayer";
-
-const ComponentExample: FC = () => {
-  const content = useIntlayer("component-example");
-
-  return (
-    <div>
-      <h1>{content.title}</h1>
-      <p>{content.description}</p>
-    </div>
-  );
-};
-```
-
 ```tsx fileName="src/components/ServerComponentExample.tsx" codeFormat={["typescript", "esm"]}
 import { useIntlayer } from "react-intlayer/server";
 

package/docs/pt/packages/vite-intlayer/intlayerMinify.md

@@ -56,7 +56,7 @@ O `intlayerMinify` fica ativo **apenas** quando todas as três condições a seg
 2. `build.optimize` é `true` (ou `undefined`, que assume o padrão `true` para builds).
 3. `build.minify` é `true` na sua configuração do Intlayer.
 
-Ele é desativado automaticamente quando `editor.enabled` é `true` porque o editor precisa do conteúdo do dicionário completo e legível por humanos.
+Quando `editor.enabled` é `true`, o plugin continua sendo executado, mas **pula a renomeação de campos**: a renomeação reescreve as chaves de conteúdo percorridas pelo interpretador, então o `keyPath` recebido pelo editor visual não corresponderia mais aos dicionários não mesclados que ele edita. A compactação de espaços em branco e a remoção dos metadados de nível superior permanecem ativas.
 
 ## O que é minificado
 

package/docs/pt/packages/vite-intlayer/intlayerPrune.md

@@ -28,6 +28,8 @@ author: aymericzip
 
 O plugin Vite `intlayerPrune` é usado para realizar tree-shaking e podar dicionários não utilizados do bundle da sua aplicação. Isso ajuda a reduzir o tamanho final do bundle incluindo apenas o conteúdo multilíngue necessário.
 
+> O plugin já está incluído e configurado automaticamente quando você usa [`intlayer()`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/packages/vite-intlayer/intlayer.md). Você só precisa registrá-lo manualmente se estiver compondo a pilha de plugins você mesmo.
+
 ## Utilização
 
 ### Como parte de `intlayer()` (recomendado)
@@ -115,4 +117,4 @@ Quando a limpeza tem sucesso, `intlayerPrune` também escreve `pruneContext.dict
 2. `build.optimize` é `true` (ou `undefined`, que assume como padrão `true` para builds).
 3. `build.purge` é `true` na sua configuração do Intlayer.
 
-É automaticamente **desativado** quando `editor.enabled` é `true` porque o editor precisa do conteúdo completo do dicionário.
+Ele permanece ativo quando `editor.enabled` é `true`: o editor visual resolve cada edição por meio de `dictionaryKey` + `keyPath` em relação aos dicionários não mesclados, que este plugin nunca toca, e um campo removido é um campo que nenhum componente lê — portanto, nunca é renderizado nem selecionável na página.

package/docs/pt/per_locale_file.md

@@ -77,6 +77,17 @@ const helloWorldContent = {
 module.exports = helloWorldContent;
 ```
 
+```json5 fileName="hello-world.pt.content.json" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "hello-world",
+  "locale": "pt", // Importante
+  "content": {
+    "multilingualContent": "Título do meu componente",
+  },
+}
+```
+
 ```json fileName="hello-world.content.ts" contentDeclarationFormat="json"
 {
   "$schema": "https://intlayer.org/schema.json",
@@ -95,6 +106,8 @@ module.exports = helloWorldContent;
 
 > Recomendado: Este formato é o melhor quando se utiliza o editor visual do Intlayer ou se gerenciam traduções diretamente no código.
 
+> Nota: Em ambos os casos, o arquivo de declaração de conteúdo deve seguir o padrão de nomenclatura `*.content.{ts,tsx,js,jsx,mjs,cjs,json}` para ser reconhecido pelo Intlayer. O sufixo `.[locale]` é opcional e usado apenas como uma convenção de nomenclatura.
+
 ### Configuração Global para Arquivos por Localidade
 
 Você pode configurar a configuração global para arquivos por localidade adicionando o seguinte ao seu arquivo `intlayer.config.ts`:
@@ -146,17 +159,6 @@ const helloWorldContent = {
 export default helloWorldContent;
 ```
 
-```json5 fileName="hello-world.en.content.json" contentDeclarationFormat="json"
-{
-  "$schema": "https://intlayer.org/schema.json",
-  "key": "hello-world",
-  "locale": "en", // Importante
-  "content": {
-    "multilingualContent": "Título do meu componente",
-  },
-}
-```
-
 ```json5 fileName="hello-world.es.content.json" contentDeclarationFormat="json"
 {
   "$schema": "https://intlayer.org/schema.json",
@@ -170,8 +172,6 @@ export default helloWorldContent;
 
 > Importante: Certifique-se de que o campo locale está definido. Ele informa ao Intlayer qual idioma o arquivo representa.
 
-> Nota: Em ambos os casos, o arquivo de declaração de conteúdo deve seguir o padrão de nomenclatura `*.content.{ts,tsx,js,jsx,mjs,cjs,json}` para ser reconhecido pelo Intlayer. O sufixo `.[locale]` é opcional e usado apenas como convenção de nomenclatura.
-
 ## Misturando Formatos
 
 Você pode combinar ambas as abordagens de declaração para a mesma chave de conteúdo. Por exemplo:

package/docs/pt/readme.md

@@ -225,8 +225,8 @@ Explore a nossa documentação completa para começar com o Intlayer e aprender
   <li><a href="https://intlayer.org/doc/environment/vite-and-vue" rel=''>Vite + Vue</a></li>
   <li><a href="https://intlayer.org/doc/environment/nuxt-and-vue" rel=''>Vite + Nuxt</a></li>
   <li><a href="https://intlayer.org/doc/environment/vite-and-solid" rel=''>Vite + Solid</a></li>
-  <li><a href="https://intlayer.org/doc/environment/angular" rel=''>Angular</a></li>
-  <li>
+  <li><a href="https://intlayer.org/doc/environment/solid-start" rel=''>Solid Start</a></li>
+  <li><a href="https://intlayer.org/doc/environment/angular" rel=''>Angular</a></li>  <li>
      <a href="https://intlayer.org/doc/environment/express" rel=''>Backend</a>
      <ul>
       <li><a href="https://intlayer.org/doc/environment/express" rel=''>Express</a></li>
@@ -234,6 +234,7 @@ Explore a nossa documentação completa para começar com o Intlayer e aprender
       <li><a href="https://intlayer.org/doc/environment/fastify" rel=''>Fastify</a></li>
       <li><a href="https://intlayer.org/doc/environment/adonisjs" rel=''>AdonisJS</a></li>
       <li><a href="https://intlayer.org/doc/environment/hono" rel=''>Hono</a></li>
+      <li><a href="https://intlayer.org/doc/environment/elysia" rel=''>Elysia</a></li>
     </ul>
   </li>
 </ul>

package/docs/pt/releases/v6.md

@@ -118,6 +118,8 @@ export default config;
 
 Você ainda pode ajustar por dicionário usando o campo `autoFill` nos arquivos de conteúdo. Veja a referência completa em `doc/autoFill` e `doc/dictionary/content_file`.
 
+Você ainda pode ajustar por dicionário usando o campo `autoFill` em arquivos de conteúdo. O Intlayer primeiro considerará a configuração por dicionário e depois voltará para a configuração global. Veja a referência completa em [Auto-fill](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/autoFill.md) e [Referência de arquivo de conteúdo](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/dictionary/content_file.md).
+
 ---
 
 ## Comando fill: padrões mais seguros
@@ -175,6 +177,20 @@ Veja detalhes na documentação da [Extensão Oficial do VS Code](https://github
 
 ---
 
+Atualizado o servidor MCP para suportar os novos recursos.
+
+- Auto-fill
+- Test missing translations
+- Live updates
+- Logging
+- Validation
+- Migration notes
+- Documentation
+
+> O servidor MCP ajuda na automatização de projetos usando Intlayer. Testando traduções ausentes para código autogenerado. Ajuda a entender sua configuração e incorpora a documentação do Intlayer no seu IDE.
+
+---
+
 ## Performance: 10× mais rápido
 
 - Resolução paralela de dicionários locais e remotos
@@ -296,8 +312,6 @@ Notas:
 
 Consulte [CMS e Sincronização ao Vivo](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_CMS.md) e [Configuração](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/configuration.md) para orientações completas.
 
----
-
 ## Processo paralelo para monitorar arquivos no turbopack
 
 Ao usar Turbopack no Next.js 14 e superior como seu servidor de desenvolvimento com o comando `next dev --turbopack`, as mudanças no dicionário não serão detectadas automaticamente por padrão.

package/docs/pt/releases/v9.md

@@ -374,6 +374,8 @@ curl -fsSL https://intlayer.org/install.sh | sh
 
 O instalador baixa um `docker-compose.yml` e um `.env`, gera automaticamente os secrets necessários e executa `docker compose up -d`. Tudo — o dashboard, a API, o banco de dados, o armazenamento de objetos e o e-mail transacional — roda localmente em contêineres.
 
+---
+
 ## Notas de migração da v8
 
 Se você estiver atualizando da v8, observe que a v9 não inclui breaking changes. Mas aqui estão as principais mudanças:

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/agent_skills.md

@@ -1,11 +1,11 @@
 ---
 createdAt: 2026-02-09
 updatedAt: 2026-03-03
-title: Навыки агента
-description: Узнайте, как использовать навыки агента Intlayer для улучшения понимания вашего проекта вашим AI-агентом, включая исчерпывающие руководства по настройке метаданных, карт сайта и серверных действий.
+title: Agent Skills
+description: Узнайте, как использовать Agent Skills Intlayer для улучшения понимания вашего проекта вашим AI-агентом, включая исчерпывающие руководства по настройке метаданных, карт сайта и серверных действий.
 keywords:
   - Intlayer
-  - Навыки агента
+  - Agent Skills
   - AI-агент
   - Интернационализация
   - Документация
@@ -19,13 +19,13 @@ history:
 author: aymericzip
 ---
 
-# Навыки агента
+# Agent Skills
 
 ## Настройка
 
 ### Использование CLI
 
-Команда `intlayer init skills` - самый простой способ настроить навыки агента в вашем проекте. Она обнаруживает вашу среду и устанавливает необходимые конфигурационные файлы для предпочитаемых платформ.
+Команда `intlayer init skills` - самый простой способ настроить Agent Skills в вашем проекте. Она обнаруживает вашу среду и устанавливает необходимые конфигурационные файлы для предпочитаемых платформ.
 
 ```bash packageManager="npm"
 npx intlayer init skills
@@ -54,10 +54,10 @@ npx skills add aymericzip/intlayer-skills
 1. Откройте палитру команд (Ctrl+Shift+P или Cmd+Shift+P).
 2. Введите `Intlayer: Setup AI Agent Skills`
 3. Выберите платформу, которую вы используете (например, `VS Code`, `Cursor`, `Windsurf`, `OpenCode`, `Claude Code`, `GitHub Copilot Workspace` и т. д.).
-4. Выберите навыки, которые вы хотите установить (например, `Next.js`, `React`, `Vite`, `Compiler`, `Configuration`).
+4. Выберите Agent Skills, которые вы хотите установить (например, `Next.js`, `React`, `Vite`, `Compiler`, `Configuration`).
 5. Нажмите Enter.
 
-## Список навыков
+## Список Agent Skills
 
 **intlayer-config**
 

package/docs/ru/analytics.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-07-08
-updatedAt: 2026-07-08
+updatedAt: 2026-08-22
 title: Intlayer Analytics | Отслеживание показов контента и проведение A/B-тестирования
 description: Узнайте, как @intlayer/analytics отслеживает просмотры страниц/локалей и показы контента, а также как использовать это для проведения A/B-тестирования вашего контента Intlayer.
 keywords:
@@ -18,6 +18,9 @@ slugs:
   - concept
   - analytics
 history:
+  - version: 9.3.3
+    date: 2026-08-22
+    changes: "Аналитика включена по умолчанию, если установлен `@intlayer/analytics`"
   - version: 9.0.0
     date: 2026-07-08
     changes: "Init doc — пакет @intlayer/analytics, отслеживание на уровне провайдера/узла, A/B-тестирование, дашборд"
@@ -57,7 +60,7 @@ Intlayer уже позволяет вам объявлять [Варианты](
 
 ## Установка
 
-`@intlayer/analytics` — это **одноранговая (peer), опциональная** зависимость. Фреймворки не устанавливают её автоматически. Добавьте её вместе с `intlayer`:
+`@intlayer/analytics` — **опциональная зависимость** каждого пакета фреймворка (`react-intlayer`, `next-intlayer`, `vue-intlayer`, …), поэтому в большинстве проектов он уже установлен. Установите его явно, если ваша конфигурация пропускает опциональные зависимости (`npm install --no-optional`, …):
 
 ```bash packageManager="npm"
 npm install @intlayer/analytics
@@ -75,11 +78,11 @@ pnpm add @intlayer/analytics
 bun add @intlayer/analytics
 ```
 
-Если вы её не установите, все точки интеграции будут разрешаться в пустые операции (no-op) — см. [Нулевые затраты, если не установлено](#нулевые-затраты-если-не-установлено) ниже.
+Чтобы включить аналитику, достаточно установить пакет: значение `analytics.enabled` по умолчанию равно `true`, а `@intlayer/config` приводит его к `false`, если пакет не найден в вашем проекте. Если вы её не установите, все точки интеграции будут разрешаться в пустые операции (no-op) — см. [Нулевые затраты, если не установлено](#нулевые-затраты-если-не-установлено) ниже.
 
 ## Настройка
 
-Аналитика **повторно использует существующий блок конфигурации `editor`** — вам не нужно заполнять отдельную схему конфигурации для `analytics`:
+Аналитике не нужна настройка, чтобы начать работу: она **включена по умолчанию** и **переиспользует существующий блок конфигурации `editor`** для эндпоинта и ключа проекта.
 
 ```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import type { IntlayerConfig } from "intlayer";
@@ -100,16 +103,25 @@ export default config;
 
 Если вы самостоятельно размещаете (self-host) Intlayer, аналитика автоматически указывает на ваш собственный экземпляр, поскольку она использует общий `editor.backendURL`.
 
-## Поддержка фреймворков
+### Как отключить
 
-Аналитика встроена в общий `IntlayerProvider` из `react-intlayer`, поэтому она доступна уже сегодня везде, где используется этот провайдер:
+Необязательный блок `analytics` настраивает — или полностью отключает — сбор данных:
 
-| Фреймворк                                                | Статус                                                                                                      |
-| -------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
-| 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` |
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  analytics: {
+    enabled: false, // По умолчанию: true — исключает всю интеграцию из сборки
+    flushInterval: 20_000, // Миллисекунды между двумя пакетными отправками
+    sampleRate: 1, // Доля записываемых сессий, от 0 (ни одной) до 1 (все)
+  },
+};
+
+export default config;
+```
+
+Удаление `@intlayer/analytics` даёт тот же эффект, что и `enabled: false`. Полный список полей см. в [справочнике по конфигурации](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/configuration.md).
 
 ## Использование
 
@@ -154,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";
 
@@ -164,6 +204,8 @@ const variant = client?.getVariant("homepage-hero", [
 ]);
 ```
 
+> `getVariant` только присваивает — он не записывает экспозицию. Предпочитайте `useExperiment()`, иначе коэффициент конверсии не будет иметь знаменателя.
+
 ## Конфиденциальность и производительность
 
 - **Анонимность по дизайну**: сессии идентифицируются по ротируемому id; сервер когда-либо сохраняет только **SHA-256 хэш** этого id — никогда сам id и никогда IP-адрес.
@@ -177,7 +219,7 @@ const variant = client?.getVariant("homepage-hero", [
 `@intlayer/analytics` следует тому же паттерну опциональных зависимостей, что и `@intlayer/editor`:
 
 - каждая точка интеграции загружает пакет через **динамический `import()`, обернутый в `try/catch`** — приложение, которое никогда не устанавливает `@intlayer/analytics`, не увеличивает размер сборки (bundle) и не тратит ресурсы во время выполнения, а также никогда не видит ошибок;
-- переменная окружения времени компиляции (`INTLAYER_ANALYTICS_ENABLED`), автоматически устанавливаемая в `'false'` пакетом `@intlayer/config`, когда не настроен `editor.clientId`, позволяет бандлерам **удалять весь код интеграции (dead-code-eliminate)**;
+- переменная окружения времени компиляции (`INTLAYER_ANALYTICS_ENABLED`), автоматически устанавливаемая `@intlayer/config` в `'false'`, когда пакет не установлен, `analytics.enabled` равно `false` или не настроен `editor.clientId`, позволяет бандлерам **удалить всю интеграцию как мёртвый код (dead-code-eliminate)**;
 - аналитика отключена внутри iframe предварительного просмотра редактора/CMS Intlayer, поэтому сессии в редакторе никогда не учитываются как реальный трафик.
 
 ## Дашборд: Страница Analytics
@@ -213,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` остаются "разумным" выбором, но будьте готовы потратить много времени на оптимизацию, чтобы избежать утечек.