@intlayer/docs 9.3.3 → 9.4.0

package/docs/ko/self_hosting.md

@@ -19,6 +19,8 @@ author: aymericzip
 
 # Intlayer 자체 호스팅
 
+Intlayer는 자신의 인프라에서 실행할 수 있습니다. Intlayer Cloud 계정이 필요하지 않습니다. 단일 올인원 Docker 이미지는 대시보드, API 및 필요한 로컬 데이터스토어(Redis 및 MinIO)를 번들로 제공하며, [s6-overlay](https://github.com/just-containers/s6-overlay)로 감독됩니다.
+
 Intlayer는 Intlayer Cloud 계정 없이도 자체 인프라에서 완전히 실행될 수 있습니다. 단일 명령으로 프로덕션 준비 스택을 부팅합니다:
 
 ```sh
@@ -27,6 +29,8 @@ curl -fsSL https://intlayer.org/install.sh | sh
 
 설치 프로그램은 `docker-compose.yml` 및 `.env` 파일을 다운로드하고, 필요한 비밀을 자동으로 생성하며, `docker compose up -d` 명령으로 모든 컨테이너를 시작합니다.
 
+유일한 외부 종속성은 **MongoDB**입니다: 백엔드는 사용자가 제공하는 MongoDB **Atlas** 클러스터에 연결됩니다. 그 외 모든 것은 컨테이너 내부에서 실행됩니다.
+
 ## 목차
 
 <TOC/>
@@ -60,40 +64,82 @@ Chromium (Puppeteer 스크린샷 생성에 사용됨)은 백엔드 이미지 내
 - 호스트에서 포트 `3000`, `3100`, `8025`, `9000`, `9001`이 사용 가능해야 합니다.
 - Linux 또는 macOS 호스트 (또는 Windows의 WSL2).
 
+나머지 모든 것 — Bun, Redis, MinIO, Chromium — 은 이미지 내에 포함되어 있습니다.
+
 ---
 
 ## 빠른 시작
 
-게시된 이미지를 pull하고 실행한 후 MongoDB Atlas 자격증명과 보안 키를 제공합니다:
+### 1. 설치 프로그램 실행
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Docker가 설치되어 있고 실행 중인지 확인하고, `BETTER_AUTH_SECRET`과 `S3_SECRET_ACCESS_KEY`가 이미 생성된 상태로 `./intlayer.env`를 작성하며, 이미지를 가져옵니다. 컨테이너를 시작하지는 않습니다 — 백엔드는 데이터베이스 자격 증명 없이는 부팅할 수 없습니다.
+
+설치 프로그램을 다시 실행해도 안전합니다: 기존 `intlayer.env`는 절대 덮어씌워지지 않으므로, 업그레이드 경로로도 작동합니다.
+
+### 2. 자격 증명 입력
+
+`intlayer.env`를 열고 `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>
+```
+
+이 파일에는 선택적 기능들을 위한 주석 처리된 블록들도 포함되어 있습니다 — [SMTP mailer](#global-mailer), `OPENAI_API_KEY`, OAuth 제공자들. 필요한 것들의 주석을 제거하세요.
+
+> 이 파일은 `docker run --env-file`로 읽혀지며, 따옴표를 제거하지 않고 `=` 이후의 모든 것을 값으로 처리합니다. 따옴표 없는 값을 작성하고, 주석은 별도의 줄에 유지하세요.
+
+### 3. 컨테이너 시작
+
+설치 프로그램이 완료될 때 인쇄하는 명령어입니다:
 
 ```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
 ```
 
-그 다음 **http://localhost:3000**을 엽니다.
+그러면 **http://localhost:3000**을 엽니다. 첫 부팅 시 데이터스토어를 초기화하므로 1분 정도 기다려주세요.
 
-> 대시보드는 `localhost`에서 제공됩니다. [제한 사항](#limitations)을 참고하세요 — 게시된 이미지에서는 커스텀 도메인이 지원되지 않습니다.
+> 대시보드는 `localhost`에서 제공됩니다. [제한 사항](#limitations)을 참조하세요 — 게시된 이미지는 사용자 정의 도메인을 지원하지 않습니다.
 
----
+### 설치 프로그램 설정
 
-## 빠른 시작
+설치 프로그램은 몇 가지 환경 변수를 읽습니다. `sh`로 파이프되기 때문에 `curl`이 아닌 쉘에 전달하세요:
 
 ```sh
-curl -fsSL https://intlayer.org/install.sh | sh
+curl -fsSL https://intlayer.org/install.sh | INTLAYER_ENV_FILE=./config/intlayer.env sh
 ```
 
+| Variable                  | Default                                       | Description                    |
+| ------------------------- | --------------------------------------------- | ------------------------------ |
+| `INTLAYER_IMAGE`          | `ghcr.io/aymericzip/intlayer-selfhost:latest` | 풀할 이미지                    |
+| `INTLAYER_ENV_FILE`       | `./intlayer.env`                              | env 파일을 작성할 위치         |
+| `INTLAYER_CONTAINER_NAME` | `intlayer`                                    | 컨테이너 이름                  |
+| `INTLAYER_DATA_VOLUME`    | `intlayer-data`                               | `/data`에 마운트된 명명된 볼륨 |
+| `INTLAYER_APP_PORT`       | `3000`                                        | 대시보드용 호스트 포트         |
+| `INTLAYER_API_PORT`       | `3100`                                        | API용 호스트 포트              |
+| `INTLAYER_S3_PORT`        | `9000`                                        | MinIO S3 API용 호스트 포트     |
+| `INTLAYER_CONSOLE_PORT`   | `9001`                                        | MinIO 콘솔용 호스트 포트       |
+
+> 네 개의 포트 변수는 `docker run` 명령에 인쇄된 매핑의 **호스트** 측만 변경합니다. 발행된 이미지는 빌드 시간에 `http://localhost:3000`, `http://localhost:3100` 및 `http://localhost:9000`이 대시보드 번들에 컴파일되어 있으므로, 이들을 다시 매핑하면 브라우저가 이전 포트를 가리키게 됩니다. 자신의 이미지를 빌드하지 않는 한 기본값을 유지하세요 — [제한 사항](#limitations)을 참조하세요.
+
+---
+
+## 빠른 시작
+
 설치 프로그램의 기능:
 
 1.  `docker` 및 `docker compose`가 설치되어 있는지 확인합니다.
@@ -117,8 +163,6 @@ curl -fsSL https://intlayer.org/install.sh | sh
 | **minio**   | `minio/minio`                      | `9000` (S3), `9001` (콘솔)    | 아바타 및 스크린샷을 위한 S3 호환 객체 스토리지 |
 | **mailpit** | `axllent/mailpit`                  | `1025` (SMTP), `8025` (웹 UI) | 로컬 트랜잭션 이메일 싱크                       |
 
-내부 포트(mongo, redis)는 기본적으로 호스트에 노출되지 않습니다.
-
 > MinIO 포트 `9000`은 브라우저에서 접근할 수 있어야 합니다. 업로드된 자산(아바타, 스크린샷)은 `S3_PUBLIC_URL=http://localhost:9000/intlayer`에서 직접 로드되기 때문입니다.
 
 ---
@@ -174,8 +218,6 @@ curl -fsSL https://intlayer.org/install.sh | sh
 | `LINKEDIN_CLIENT_ID`, `LINKEDIN_CLIENT_SECRET`           | LinkedIn OAuth 로그인                                  |
 | `ATLASSIAN_CLIENT_ID`, `ATLASSIAN_CLIENT_SECRET`         | Atlassian OAuth 로그인                                 |
 
----
-
 ### Global mailer
 
 기본적으로 모든 트랜잭션 이메일은 `RESEND_API_KEY`를 사용하여 Resend를 통해 전송됩니다. Self-hosted 배포는 대신 환경 변수로 구성된 global mailer를 통해 비조직 이메일(예: 비밀번호 재설정 및 magic link)을 포함한 **모든** 이메일을 라우팅할 수 있습니다.
@@ -261,16 +303,8 @@ const { data: dictionaries } = await dictionaryEndpoint(cms).getDictionaries();
 
 ## 업그레이드
 
-기존 배포에서 설치 프로그램을 다시 실행하면 롤링 업그레이드가 수행됩니다:
-
-```sh
-curl -fsSL https://intlayer.org/install.sh | sh
-```
-
 이는 최신 이미지를 가져오고 `docker compose pull && docker compose up -d`를 사용하여 컨테이너를 다시 시작합니다. 기존 볼륨(`mongo-data`, `redis-data`, `minio-data`)은 보존되므로 데이터 손실이 없습니다.
 
-`./intlayer/` 디렉토리 내부에서 수동으로 업그레이드하려면:
-
 ```sh
 docker compose pull
 docker compose up -d
@@ -334,15 +368,12 @@ docker compose logs mongo
 docker compose logs redis
 ```
 
+로그의 상단 근처에서 `MongoDB connection error`를 찾아보세요.
+
 ### 대시보드가 API에 연결할 수 없음
 
 `VITE_BACKEND_URL`이 **브라우저**에서 백엔드에 접근 가능한 URL(Docker 네트워크가 아님)과 일치하는지 확인하세요. 백엔드 포트를 변경했거나 리버스 프록시를 추가했다면, 대시보드 이미지를 다시 빌드해야 합니다:
 
-```sh
-docker compose build app
-docker compose up -d app
-```
-
 ### MinIO 버킷 누락
 
 `minio-init` 일회성 서비스가 실행되지 않았거나(또는 MinIO가 준비되기 전에 실행된 경우), 수동으로 버킷을 생성하세요:

package/docs/nl/bundle_optimization.md

@@ -476,7 +476,7 @@ const config: IntlayerConfig = {
 export default config;
 ```
 
-> Minificatie wordt overgeslagen wanneer `optimize` `false` is of wanneer `editor.enabled` `true` is (de visuele editor vereist de originele veldnamen om bewerken mogelijk te maken).
+> Minificatie wordt overgeslagen wanneer `optimize` `false` is. Wanneer `editor.enabled` `true` is, blijft het proces wel actief, maar zonder de stap voor het hernoemen van velden — de visuele editor lost bewerkingen op via `keyPath`, dus de originele veldnamen moeten behouden blijven.
 
 > Op Next.js wordt minificatie ook overgeslagen wanneer `@intlayer/swc` niet geïnstalleerd is of niet geladen kan worden (Next.js onder 16.1.0). De plugin is de helft die de broncodetoegangen herschrijft, dus de woordenboeken hernoemen zonder die plugin zou je code veldnamen laten lezen die niet meer bestaan.
 
@@ -508,7 +508,7 @@ export default config;
 { "title": "…", "subtitle": "…" }
 ```
 
-> Purge wordt overgeslagen wanneer `optimize` `false` is of wanneer `editor.enabled` `true` is. Op Next.js wordt het bovendien overgeslagen wanneer `@intlayer/swc` niet beschikbaar is en wanneer compat-adapter-aanroepers geconfigureerd zijn.
+> Purge wordt overgeslagen wanneer `optimize` `false` is. Het blijft actief wanneer `editor.enabled` `true` is — een opgeruimd veld wordt door geen enkele component gelezen, dus de editor rendert het nooit. Op Next.js wordt het bovendien overgeslagen wanneer `@intlayer/swc` niet beschikbaar is en wanneer compat-adapter-aanroepers geconfigureerd zijn.
 
 > Purge wordt ook conservatief overgeslagen wanneer een bronbestand niet geparseerd kan worden, of wanneer het resultaat van `useIntlayer` wordt toegewezen aan een variabele en wordt doorgegeven op manieren die de statische analyzer niet kan volgen (bijv. uitgespreid in een object, doorgegeven als een prop zonder destructuring). In dergelijke gevallen wordt het volledige woordenboek behouden.
 

package/docs/nl/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-08-06
+updatedAt: 2026-08-22
 title: Configuratie (Configuration)
 description: Leer hoe u Intlayer configureert voor uw applicatie. Begrijp de verschillende instellingen en opties die beschikbaar zijn om Intlayer aan uw behoeften aan te passen.
 keywords:
@@ -14,6 +14,9 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 9.3.3
+    date: 2026-08-22
+    changes: "Analytics standaard inschakelen wanneer `@intlayer/analytics` is geïnstalleerd"
   - version: 9.1.3
     date: 2026-08-06
     changes: "`routing.enableProxy` drieledig maken: niet ingesteld (auto), `true`, `false`"
@@ -380,8 +383,8 @@ const config: IntlayerConfig = {
   analytics: {
     /**
      * Of het verzamelen van analytics is ingeschakeld (paginaweergaven, content-exposities, A/B-events).
-     * Vereist dat `editor.clientId` is ingesteld voor attributie.
-     * Standaard: false
+     * Vereist dat `@intlayer/analytics` is geïnstalleerd en dat `editor.clientId` is ingesteld voor attributie.
+     * Standaard: true
      */
     enabled: true,
 
@@ -737,13 +740,13 @@ Definieert de instellingen voor de ingebouwde visuele editor, inclusief de serve
 
 Definieert instellingen voor Intlayer analytics: het verzamelen van welke content daadwerkelijk aan gebruikers wordt getoond (paginaweergaven, content-exposities) en het mogelijk maken van A/B-testen op content.
 
-Analytics is strikt opt-in: er wordt niets verzameld tenzij `analytics.enabled` expliciet is ingesteld op `true` **en** een projectsleutel (`editor.clientId`) is geconfigureerd voor attributie. Wanneer uitgeschakeld (standaard) wordt de volledige analytics-integratie uit uw applicatiebundel verwijderd (dead-code elimination).
+Analytics is opt-out: het staat standaard aan en begint met verzamelen zodra het pakket `@intlayer/analytics` is geïnstalleerd **en** een projectsleutel (`editor.clientId`) is geconfigureerd voor attributie. Zet `analytics.enabled` op `false` — of installeer het pakket niet — en de volledige analytics-integratie wordt uit uw applicatiebundel verwijderd (dead-code elimination).
 
-| Veld            | Beschrijving                                                                                | Type      | Standaard | Voorbeeld | Opmerking                                                                                                                               |
-| --------------- | ------------------------------------------------------------------------------------------- | --------- | --------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------- |
-| `enabled`       | Schakelt het verzamelen van analytics in (paginaweergaven, content-exposities, A/B-events). | `boolean` | `false`   | `true`    | Vereist dat `editor.clientId` is ingesteld voor attributie; anders blijft analytics uitgeschakeld, zelfs als `enabled` op `true` staat. |
-| `flushInterval` | Milliseconden tussen automatische gebundelde verzendingen naar de backend.                  | `number`  | `20000`   | `10000`   |                                                                                                                                         |
-| `sampleRate`    | Fractie van sessies om te registreren, van `0` (geen) tot `1` (alle).                       | `number`  | `1`       | `0.5`     | Sampling is deterministisch per sessie, zodat een geregistreerde sessie al zijn events rapporteert (geen gedeeltelijke funnels).        |
+| Veld            | Beschrijving                                                                                | Type      | Standaard | Voorbeeld | Opmerking                                                                                                                                                                             |
+| --------------- | ------------------------------------------------------------------------------------------- | --------- | --------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `enabled`       | Schakelt het verzamelen van analytics in (paginaweergaven, content-exposities, A/B-events). | `boolean` | `true`    | `false`   | Vereist dat `@intlayer/analytics` is geïnstalleerd en dat `editor.clientId` is ingesteld voor attributie; anders blijft analytics uitgeschakeld, zelfs als `enabled` op `true` staat. |
+| `flushInterval` | Milliseconden tussen automatische gebundelde verzendingen naar de backend.                  | `number`  | `20000`   | `10000`   |                                                                                                                                                                                       |
+| `sampleRate`    | Fractie van sessies om te registreren, van `0` (geen) tot `1` (alle).                       | `number`  | `1`       | `0.5`     | Sampling is deterministisch per sessie, zodat een geregistreerde sessie al zijn events rapporteert (geen gedeeltelijke funnels).                                                      |
 
 ---
 

package/docs/nl/intlayer_with_fastify.md

@@ -222,9 +222,11 @@ import { Locales, type IntlayerConfig } from "intlayer";
 
 const config: IntlayerConfig = {
   // ... Andere configuratie-opties
-  middleware: {
-    headerName: "my-locale-header",
-    cookieName: "my-locale-cookie",
+  routing: {
+    storage: [
+      { type: "header", name: "my-locale-header" },
+      { type: "cookie", name: "my-locale-cookie" },
+    ],
   },
 };
 

package/docs/nl/intlayer_with_hono.md

@@ -235,9 +235,11 @@ import { Locales, type IntlayerConfig } from "intlayer";
 
 const config: IntlayerConfig = {
   // ... Andere configuratie-opties
-  middleware: {
-    headerName: "my-locale-header",
-    cookieName: "my-locale-cookie",
+  routing: {
+    storage: [
+      { type: "header", name: "my-locale-header" },
+      { type: "cookie", name: "my-locale-cookie" },
+    ],
   },
 };
 

package/docs/pl/agent_skills.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2026-02-09
 updatedAt: 2026-03-03
-title: Umiejętności agenta
+title: Agent Skills
 description: Dowiedz się, jak używać Intlayer Agent Skills, aby poprawić zrozumienie Twojego projektu przez agenta AI, w tym kompleksowe przewodniki konfiguracji dla metadanych, map witryn i akcji serwera.
 keywords:
   - Intlayer
@@ -19,13 +19,13 @@ history:
 author: aymericzip
 ---
 
-# Umiejętności agenta
+# Agent Skills
 
 ## Konfiguracja
 
 ### Użycie interfejsu CLI
 
-Polecenie `intlayer init skills` to najprostszy sposób na skonfigurowanie umiejętności agenta w Twoim projekcie. Wykrywa Twoje środowisko i instaluje niezbędne pliki konfiguracyjne dla preferowanych platform.
+Polecenie `intlayer init skills` to najprostszy sposób na skonfigurowanie Agent Skills w Twoim projekcie. Wykrywa Twoje środowisko i instaluje niezbędne pliki konfiguracyjne dla preferowanych platform.
 
 ```bash packageManager="npm"
 npx intlayer init skills
@@ -54,10 +54,10 @@ npx skills add aymericzip/intlayer-skills
 1. Otwórz Paletę Poleceń (Ctrl+Shift+P lub Cmd+Shift+P).
 2. Wpisz `Intlayer: Setup AI Agent Skills`
 3. Wybierz platformę, której używasz (np. `VS Code`, `Cursor`, `Windsurf`, `OpenCode`, `Claude Code`, `GitHub Copilot Workspace` itp.).
-4. Wybierz Umiejętności, które chcesz zainstalować (np. `Next.js`, `React`, `Vite`, `Compiler`, `Configuration`).
+4. Wybierz Agent Skills, które chcesz zainstalować (np. `Next.js`, `React`, `Vite`, `Compiler`, `Configuration`).
 5. Naciśnij Enter.
 
-## Lista umiejętności
+## Lista Agent Skills
 
 **intlayer-config**
 

package/docs/pl/analytics.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-07-08
-updatedAt: 2026-07-08
+updatedAt: 2026-08-22
 title: Intlayer Analytics | Śledzenie ekspozycji treści i testy A/B
 description: Dowiedz się, w jaki sposób @intlayer/analytics śledzi wyświetlenia stron/języków i ekspozycję treści oraz jak z niego korzystać do przeprowadzania testów A/B zawartości Intlayer.
 keywords:
@@ -18,6 +18,9 @@ slugs:
   - concept
   - analytics
 history:
+  - version: 9.3.3
+    date: 2026-08-22
+    changes: "Domyślne włączenie analityki, gdy zainstalowano `@intlayer/analytics`"
   - version: 9.0.0
     date: 2026-07-08
     changes: "Init doc — pakiet @intlayer/analytics, śledzenie na poziomie dostawcy (provider)/węzła (node), testy A/B, dashboard"
@@ -57,7 +60,7 @@ Intlayer pozwala ci już deklarować [Warianty (Variants)](https://github.com/ay
 
 ## Instalacja
 
-`@intlayer/analytics` jest zależnością typu **peer, opcjonalną** — nigdy nie jest instalowana automatycznie przez żaden pakiet frameworku. Dodaj ją obok `intlayer`:
+`@intlayer/analytics` jest **opcjonalną zależnością** każdego pakietu frameworka (`react-intlayer`, `next-intlayer`, `vue-intlayer`, …), więc większość projektów już go ma. Zainstaluj go jawnie, jeśli Twoja konfiguracja pomija zależności opcjonalne (`npm install --no-optional`, …):
 
 ```bash packageManager="npm"
 npm install @intlayer/analytics
@@ -75,11 +78,11 @@ pnpm add @intlayer/analytics
 bun add @intlayer/analytics
 ```
 
-Jeśli nie ją zainstalujesz, każdy punkt integracyjny sprowadza się do pustej operacji (no-op) — zobacz [Zerowy koszt, gdy nie zainstalowano](#zerowy-koszt-gdy-nie-zainstalowano) poniżej.
+Instalacja pakietu to wszystko, czego potrzeba, aby włączyć analitykę: `analytics.enabled` domyślnie wynosi `true`, a `@intlayer/config` ustawia je na `false`, gdy pakietu nie da się znaleźć w projekcie. Jeśli nie ją zainstalujesz, każdy punkt integracyjny sprowadza się do pustej operacji (no-op) — zobacz [Zerowy koszt, gdy nie zainstalowano](#zerowy-koszt-gdy-nie-zainstalowano) poniżej.
 
 ## Konfiguracja
 
-Analytics **wykorzystuje ponownie istniejący blok konfiguracji `editor`** — nie ma osobnego schematu konfiguracyjnego `analytics` do uzupełnienia:
+Analityka nie wymaga żadnej konfiguracji, aby ruszyć: jest **włączona domyślnie** i **wykorzystuje istniejący blok konfiguracji `editor`** jako endpoint i klucz projektu.
 
 ```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import type { IntlayerConfig } from "intlayer";
@@ -100,6 +103,26 @@ export default config;
 
 Jeśli hostujesz sam Intlayer (self-host), analityka automatycznie wskazuje na twoją własną instancję, jako że współdzieli parametr `editor.backendURL`.
 
+### Rezygnacja (opt-out)
+
+Opcjonalny blok `analytics` pozwala dostroić — lub wyłączyć — zbieranie danych:
+
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  analytics: {
+    enabled: false, // Domyślnie: true — usuwa całą integrację z pakietu aplikacji
+    flushInterval: 20_000, // Milisekundy między dwoma zbiorczymi wysyłkami
+    sampleRate: 1, // Ułamek rejestrowanych sesji, od 0 (żadnej) do 1 (wszystkie)
+  },
+};
+
+export default config;
+```
+
+Odinstalowanie `@intlayer/analytics` daje ten sam efekt co `enabled: false`. Pełną listę pól znajdziesz w [dokumentacji konfiguracji](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/configuration.md).
+
 ## Wsparcie dla Frameworków
 
 Analytics jest wpięty w udostępniony `IntlayerProvider` z `react-intlayer`, stąd jest dostępny już dziś w każdym miejscu, w którym ten provider jest używany:
@@ -177,7 +200,7 @@ const variant = client?.getVariant("homepage-hero", [
 `@intlayer/analytics` podąża za tym samym modelem zależności opcjonalnej co `@intlayer/editor`:
 
 - Zawsze paczka dociągana jest dynamicznie w osłonie **`import()` z klauzulą `try/catch`**.
-- Stała wartość dla buildowania (`INTLAYER_ANALYTICS_ENABLED`) redukuje procesowanie w kodzie zjawiskiem **dead-code-eliminate** do momentu skonfigurowania i deklaracji `editor.clientId`.
+- zmienna środowiskowa ustalana w czasie kompilacji (`INTLAYER_ANALYTICS_ENABLED`), automatycznie ustawiana na `'false'` przez `@intlayer/config`, gdy pakiet nie jest zainstalowany, `analytics.enabled` ma wartość `false` lub nie skonfigurowano `editor.clientId`, pozwala bundlerom **usunąć całą integrację jako martwy kod (dead-code-eliminate)**;
 
 ## Dashboard: Strona Analityki
 

package/docs/pl/benchmark/tanstack.md

@@ -194,6 +194,8 @@ Idea stojąca za `Wuchale` jest interesująca, ale nie jest to jeszcze opłacaln
 
 `Tolgee` rozwiązuje wiele z wymienionych wcześniej problemów. Uznałem jednak, że trudniej z nim zacząć niż z innymi narzędziami o podobnym podejściu. Nie zapewnia on bezpieczeństwa typów, co sprawia, że bardzo trudno jest wyłapać brakujące klucze w czasie kompilacji. Musiałem opakować API Tolgee we własne API, aby dodać wykrywanie brakujących kluczy.
 
+Package jest dość ciężki (~11.1kb, co jest ponad 2× większe niż `react-intlayer`).
+
 W TanStack Start miałem również problemy z reaktywnością: przy zmianie lokalizacji musiałem wymusić ponowne renderowanie dostawcy i zasubskrybować zdarzenia zmiany lokalizacji, aby ładowanie w innym języku zachowywało się poprawnie.
 
 **(use-intl)** (`use-intl@4.9.1`):
@@ -208,6 +210,8 @@ W TanStack Start unikasz pułapek specyficznych dla Next.js (`setRequestLocale`,
 
 Mimo to ma on te same główne wady co stosy zbudowane na `t('a.b.c')`: optymalizacje są możliwe, ale bardzo czasochłonne, a duże projekty niosą ze sobą ryzyko wpadnięcia w złe praktyki (przestrzenie nazw + ładowanie dynamiczne + typy).
 
+Pakiet jest szczególnie ciężki (~17.3kb, co stanowi około 3.5× `react-intlayer`).
+
 Różnią się również formaty komunikatów: `use-intl` używa ICU MessageFormat, podczas gdy `i18next` używa własnego formatu - co komplikuje narzędzia lub migracje, jeśli się je miesza.
 
 **(Lingui)** (`@lingui/core@5.3.0`):
@@ -218,6 +222,8 @@ Różnią się również formaty komunikatów: `use-intl` używa ICU MessageForm
 
 `react-intl` to wydajna implementacja zespołu Format.js. DX pozostaje rozwlekły: `const intl = useIntl()` + `intl.formatMessage({ id: "xx.xx" })` dodaje złożoność, dodatkową pracę JavaScript i wiąże globalną instancję i18n z wieloma węzłami w drzewie React.
 
+Package jest również ciężki (~14.4kb, co stanowi około 3× `react-intlayer`).
+
 ### 4 - Rekomendacje
 
 Ten benchmark TanStack Start nie ma bezpośredniego odpowiednika `next-translate` (wtyczka Next.js + `getStaticProps`). Dla zespołów, które naprawdę chcą API `t()` z dojrzałym ekosystemem, `react-i18next` i `use-intl` pozostają „rozsądnymi” wyborami, ale przygotuj się na zainwestowanie dużej ilości czasu w optymalizację, aby uniknąć wycieków.

package/docs/pl/bundle_optimization.md

@@ -476,7 +476,7 @@ const config: IntlayerConfig = {
 export default config;
 ```
 
-> Krok dla minifikacji musi zostać oddalony w odstawkę, gdy Twoja opcja to `optimize` lub jeżeli udostępniasz systemowo `editor.enabled` i ustawiasz na domyślne `true` (wymuszone jest, aby pola trzymały na ten czas swe niezmącone relacje, dla potrzeb odpowiedniego renderowania Wizualnego Edytora).
+> Minifikacja jest pomijana, gdy `optimize` ma wartość `false`. Gdy `editor.enabled` ma wartość `true`, nadal działa, ale bez etapu zmiany nazw pól — wizualny edytor odwzorowuje edycje za pomocą `keyPath`, więc oryginalne nazwy pól muszą zostać zachowane.
 
 > W Next.js minifikacja jest również pomijana, gdy `@intlayer/swc` nie jest zainstalowany albo nie może zostać załadowany (Next.js poniżej 16.1.0). Wtyczka to ta połowa, która przepisuje odwołania w kodzie źródłowym, więc zmiana nazw w słownikach bez niej pozostawiłaby kod odczytujący nazwy pól, które już nie istnieją.
 
@@ -508,7 +508,7 @@ export default config;
 { "title": "…", "subtitle": "…" }
 ```
 
-> Mechanizm obalenia Purge opiera się głównie o pominięcia w wypadku kiedy brakuje `optimize` opcjonalnej flagi tudzież podczas zadeklarowania trybu pod system Visual Editor (ustawiając `editor.enabled` na rzecz trybu `true`). W Next.js jest dodatkowo pomijany, gdy `@intlayer/swc` jest niedostępny oraz gdy skonfigurowano wywołujących z adapterów kompatybilności.
+> Purge jest pomijany, gdy `optimize` ma wartość `false`. Pozostaje aktywny, gdy `editor.enabled` ma wartość `true` — usunięte pole nie jest odczytywane przez żaden komponent, więc edytor nigdy go nie renderuje. W Next.js jest dodatkowo pomijany, gdy `@intlayer/swc` jest niedostępny oraz gdy skonfigurowano wywołujących z adapterów kompatybilności.
 
 > Co rzadsze zjawiska również tyczą się tego obejścia - dla niemożności sprawdzenia wycinka czy pospolitych struktur dla `useIntlayer` - silnik bezbłędnie zablokuje akcję. Przykładowo dla wywołań w niejednoznacznych tablicach powiązanych metod bez destrukturyzacji by zachować słownikową formę naturalną.
 

package/docs/pl/cli/ci.md

@@ -128,6 +128,8 @@ bun x intlayer ci fill --verbose --mode complete
 
 ### Użycie w pipeline'ach CI/CD
 
+Uruchomienie `intlayer init` generuje dla Ciebie dwa gotowe do użycia workflow GitHub Actions (zobacz [Scaffolded GitHub Actions](#scaffolded-github-actions) poniżej). Poniższy przykład pokazuje równoważną konfigurację przy użyciu polecenia `ci` dla monorepo, gdzie credentials są wstrzykiwane na projekt z `INTLAYER_PROJECT_CREDENTIALS`.
+
 W konfiguracji CI/CD (np. GitHub Actions, GitLab CI) ustaw `INTLAYER_PROJECT_CREDENTIALS` jako sekret:
 
 ```yaml

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

@@ -91,7 +91,15 @@ W większości przypadków,
 
 - **`--log`**: Tryb tylko logowania. Nie tłumaczy za pomocą AI; zamiast tego loguje bloki wymagające uwagi (wraz z numerami linii i zawartością) dla bazowych i docelowych lokalizacji, aby pomóc innemu agentowi w wygenerowaniu tłumaczeń.
 
-  > Przykład: `npx intlayer doc review --log`
+1. **`apply`** - Translate diverging blocks and output the complete updated Polish file
+2. **`report`** - Log blocks needing attention with line numbers for both base (en) and target (pl) locales without calling AI
+3. **`synthesis`** - Skip per-block output and only provide a final recap of which documents are up-to-date and which need edits
+
+> Przykład: `npx intlayer doc review --mode report`
+
+> Przykład: `npx intlayer doc review --log`
+
+Niezależnie od trybu, uruchomienie kończy się synteezą zawierającą listę dokumentów, które są wyrównane z dokumentem bazowym, oraz te, które nadal mają bloki do edycji.
 
 **Opcje wyjścia wpisu:**
 

package/docs/pl/cli/fill.md

@@ -39,14 +39,6 @@ bun x intlayer fill
 
 To polecenie analizuje Twoje pliki deklaracji treści pod kątem potencjalnych problemów, takich jak brakujące tłumaczenia, niespójności strukturalne lub niezgodności typów. Jeśli wykryje jakiekolwiek problemy, **intlayer fill** zaproponuje lub zastosuje aktualizacje, aby utrzymać Twoje słowniki spójne i kompletne.
 
-Kluczowe punkty:
-
-- Dzieli duże pliki JSON na fragmenty, aby pozostać w granicach okna kontekstowego modelu AI.
-- Ponawia tłumaczenie, jeśli format wyjściowy jest nieprawidłowy.
-- Włącza kontekst specyficzny dla aplikacji i pliku, aby poprawić dokładność tłumaczenia.
-- Zachowuje istniejące tłumaczenia, nie nadpisując ich.
-- Przetwarza pliki, fragmenty i lokalizacje równolegle przy użyciu systemu kolejkowego, aby zwiększyć prędkość.
-
 ## Kluczowe punkty:
 
 - Dzieli duże pliki JSON na fragmenty, aby pozostać w granicach kontekstu modelu AI.

package/docs/pl/cli/index.md

@@ -127,6 +127,8 @@ Aby dowiedzieć się, jak skonfigurować dostępne języki lub inne parametry, z
 
 - **[Zaloguj](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/cli/login.md)** - Uwierzytelnij się w Intlayer CMS i uzyskaj dane dostępu
 
+> `intlayer login` wydaje **klucz dostępu** (`clientId` / `clientSecret`), który jest używany przez każde polecenie wymagające uwierzytelnienia. Sekret jest poświadczeniem po stronie serwera i nigdy nie trafia do Twojego pakietu klienta — zobacz [Keeping the access key safe](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/cli/login.md#keeping-the-access-key-safe).
+
 ### Polecenia Podstawowe
 
 - **[Buduj Słowniki](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/cli/build.md)** - Zbuduj swoje słowniki z plików deklaracji treści

package/docs/pl/cli/list_projects.md

@@ -52,8 +52,6 @@ To polecenie przeszukuje i wypisuje wszystkie projekty Intlayer, znajdując kata
 
   > Przykład: `npx intlayer projects list --base-dir /path/to/workspace`
 
-  > Przykład: `npx intlayer projects list --base-dir /path/to/workspace`
-
 - **`--git-root`**: Wyszukaj od katalogu głównego gita zamiast od katalogu bazowego. Przydaje się do odnalezienia wszystkich projektów Intlayer w monorepo lub repozytorium git.
 
   > Przykład: `npx intlayer projects list --git-root`

package/docs/pl/cli/login.md

@@ -122,6 +122,34 @@ INTLAYER_CLIENT_SECRET=your_client_secret
 }
 ```
 
+## Bezpieczeństwo klucza dostępu
+
+`intlayer login` wydaje **klucz dostępu**: parę `clientId` / `clientSecret`, którą każde polecenie wymagające uwierzytelnienia (`push`, `pull`, `fill`, `configuration push`, `live`, …) wykorzystuje do autentykacji.
+
+```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` to poświadczenie po stronie serwera.** Przyznaje pełny dostęp do API na poziomie projektu — czytanie i pisanie słowników, projektu i organizacji. Przechowuj go w `.env` (ignorowany przez git) lub w magazynie wpisów tajnych CI, nigdy nie umieszczaj go w pliku konfiguracyjnym.
+
+Intlayer wymusza to zamiast tylko tego dokumentować:
+
+- `clientSecret` jest **usuwany z konfiguracji, którą bundler встраивает**, więc nie może dotrzeć do bundle'a przeglądarki niezależnie od używanej integracji frameworka. Jest odczytywany tylko po stronie serwera, w czasie wykonania, ze środowiska.
+- `clientId` jest inny: to **publiczny** klucz projektu, bezpieczny do wysyłki i używany przez [`@intlayer/analytics`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/analytics.md#how-events-are-authenticated) do uzyskania krótkotrwałego tokenu tylko do pozyskiwania danych.
+
+Zakomentowanie `clientId` wystarczy, aby wyłączyć każde zachowanie wymagające uwierzytelnienia — pobieranie słowników zdalnych, dostęp do CMS, analizę — nawet gdy zmienne środowiskowe są jeszcze zdefiniowane.
+
+W przypadku potoków CI preferuj [`ci` command](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/cli/ci.md), który wstrzykuje poświadczenia na czas pojedynczego uruchomienia zamiast ich utrwalania.
+
 ## Ręczna konfiguracja
 
 Jeśli przeglądarka nie otworzy się automatycznie, możesz ręcznie odwiedzić URL wyświetlony w terminalu.

package/docs/pl/cli/watch.md

@@ -48,5 +48,3 @@ Ta komenda jest równoważna z `npx intlayer build --watch --skip-prepare`.
 - **`--with`**: Uruchom komendę równolegle z obserwacją.
 
   > Przykład: `npx intlayer watch --with "next dev --turbopack"`
-
-  > Przykład: `npx intlayer watch --with "next dev --turbopack"`

package/docs/pl/compiler.md

@@ -40,6 +40,12 @@ author: aymericzip
 
 ## Dlaczego warto używać Intlayer Compiler?
 
+- **Automation**: Eliminates manual copy-pasting of content into dictionaries.
+
+- **Speed**: Zoptymalizowana ekstrakcja treści zapewniająca szybki proces budowania.
+
+- **Developer Experience**: Trzymaj deklaracje zawartości tam, gdzie są używane, poprawiając łatwość utrzymania.
+
 - **Automatyzacja**: Eliminuje ręczne kopiowanie i wklejanie treści do słowników.
 - **Szybkość**: Optymalizowane wydobywanie treści zapewnia szybki proces budowania.
 - **Doświadczenie programisty**: Zachowaj deklaracje treści dokładnie tam, gdzie są używane, co poprawia utrzymanie kodu.
@@ -54,12 +60,16 @@ Chociaż kompilator oferuje doskonałe doświadczenie "działa od razu", wprowad
 - **Niejednoznaczność heurystyczna**: Kompilator musi zgadywać, co jest treścią skierowaną do użytkownika, a co logiką aplikacji (np. `className="active"`, kody statusu, ID produktów). W złożonych bazach kodu może to prowadzić do fałszywych pozytywów lub pominiętych ciągów znaków, które wymagają ręcznych adnotacji i wyjątków.
 - **Tylko statyczna ekstrakcja**: Ekstrakcja oparta na kompilatorze opiera się na analizie statycznej. Ciągi znaków, które istnieją tylko w czasie wykonywania (kody błędów API, pola CMS itp.), nie mogą być odkryte ani przetłumaczone przez sam kompilator, więc nadal potrzebujesz uzupełniającej strategii i18n czasu wykonywania.
 
+- **Ekstrakcja tylko statyczna**: Ekstrakcja oparta na kompilatorze polega na analizie statycznej. Ciągi znaków, które istnieją tylko w czasie wykonywania (kody błędów API, pola CMS itp.), nie mogą być odkryte ani przetłumaczone przez sam kompilator, dlatego nadal potrzebujesz dodatkowej strategii i18n w czasie wykonywania.
+
 Aby uzyskać głębsze porównanie architektoniczne, zobacz wpis na blogu [Compiler vs. Declarative i18n](https://github.com/aymericzip/intlayer/blob/main/docs/blog/pl/compiler_vs_declarative_i18n.md).
 
 Jako alternatywę, aby zautomatyzować proces i18n przy zachowaniu pełnej kontroli nad treścią, Intlayer zapewnia również polecenie auto-ekstrakcji `intlayer extract` (zobacz [dokumentację CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/cli/extract.md)) lub polecenie `Intlayer: extract content to Dictionary` z rozszerzenia Intlayer VS Code (zobacz [dokumentację rozszerzenia VS Code](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/vs_code_extension.md)).
 
 ## Użycie
 
+> Najszybszym sposobem na podłączenie compilera jest interaktywna konfiguracja: uruchom `npx intlayer init --interactive` i wybierz **Compiler**. Na Vite nie ma nic do konfiguracji — compiler jest podłączony bezpośrednio przez główny plugin `intlayer()` (aktywuje się automatycznie, gdy `compiler.enabled` jest ustawiony i ścieżka `compiler.output` jest skonfigurowana). Na Next.js polecenie generuje plik `babel.config.js` pokazany poniżej. Nieinteraktywne `intlayer init` pozostawia konfigurację compilera bez zmian.
+
 <Tabs>
  <Tab value='vite'>
 
@@ -92,12 +102,18 @@ export default defineConfig({
 });
 ```
 
+> Standalone plugin `intlayerCompiler()` jest nadal eksportowany dla zaawansowanych konfiguracji. Rejestrowanie go obok `intlayer()` jest bezpieczne — compiler deduplikuje się i uruchamia tylko raz.
+
 See complete tutorial: [Intlayer Compiler with Vite+React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_vite+react_compiler.md)
 
 #### Wsparcie dla frameworków
 
 Wtyczka Vite automatycznie wykrywa i obsługuje różne typy plików:
 
+- **React / JSX / TSX**: Obsługiwane natywnie.
+
+- **Vue**: Wymaga `@intlayer/vue-compiler`.
+
 - **React / JSX / TSX**: Obsługiwane natywnie.
 - **Vue**: Wymaga `@intlayer/vue-compiler`.
 - **Svelte**: Wymaga `@intlayer/svelte-compiler`.