@intlayer/docs 9.3.3 → 9.4.0

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

@@ -56,7 +56,7 @@ export default defineConfig({
 2. Opcja `build.optimize` ma wartość `true` (lub `undefined`, co dla kompilacji domyślnie oznacza `true`).
 3. Opcja `build.minify` w konfiguracji Intlayer ma wartość `true`.
 
-Wtyczka jest automatycznie **wyłączana**, gdy `editor.enabled` ma wartość `true`, ponieważ edytor wymaga pełnej, czytelnej dla człowieka zawartości słownika.
+Gdy `editor.enabled` ma wartość `true`, wtyczka nadal działa, ale **pomija zmianę nazw pól**: zmiana nazw przepisuje klucze treści, po których porusza się interpreter, więc `keyPath` otrzymywany przez wizualny edytor przestałby pasować do niezmergowanych słowników, które edytuje. Kompresja białych znaków i usuwanie metadanych najwyższego poziomu pozostają aktywne.
 
 ## Co podlega minifikacji
 

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

@@ -28,6 +28,8 @@ author: aymericzip
 
 Wtyczka Vite `intlayerPrune` służy do tree-shakingu i usuwania nieużywanych słowników z bundla Twojej aplikacji. Pomaga to zmniejszyć końcowy rozmiar bundla, uwzględniając jedynie niezbędne wielojęzyczne treści.
 
+> Plugin jest już automatycznie włączony i skonfigurowany, gdy używasz [`intlayer()`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/vite-intlayer/intlayer.md). Musisz go zarejestrować ręcznie tylko wtedy, gdy skomponujesz stos pluginów samodzielnie.
+
 ## Użycie
 
 ### W ramach `intlayer()` (zalecane)
@@ -115,4 +117,4 @@ Gdy przycinanie przebiegnie pomyślnie, `intlayerPrune` zapisuje również `prun
 2. `build.optimize` to `true` (lub `undefined`, które domyślnie przyjmuje wartość `true` dla kompilacji).
 3. `build.purge` to `true` w konfiguracji Intlayer.
 
-Jest automatycznie **wyłączony** gdy `editor.enabled` to `true`, ponieważ edytor wymaga pełnej zawartości słownika.
+Pozostaje aktywny, gdy `editor.enabled` ma wartość `true`: wizualny edytor odwzorowuje każdą edycję za pomocą `dictionaryKey` + `keyPath` względem niezmergowanych słowników, których ta wtyczka nigdy nie dotyka, a usunięte pole to pole, którego nie odczytuje żaden komponent — więc nigdy nie jest renderowane ani wybieralne na stronie.

package/docs/pl/per_locale_file.md

@@ -76,6 +76,17 @@ const helloWorldContent = {
 module.exports = helloWorldContent;
 ```
 
+```json5 fileName="hello-world.pl.content.json" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "hello-world",
+  "locale": "pl", // Ważne
+  "content": {
+    "multilingualContent": "Tytuł mojego komponentu",
+  },
+}
+```
+
 ```json fileName="hello-world.content.ts" contentDeclarationFormat="json"
 {
   "$schema": "https://intlayer.org/schema.json",
@@ -94,6 +105,8 @@ module.exports = helloWorldContent;
 
 > Zalecane: Ten format jest najlepszy podczas korzystania z wizualnego edytora Intlayer lub zarządzania tłumaczeniami bezpośrednio w kodzie.
 
+> Uwaga: W obu przypadkach plik deklaracji zawartości musi być zgodny ze wzorem nazewnictwa `*.content.{ts,tsx,js,jsx,mjs,cjs,json}`, aby być rozpoznany przez Intlayer. Sufiks `.[locale]` jest opcjonalny i używany tylko jako konwencja nazewnictwa.
+
 ### Globalna konfiguracja dla plików dla poszczególnych lokali
 
 Możesz skonfigurować globalną konfigurację dla plików dla poszczególnych lokali, dodając poniższą treść do pliku `intlayer.config.ts`:
@@ -145,17 +158,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", // Ważne
-  "content": {
-    "multilingualContent": "Tytuł mojego komponentu",
-  },
-}
-```
-
 ```json5 fileName="hello-world.es.content.json" contentDeclarationFormat="json"
 {
   "$schema": "https://intlayer.org/schema.json",
@@ -169,8 +171,6 @@ export default helloWorldContent;
 
 > Ważne: Upewnij się, że pole locale jest zdefiniowane. Informuje Intlayer, jakiego języka dotyczy plik.
 
-> Uwaga: W obu przypadkach plik deklaracji zawartości musi mieć nazwę zgodną z wzorcem `*.content.{ts,tsx,js,jsx,mjs,cjs,json}`, aby został rozpoznany przez Intlayer. Sufiks `.[locale]` jest opcjonalny i służy tylko jako konwencja nazewnicza.
-
 ## Mieszanie formatów
 
 Możesz łączyć oba podejścia deklaracji dla tego samego klucza zawartości. Na przykład:

package/docs/pl/readme.md

@@ -225,8 +225,8 @@ Poznaj naszą obszerną dokumentację, aby rozpocząć pracę z Intlayer i dowie
   <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 @@ Poznaj naszą obszerną dokumentację, aby rozpocząć pracę z Intlayer i dowie
       <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/pl/releases/v9.md

@@ -373,6 +373,8 @@ curl -fsSL https://intlayer.org/install.sh | sh
 
 Instalator pobiera `docker-compose.yml` i `.env`, automatycznie generuje wymagane sekrety i uruchamia `docker compose up -d`. Wszystko — panel, API, baza danych, magazyn obiektów oraz transakcyjne wiadomości e-mail — działa lokalnie w kontenerach.
 
+---
+
 ## Uwagi dotyczące migracji z wersji v8
 
 Jeśli aktualizujesz aplikację z wersji v8, pamiętaj, że wersja v9 nie zawiera zmian wprowadzających niekompatybilność wsteczną (breaking changes). Oto jednak kluczowe zmiany:

package/docs/pl/self_hosting.md

@@ -21,12 +21,16 @@ author: aymericzip
 
 Intlayer może działać w całości na Twojej własnej infrastrukturze — konto Intlayer Cloud nie jest wymagane. Jedno polecenie uruchamia gotowy do produkcji stos:
 
+Jedno polecenie instaluje wszystko:
+
 ```sh
 curl -fsSL https://intlayer.org/install.sh | sh
 ```
 
 Instalator pobiera plik `docker-compose.yml` oraz `.env`, automatycznie generuje wymagane sekrety i uruchamia wszystkie kontenery za pomocą `docker compose up -d`.
 
+Jedyną zewnętrzną zależnością jest **MongoDB**: backend łączy się z klastrem MongoDB **Atlas**, który Ty dostarczasz. Wszystko inne działa wewnątrz kontenera.
+
 ## Spis treści
 
 <TOC/>
@@ -60,40 +64,82 @@ Chromium (używany do generowania zrzutów ekranu przez Puppeteer) jest dołącz
 - Porty `3000`, `3100`, `8025`, `9000` i `9001` dostępne na hoście.
 - Host Linux lub macOS (lub WSL2 na Windows).
 
+Wszystko inne — Bun, Redis, MinIO, Chromium — jest dołączone do obrazu.
+
 ---
 
 ## Szybki start
 
-Pobierz i uruchom opublikowany obraz, podając swoje poświadczenia i sekrety MongoDB Atlas:
+### 1. Uruchom instalator
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Instalator sprawdza, czy Docker jest zainstalowany i uruchomiony, zapisuje `./intlayer.env` z już wygenerowanymi `BETTER_AUTH_SECRET` i `S3_SECRET_ACCESS_KEY`, a następnie pobiera obraz. Nie uruchamia kontenera — backend nie może się uruchomić bez poświadczeń bazy danych.
+
+Ponowne uruchomienie instalatora jest bezpieczne: istniejący plik `intlayer.env` nigdy nie zostanie nadpisany, co czyni to również ścieżką aktualizacji.
+
+### 2. Wypełnij swoje dane uwierzytelniające
+
+Otwórz `intlayer.env` i uzupełnij wartości oznaczone `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>
+```
+
+Plik zawiera również skomentowane bloki dla opcjonalnych funkcji — [SMTP mailer](#global-mailer), `OPENAI_API_KEY` i dostawcy OAuth. Odkomentuj to, czego potrzebujesz.
+
+> Plik jest odczytywany przez `docker run --env-file`, który nie usuwa cudzysłowów i traktuje wszystko po `=` jako wartość. Wpisz wartości bez cudzysłowów i przechowuj komentarze na własnych liniach.
+
+### 3. Uruchom kontener
+
+To jest polecenie, które instalator wypisuje po zakończeniu:
 
 ```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
 ```
 
-Następnie otwórz **http://localhost:3000**.
+Następnie otwórz **http://localhost:3000**. Pierwszy boot inicjalizuje magazyny danych, więc daj mu minutę.
 
-> Dashboard jest obsługiwany na `localhost`. Zapoznaj się z [Ograniczeniami](#limitations) — domeny niestandardowe nie są obsługiwane przez opublikowany obraz.
+> Dashboard jest serwowany na `localhost`. Zobacz [Ograniczenia](#limitations) — niestandardowe domeny nie są obsługiwane przez opublikowany obraz.
 
----
+### Ustawienia instalatora
 
-## Szybki start
+Installer odczytuje kilka zmiennych środowiskowych. Ponieważ są one przesyłane do `sh`, przekaż je do powłoki zamiast do `curl`:
 
 ```sh
-curl -fsSL https://intlayer.org/install.sh | sh
+curl -fsSL https://intlayer.org/install.sh | INTLAYER_ENV_FILE=./config/intlayer.env sh
 ```
 
+| Zmienna                   | Domyślnie                                     | Opis                               |
+| ------------------------- | --------------------------------------------- | ---------------------------------- |
+| `INTLAYER_IMAGE`          | `ghcr.io/aymericzip/intlayer-selfhost:latest` | Obraz do pobrania                  |
+| `INTLAYER_ENV_FILE`       | `./intlayer.env`                              | Gdzie zapisać plik env             |
+| `INTLAYER_CONTAINER_NAME` | `intlayer`                                    | Nazwa kontenera                    |
+| `INTLAYER_DATA_VOLUME`    | `intlayer-data`                               | Named volume zamontowany w `/data` |
+| `INTLAYER_APP_PORT`       | `3000`                                        | Port hosta dla dashboardu          |
+| `INTLAYER_API_PORT`       | `3100`                                        | Port hosta dla API                 |
+| `INTLAYER_S3_PORT`        | `9000`                                        | Port hosta dla MinIO S3 API        |
+| `INTLAYER_CONSOLE_PORT`   | `9001`                                        | Port hosta dla konsoli MinIO       |
+
+> Cztery zmienne portów zmieniają tylko **stronę hosta** mapowania wydrukowanego w poleceniu `docker run`. Opublikowany obraz ma `http://localhost:3000`, `http://localhost:3100` i `http://localhost:9000` skompilowane w bundle'u dashboardu w czasie kompilacji, dlatego zmapowanie ich na nowo powoduje, że przeglądarka wskazuje na stare porty. Zachowaj wartości domyślne, chyba że budujesz swój własny obraz — zobacz [Ograniczenia](#limitations).
+
+---
+
+## Szybki start
+
 Co robi instalator:
 
 1.  Sprawdza, czy `docker` i `docker compose` są obecne.
@@ -117,8 +163,6 @@ Po uruchomieniu stosu, otwórz **http://localhost:3000** i utwórz swoje pierwsz
 | **minio**     | `minio/minio`                         | `9000` (S3), `9001` (konsola)            | Przechowywanie obiektów zgodne z S3 dla awatarów i zrzutów ekranu |
 | **mailpit**   | `axllent/mailpit`                     | `1025` (SMTP), `8025` (interfejs webowy) | Lokalny odbiornik transakcyjnych wiadomości e-mail                |
 
-Wewnętrzne porty (mongo, redis) nie są domyślnie udostępniane na hoście.
-
 > Port MinIO `9000` musi być osiągalny przez przeglądarkę, ponieważ przesłane zasoby (awatary, zrzuty ekranu) są ładowane bezpośrednio z `S3_PUBLIC_URL=http://localhost:9000/intlayer`.
 
 ---
@@ -174,8 +218,6 @@ Wewnętrzne porty (mongo, redis) nie są domyślnie udostępniane na hoście.
 | `LINKEDIN_CLIENT_ID`, `LINKEDIN_CLIENT_SECRET`           | Logowanie LinkedIn OAuth                                                                        |
 | `ATLASSIAN_CLIENT_ID`, `ATLASSIAN_CLIENT_SECRET`         | Logowanie Atlassian OAuth                                                                       |
 
----
-
 ### Globalny dostawca poczty
 
 Domyślnie wszystkie transakcyjne wiadomości e-mail są wysyłane za pośrednictwem Resend przy użyciu `RESEND_API_KEY`. Wdrożenia self-hosted mogą zamiast tego kierować **każdy** e-mail — w tym e-maile niezwiązane z organizacją, takie jak resetowanie hasła i linki magiczne — za pośrednictwem globalnego dostawcy poczty skonfigurowanego zmiennymi środowiskowymi.
@@ -261,16 +303,8 @@ const { data: dictionaries } = await dictionaryEndpoint(cms).getDictionaries();
 
 ## Aktualizacja
 
-Ponowne uruchomienie instalatora na istniejącym wdrożeniu wykonuje aktualizację krokową:
-
-```sh
-curl -fsSL https://intlayer.org/install.sh | sh
-```
-
 Spowoduje to pobranie najnowszych obrazów i ponowne uruchomienie kontenerów za pomocą `docker compose pull && docker compose up -d`. Istniejące woluminy (`mongo-data`, `redis-data`, `minio-data`) zostaną zachowane — brak utraty danych.
 
-Aby ręcznie zaktualizować z poziomu katalogu `./intlayer/`:
-
 ```sh
 docker compose pull
 docker compose up -d
@@ -334,15 +368,12 @@ docker compose logs mongo
 docker compose logs redis
 ```
 
+Poszukaj `MongoDB connection error` w górnej części dziennika.
+
 ### Pulpit nawigacyjny nie może dotrzeć do API
 
 Sprawdź, czy `VITE_BACKEND_URL` odpowiada adresowi URL, pod którym backend jest osiągalny z **przeglądarki** (nie z sieci Docker). Jeśli zmieniłeś port backendu lub dodałeś reverse proxy, ponownie zbuduj obraz pulpitu nawigacyjnego:
 
-```sh
-docker compose build app
-docker compose up -d app
-```
-
 ### Brak zasobnika MinIO
 
 Jeśli jednorazowa usługa `minio-init` nie uruchomiła się (lub uruchomiła się, zanim MinIO było gotowe), utwórz zasobnik ręcznie:

package/docs/pt/agent_skills.md

@@ -1,11 +1,11 @@
 ---
 createdAt: 2026-02-09
 updatedAt: 2026-03-03
-title: Competências do Agente
+title: Agent Skills
 description: Aprenda a usar as Intlayer Agent Skills para melhorar a compreensão do seu projeto pelo seu agente de IA, incluindo guias de configuração abrangentes para Metadados, Sitemaps e Ações do Servidor.
 keywords:
   - Intlayer
-  - Competências do Agente
+  - Agent Skills
   - Agente de IA
   - Internacionalização
   - Documentação
@@ -19,13 +19,13 @@ history:
 author: aymericzip
 ---
 
-# Competências do Agente
+# Agent Skills
 
 ## Inicialização
 
 ### Usando a CLI
 
-O comando `intlayer init skills` é a maneira mais fácil de configurar as competências do agente em seu projeto. Ele detecta seu ambiente e instala os arquivos de configuração necessários para suas plataformas preferidas.
+O comando `intlayer init skills` é a maneira mais fácil de configurar as Agent Skills em seu projeto. Ele detecta seu ambiente e instala os arquivos de configuração necessários para suas plataformas preferidas.
 
 ```bash packageManager="npm"
 npx intlayer init skills
@@ -54,10 +54,10 @@ npx skills add aymericzip/intlayer-skills
 1. Abra a Paleta de Comandos (Ctrl+Shift+P ou Cmd+Shift+P).
 2. Digite `Intlayer: Setup AI Agent Skills`.
 3. Escolha a plataforma que você usa (ex: `VS Code`, `Cursor`, `Windsurf`, `OpenCode`, `Claude Code`, `GitHub Copilot Workspace`, etc.).
-4. Escolha as competências que deseja instalar (ex: `Next.js`, `React`, `Vite`, `Compiler`, `Configuration`).
+4. Escolha as Agent Skills que deseja instalar (ex: `Next.js`, `React`, `Vite`, `Compiler`, `Configuration`).
 5. Pressione Enter.
 
-## Lista de Competências
+## Lista de Agent Skills
 
 **intlayer-config**
 

package/docs/pt/analytics.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-07-08
-updatedAt: 2026-07-08
+updatedAt: 2026-08-22
 title: Intlayer Analytics | Acompanhe a exposição de conteúdo e execute testes A/B
 description: Descubra como o @intlayer/analytics rastreia visualizações de página/idioma e exposição de conteúdo, e como usá-lo para executar testes A/B em seu conteúdo do Intlayer.
 keywords:
@@ -18,6 +18,9 @@ slugs:
   - concept
   - analytics
 history:
+  - version: 9.3.3
+    date: 2026-08-22
+    changes: "Ativar os analytics por predefinição quando `@intlayer/analytics` está instalado"
   - version: 9.0.0
     date: 2026-07-08
     changes: "Init doc — pacote @intlayer/analytics, rastreamento a nível de provider/node, testes A/B, dashboard"
@@ -57,7 +60,7 @@ O Intlayer já permite que você declare [Variantes](https://github.com/aymericz
 
 ## Instalação
 
-O `@intlayer/analytics` é uma dependência **peer e opcional** — nunca instalada automaticamente por um pacote de framework. Adicione-o junto com o `intlayer`:
+`@intlayer/analytics` é uma **dependência opcional** de todos os pacotes de framework (`react-intlayer`, `next-intlayer`, `vue-intlayer`, …), pelo que a maioria dos projetos já a tem. Instale-a explicitamente se a sua configuração ignorar dependências opcionais (`npm install --no-optional`, …):
 
 ```bash packageManager="npm"
 npm install @intlayer/analytics
@@ -75,11 +78,11 @@ pnpm add @intlayer/analytics
 bun add @intlayer/analytics
 ```
 
-Se você não instalá-lo, todos os pontos de integração se resolvem como uma operação nula (no-op) — veja [Custo zero quando não instalado](#custo-zero-quando-nao-instalado) abaixo.
+Instalar o pacote é tudo o que é preciso para ligar os analytics: `analytics.enabled` é `true` por predefinição e o `@intlayer/config` resolve-o para `false` sempre que o pacote não for encontrado no seu projeto. Se você não instalá-lo, todos os pontos de integração se resolvem como uma operação nula (no-op) — veja [Custo zero quando não instalado](#custo-zero-quando-nao-instalado) abaixo.
 
 ## Configuração
 
-O Analytics **reutiliza o bloco de configuração `editor` existente** — não há um esquema de configuração `analytics` separado para preencher:
+Os analytics não precisam de configuração para arrancar: estão **ativados por predefinição** e **reutilizam o bloco de configuração `editor` existente** para o endpoint e a chave de projeto.
 
 ```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import type { IntlayerConfig } from "intlayer";
@@ -100,6 +103,26 @@ export default config;
 
 Se você hospeda o Intlayer por conta própria (self-host), a análise aponta automaticamente para a sua própria instância, já que compartilha o `editor.backendURL`.
 
+### Como desativar
+
+O bloco opcional `analytics` ajusta — ou desliga — a recolha:
+
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  analytics: {
+    enabled: false, // Predefinição: true — retira toda a integração do bundle
+    flushInterval: 20_000, // Milissegundos entre dois envios em lote
+    sampleRate: 1, // Fração de sessões a registar, de 0 (nenhuma) a 1 (todas)
+  },
+};
+
+export default config;
+```
+
+Desinstalar `@intlayer/analytics` tem o mesmo efeito que `enabled: false`. Consulte a [referência de configuração](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/configuration.md) para a lista completa de campos.
+
 ## Suporte a Frameworks
 
 O Analytics está conectado ao `IntlayerProvider` compartilhado do `react-intlayer`, portanto, está disponível hoje em qualquer lugar em que esse provider seja usado:
@@ -177,7 +200,7 @@ const variant = client?.getVariant("homepage-hero", [
 O `@intlayer/analytics` segue exatamente o mesmo padrão de dependência opcional do `@intlayer/editor`:
 
 - cada ponto de integração carrega o pacote através de um **`import()` dinâmico envolto em `try/catch`** — um aplicativo que nunca instala o `@intlayer/analytics` nunca paga um custo de tamanho de bundle ou tempo de execução, e nunca vê um erro;
-- uma variável de ambiente em tempo de compilação (`INTLAYER_ANALYTICS_ENABLED`), definida automaticamente como `'false'` pelo `@intlayer/config` sempre que o `editor.clientId` não estiver configurado, permite que os bundlers **eliminem o código morto (dead-code-eliminate)** de toda a integração;
+- uma variável de ambiente em tempo de compilação (`INTLAYER_ANALYTICS_ENABLED`), definida automaticamente como `'false'` pelo `@intlayer/config` sempre que o pacote não está instalado, `analytics.enabled` é `false` ou `editor.clientId` não está configurado, permite aos bundlers **eliminar como código morto (dead-code-eliminate)** toda a integração;
 - as análises são desativadas dentro do iframe de visualização do editor/CMS do Intlayer, para que as sessões de edição nunca sejam contabilizadas como tráfego real.
 
 ## Dashboard: Página Analytics

package/docs/pt/benchmark/tanstack.md

@@ -194,6 +194,8 @@ O `Paraglide` oferece uma abordagem inovadora e bem pensada. Mesmo assim, neste
 
 O `Tolgee` resolve muitos dos problemas mencionados anteriormente. Achei mais difícil de começar com ele do que com outras ferramentas com abordagens semelhantes. Ele não fornece segurança de tipos, o que também torna muito difícil encontrar chaves ausentes no momento da compilação. Tive que envolver as APIs do Tolgee com as minhas para adicionar a detecção de chaves ausentes.
 
+O package é bastante pesado (~11.1kb, o que é mais de 2× `react-intlayer`).
+
 No TanStack Start também tive problemas de reatividade: na mudança de localidade, tive que forçar o provedor a renderizar novamente e me inscrever em eventos de mudança de localidade para que o carregamento em outro idioma se comportasse corretamente.
 
 **(use-intl)** (`use-intl@4.9.1`):
@@ -208,6 +210,8 @@ O `react-i18next` é provavelmente a opção mais popular porque foi uma das pri
 
 Ainda assim, compartilha os mesmos grandes pontos negativos que as stacks baseadas em `t('a.b.c')`: as otimizações são possíveis, mas consomem muito tempo, e grandes projetos correm o risco de cair em más práticas (namespaces + carregamento dinâmico + tipos).
 
+O package é especialmente pesado (~17.3kb, o que é aproximadamente 3.5× `react-intlayer`).
+
 Os formatos de mensagem também divergem: o `use-intl` usa ICU MessageFormat, enquanto o `i18next` usa seu próprio formato - o que complica o ferramental ou migrações se você os misturar.
 
 **(Lingui)** (`@lingui/core@5.3.0`):
@@ -218,6 +222,8 @@ O `Lingui` é frequentemente elogiado. Pessoalmente, achei o fluxo de trabalho e
 
 O `react-intl` é uma implementação de alto desempenho da equipe do Format.js. O DX permanece prolixo: `const intl = useIntl()` + `intl.formatMessage({ id: "xx.xx" })` adiciona complexidade, trabalho extra de JavaScript e vincula a instância global de i18n a muitos nós na árvore React.
 
+O package também é pesado (~14.4kb, o que é cerca de 3× `react-intlayer`).
+
 ### 4 - Recomendações
 
 Este benchmark do TanStack Start não possui um equivalente direto do `next-translate` (plugin Next.js + `getStaticProps`). Para as equipes que realmente desejam uma API `t()` com um ecossistema maduro, o `react-i18next` e o `use-intl` continuam sendo escolhas "razoáveis", mas espere investir muito tempo otimizando para evitar vazamentos.

package/docs/pt/bundle_optimization.md

@@ -472,7 +472,7 @@ const config: IntlayerConfig = {
 export default config;
 ```
 
-> Os propósitos associativos das exclusões nas transformações focando nas extensões da minimização acabam por pautar no pulo perante processos integrando false no seu escopo no otimizador e false focando nos diretórios `editor.enabled`.
+> A minificação é ignorada quando `optimize` é `false`. Quando `editor.enabled` é `true`, ela continua sendo executada, mas sem a etapa de renomeação de campos — o editor visual resolve as edições por meio do `keyPath`, portanto os nomes de campo originais precisam ser preservados.
 
 > No Next.js, a minificação também é ignorada quando o `@intlayer/swc` não está instalado ou não pode ser carregado (Next.js abaixo da 16.1.0). O plugin é a metade que reescreve os acessos no código-fonte, então renomear os dicionários sem ele deixaria seu código lendo nomes de campos que não existem mais.
 
@@ -504,7 +504,7 @@ export default config;
 { "title": "…", "subtitle": "…" }
 ```
 
-> Processos atrelados pautando focos purificados são limitados atrelados nos parâmetros atrelados nos propósitos e diretórios de optimize em restrições do false no otimizador integrando ao formato modular no limite focando no suporte das formatações base false nos diretórios da edição e formatos no construto formatado da extensão construtiva. No Next.js ele é adicionalmente ignorado quando o `@intlayer/swc` está indisponível e quando chamadores de adaptadores de compatibilidade estão configurados.
+> A purga é ignorada quando `optimize` é `false`. Ela permanece ativa quando `editor.enabled` é `true` — um campo removido não é lido por nenhum componente, então o editor nunca o renderiza. No Next.js, ela também é ignorada quando `@intlayer/swc` está indisponível e quando há chamadores de adaptadores de compatibilidade configurados.
 
 > Processos perante o uso na purificação também são suspensos perante focos no método nativo que limitam análises do suporte da base com dados referenciados da função de predefinições e diretrizes voltadas atrelando propósitos de extensão.
 

package/docs/pt/cli/ci.md

@@ -128,6 +128,8 @@ bun x intlayer ci fill --verbose --mode complete
 
 ### Usar em pipelines CI/CD
 
+Executar `intlayer init` gera dois workflows prontos para usar do GitHub Actions para você (veja [GitHub Actions gerados](#scaffolded-github-actions) abaixo). O exemplo aqui mostra a configuração equivalente usando o comando `ci` para um monorepo, onde as credenciais são injetadas por projeto a partir de `INTLAYER_PROJECT_CREDENTIALS`.
+
 Em sua configuração CI/CD (por exemplo, GitHub Actions, GitLab CI), defina `INTLAYER_PROJECT_CREDENTIALS` como um segredo:
 
 ```yaml

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

@@ -91,7 +91,15 @@ Para a maioria dos casos de uso,
 
 - **`--log`**: Modo apenas de registro (log-only). Não traduz com IA; em vez disso, registra os blocos que precisam de atenção (com números de linha e conteúdo) para as localidades base e de destino, a fim de ajudar outro agente a gerar as traduções.
 
-  > Exemplo: `npx intlayer doc review --log`
+- The **English (en) source content** for BLOCK 1
+- The **Portuguese (pt) current translation** for BLOCK 1
+- Confirmation of the **action mode** you'd like me to use (`apply`, `report`, or `synthesis`)
+
+> Exemplo: `npx intlayer doc review --mode report`
+
+> Exemplo: `npx intlayer doc review --log`
+
+Seja qual for o modo, a execução termina com uma síntese listando os documentos que estão alinhados com seu documento base e os que ainda têm blocos para editar.
 
 **Opções de saída da entrada:**
 

package/docs/pt/cli/fill.md

@@ -39,14 +39,6 @@ bun x intlayer fill
 
 Este comando analisa seus arquivos de declaração de conteúdo em busca de possíveis problemas, como traduções faltantes, inconsistências estruturais ou incompatibilidades de tipo. Se encontrar algum problema, o **intlayer fill** irá propor ou aplicar atualizações para manter seus dicionários consistentes e completos.
 
-Pontos-chave:
-
-- Divide arquivos JSON grandes em partes para permanecer dentro dos limites da janela de contexto do modelo de IA.
-- Tenta novamente a tradução se o formato de saída estiver incorreto.
-- Incorpora contexto específico da aplicação e do arquivo para melhorar a precisão da tradução.
-- Preserva traduções existentes ao não sobrescrevê-las.
-- Processa arquivos, partes e locales em paralelo usando um sistema de fila para aumentar a velocidade.
-
 ## Pontos-Chave:
 
 - Divide arquivos JSON grandes em chunks para se manter dentro dos limites da janela de contexto do modelo de IA.

package/docs/pt/cli/index.md

@@ -127,6 +127,8 @@ Para ver como configurar os idiomas disponíveis ou outros parâmetros, consulte
 
 - **[Login](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/cli/login.md)** - Autentique-se no Intlayer CMS e obtenha credenciais de acesso
 
+> `intlayer login` emite uma **chave de acesso** (`clientId` / `clientSecret`) que todo comando autenticado usa. O segredo é uma credencial do lado do servidor e nunca chega ao seu pacote cliente — veja [Mantendo a chave de acesso segura](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/cli/login.md#mantendo-a-chave-de-acesso-segura).
+
 ### Comandos Principais
 
 - **[Build de Dicionários](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/cli/build.md)** - Construa os seus dicionários a partir de ficheiros de declaração de conteúdo

package/docs/pt/cli/list_projects.md

@@ -52,8 +52,6 @@ Este comando procura e lista todos os projetos Intlayer ao encontrar diretórios
 
   > Exemplo: `npx intlayer projects list --base-dir /path/to/workspace`
 
-  > Exemplo: `npx intlayer projects list --base-dir /path/to/workspace`
-
 - **`--git-root`**: Pesquise a partir do diretório raiz do git em vez do diretório base. Isto é útil para encontrar todos os projetos Intlayer num monorepo ou repositório git.
 
   > Exemplo: `npx intlayer projects list --git-root`
@@ -200,8 +198,4 @@ $ npx intlayer projects list --json
 - **CI/CD**: Verificar projetos Intlayer em workflows automatizados
 - **Documentação**: Gerar documentação listando todos os projetos que usam Intlayer
 
-A saída fornece caminhos absolutos para cada diretório de projeto, facilitando a navegação ou a automatização de operações em múltiplos projetos Intlayer.
-
-- **Documentação**: Gerar documentação listando todos os projetos que usam o Intlayer
-
 A saída fornece caminhos absolutos para cada diretório de projeto, tornando fácil navegar até eles ou escrever scripts para executar operações em vários projetos Intlayer.

package/docs/pt/cli/login.md

@@ -122,6 +122,34 @@ INTLAYER_CLIENT_SECRET=your_client_secret
 }
 ```
 
+## Mantendo a chave de acesso segura
+
+`intlayer login` emite uma **chave de acesso**: um par `clientId` / `clientSecret` que todo comando credenciado (`push`, `pull`, `fill`, `configuration push`, `live`, …) usa para autenticar.
+
+```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` é uma credencial do lado do servidor.** Ela concede acesso total à API com escopo do projeto — leitura e escrita de seus dicionários, seu projeto e sua organização. Mantenha-a em `.env` (ignorado pelo git) ou no armazenamento de segredos do CI, e nunca a coloque inline no arquivo de configuração.
+
+Intlayer impõe isso em vez de apenas documentá-lo:
+
+- `clientSecret` é **removido da configuração que seu bundler incorpora**, portanto não pode chegar a um bundle do navegador qualquer que seja a integração do framework que você use. Ele é apenas lido do lado do servidor, em tempo de execução, a partir do ambiente.
+- `clientId` é diferente: é a **chave pública** do projeto, segura para enviar, e usada por [`@intlayer/analytics`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/analytics.md#how-events-are-authenticated) para obter um token de curta duração, apenas para ingestão.
+
+Comentar `clientId` é suficiente para desabilitar todo comportamento credenciado — busca remota de dicionários, acesso ao CMS, análises — mesmo quando as variáveis de ambiente ainda estão definidas.
+
+Para pipelines de CI, prefira o [`comando ci`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/cli/ci.md), que injeta as credenciais pela duração de uma única execução em vez de persistí-las.
+
 ## Configuração Manual
 
 Se o navegador não abrir automaticamente, você pode visitar manualmente a URL exibida no terminal.
@@ -214,8 +242,6 @@ Após completar o login:
    - [`npx intlayer push`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/cli/push.md) - Fazer push de dicionários para o CMS
    - [`npx intlayer pull`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/cli/pull.md) - Fazer pull de dicionários do CMS
 
-- [`npx intlayer fill`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/cli/fill.md) - Preencher traduções faltantes
-
 ## Veja também
 
 - [Documentação da CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/cli/index.md)

package/docs/pt/cli/watch.md

@@ -48,5 +48,3 @@ Este comando é o equivalente a `npx intlayer build --watch --skip-prepare`.
 - **`--with`**: Inicia um comando em paralelo com o monitoramento.
 
   > Exemplo: `npx intlayer watch --with "next dev --turbopack"`
-
-  > Exemplo: `npx intlayer watch --with "next dev --turbopack"`

package/docs/pt/compiler.md

@@ -40,6 +40,12 @@ O **Intlayer Compiler** é uma ferramenta poderosa projetada para automatizar o
 
 ## Por que Usar o Intlayer Compiler?
 
+- **Automação**: Elimina a cópia manual de conteúdo para dicionários.
+
+- **Speed**: Extração de conteúdo otimizada garantindo que seu processo de build permaneça rápido.
+
+- **Developer Experience**: Mantenha as declarações de conteúdo onde são usadas, melhorando a manutenibilidade.
+
 - **Automação**: Elimina a cópia manual e colagem de conteúdo nos dicionários.
 - **Velocidade**: Extração de conteúdo otimizada garantindo que seu processo de build permaneça rápido.
 - **Experiência do Desenvolvedor**: Mantenha as declarações de conteúdo exatamente onde são usadas, melhorando a manutenção.
@@ -54,12 +60,16 @@ Embora o compilador ofereça uma excelente experiência "funciona automaticament
 - **Ambiguidade heurística**: O compilador deve adivinhar o que é conteúdo voltado para o usuário versus a lógica da aplicação (por exemplo, `className="active"`, códigos de status, IDs de produtos). Em bases de código complexas, isso pode levar a falsos positivos ou strings perdidas que exigem anotações manuais e exceções.
 - **Extração apenas estática**: A extração baseada em compilador depende de análise estática. Strings que existem apenas em tempo de execução (códigos de erro de API, campos CMS, etc.) não podem ser descobertas ou traduzidas pelo compilador sozinho, então você ainda precisa de uma estratégia i18n de tempo de execução complementar.
 
+- **Extração estática apenas**: A extração baseada em compilador depende de análise estática. Strings que existem apenas em tempo de execução (códigos de erro de API, campos de CMS, etc.) não podem ser descobertos ou traduzidos pelo compilador sozinho, portanto você ainda precisa de uma estratégia de i18n em tempo de execução complementar.
+
 Para uma comparação arquitetural mais profunda, veja o post do blog [Compiler vs. Declarative i18n](https://github.com/aymericzip/intlayer/blob/main/docs/blog/pt/compiler_vs_declarative_i18n.md).
 
 Como alternativa, para automatizar seu processo i18n mantendo controle total sobre seu conteúdo, o Intlayer também fornece um comando de auto-extração `intlayer extract` (consulte a [documentação CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/cli/extract.md)), ou o comando `Intlayer: extract content to Dictionary` da extensão Intlayer VS Code (consulte a [documentação da extensão VS Code](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/vs_code_extension.md)).
 
 ## Uso
 
+> A forma mais rápida de integrar o compiler é através da configuração interativa: execute `npx intlayer init --interactive` e selecione **Compiler**. No Vite não há nada para configurar — o compiler é conectado diretamente através do plugin principal `intlayer()` (é ativado automaticamente uma vez que `compiler.enabled` está definido e um caminho `compiler.output` é configurado). No Next.js o comando gera o `babel.config.js` mostrado abaixo. O `intlayer init` não-interativo deixa a configuração do compiler intocada.
+
 <Tabs>
  <Tab value='vite'>
 
@@ -92,12 +102,18 @@ export default defineConfig({
 });
 ```
 
+> O plugin `intlayerCompiler()` independente ainda é exportado para configurações avançadas. Registrá-lo junto com `intlayer()` é seguro — o compilador se deduplica e é executado apenas uma vez.
+
 See complete tutorial: [Intlayer Compiler with Vite+React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_with_vite+react_compiler.md)
 
 #### Suporte a Frameworks
 
 O plugin do Vite detecta e lida automaticamente com diferentes tipos de arquivos:
 
+- **React / JSX / TSX**: Tratado nativamente.
+
+- **Vue**: Requer `@intlayer/vue-compiler`.
+
 - **React / JSX / TSX**: Suportado nativamente.
 - **Vue**: Requer `@intlayer/vue-compiler`.
 - **Svelte**: Requer `@intlayer/svelte-compiler`.