@intlayer/docs 9.0.0-canary.15 → 9.0.0-canary.17

package/docs/pl/intlayer_CMS.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-08-23
-updatedAt: 2026-06-30
+updatedAt: 2026-07-08
 title: Intlayer CMS | Zewnętrzne zarządzanie treścią w Intlayer CMS
 description: Zewnętrzne zarządzanie treścią w Intlayer CMS, aby delegować zarządzanie treścią do Twojego zespołu.
 keywords:
@@ -18,6 +18,9 @@ slugs:
   - cms
 youtubeVideo: https://www.youtube.com/watch?v=UDDTnirwi_4
 history:
+  - version: 9.0.0
+    date: 2026-07-08
+    changes: "Przeniesiono sekcję „Synchronizacja na żywo” na osobną stronę (live-sync.md), pozostawiając tu krótkie wprowadzenie i link"
   - version: 9.0.0
     date: 2026-06-30
     changes: "Dodano sekcję samodzielnego hostowania"
@@ -248,144 +251,7 @@ Następnie będziesz mógł zobaczyć i zarządzać swoim słownikiem w [Intlaye
 
 Synchronizacja na żywo pozwala Twojej aplikacji odzwierciedlać zmiany treści CMS w czasie rzeczywistym. Nie jest wymagane ponowne budowanie ani wdrażanie. Po włączeniu aktualizacje są przesyłane do serwera synchronizacji na żywo, który odświeża słowniki odczytywane przez Twoją aplikację.
 
-Włącz synchronizację na żywo, aktualizując konfigurację Intlayer:
-
-```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
-import type { IntlayerConfig } from "intlayer";
-
-const config: IntlayerConfig = {
-  // ... inne ustawienia konfiguracyjne
-  editor: {
-    /**
-     * Włącza hot reloading konfiguracji lokalizacji, gdy wykryte zostaną zmiany.
-     * Na przykład, gdy słownik zostanie dodany lub zaktualizowany, aplikacja aktualizuje
-     * wyświetlaną na stronie zawartość.
-     *
-     * Ponieważ hot reloading wymaga ciągłego połączenia z serwerem,
-     * jest dostępny tylko dla klientów planu `enterprise`.
-     *
-     * Domyślnie: false
-     */
-    liveSync: true,
-  },
-  dictionary: {
-    /**
-     * Kontroluje sposób importowania słowników:
-     *
-     * - "live": Słowniki są pobierane dynamicznie za pomocą API Live Sync.
-     *   Zastępuje useIntlayer funkcją useDictionaryDynamic.
-     *
-     * Uwaga: Tryb live korzysta z API Live Sync do pobierania słowników. Jeśli wywołanie API
-     * zakończy się niepowodzeniem, słowniki są importowane dynamicznie.
-     * Uwaga: Tryb live jest używany tylko dla słowników zdalnych i oznaczonych flagą "live".
-     * Pozostałe używają trybu dynamicznego dla wydajności.
-     */
-    importMode: "fetch",
-  },
-};
-
-export default config;
-```
-
-Uruchom serwer Live Sync, aby otoczyć swoją aplikację:
-
-Przykład użycia samodzielnego serwera:
-
-```json5 fileName="package.json"
-{
-  "scripts": {
-    // ... inne skrypty
-    "live:start": "npx intlayer live",
-  },
-}
-```
-
-Możesz również używać swojego serwera aplikacji równolegle, korzystając z argumentu `--process`.
-
-Przykład użycia Next.js:
-
-```json5 fileName="package.json"
-{
-  "scripts": {
-    // ... inne skrypty
-    "build": "next build",
-    "dev": "next dev",
-    "start": "npx intlayer live --with 'next start'",
-  },
-}
-```
-
-Przykład użycia Vite:
-
-```json5 fileName="package.json"
-{
-  "scripts": {
-    // ... inne skrypty
-    "build": "vite build",
-    "dev": "vite dev",
-    "start": "npx intlayer live --with 'vite start'",
-  },
-}
-```
-
-Serwer Live Sync otacza Twoją aplikację i automatycznie stosuje zaktualizowaną zawartość w momencie jej pojawienia się.
-
-Aby otrzymywać powiadomienia o zmianach z CMS, serwer Live Sync utrzymuje połączenie SSE z backendem. Gdy zawartość w CMS ulega zmianie, backend przekazuje aktualizację do serwera Live Sync, który zapisuje nowe słowniki. Twoja aplikacja odzwierciedli aktualizację przy następnej nawigacji lub przeładowaniu przeglądarki, nie jest wymagane ponowne budowanie.
-
-Schemat przepływu (CMS/Backend -> Serwer Live Sync -> Serwer aplikacji -> Frontend):
-
-![Schemat przepływu Live Sync CMS/Backend/Serwer Live Sync/Serwer aplikacji/Frontend](https://github.com/aymericzip/intlayer/blob/main/docs/assets/live_sync_flow_scema.svg)
-
-Jak to działa:
-
-![Schemat logiki Live Sync](https://github.com/aymericzip/intlayer/blob/main/docs/assets/live_sync_logic_schema.svg)
-
-### Przebieg pracy podczas developmentu (lokalnie)
-
-- Podczas developmentu wszystkie zdalne słowniki są pobierane przy starcie aplikacji, dzięki czemu możesz szybko testować aktualizacje.
-- Aby przetestować Live Sync lokalnie z Next.js, opakuj swój serwer deweloperski:
-
-```json5 fileName="package.json"
-{
-  "scripts": {
-    // ... inne skrypty
-    "dev": "npx intlayer live --with 'next dev'",
-    // "dev": "npx intlayer live --with 'vite dev'", // Dla Vite
-  },
-}
-```
-
-Włącz optymalizację, aby Intlayer stosował transformacje importu Live podczas developmentu:
-
-```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
-import type { IntlayerConfig } from "intlayer";
-
-const config: IntlayerConfig = {
-  editor: {
-    applicationURL: "http://localhost:5173",
-    liveSyncURL: "http://localhost:4000",
-    liveSync: true,
-  },
-  dictionary: {
-    importMode: "fetch",
-  },
-  build: {
-    optimize: true,
-  },
-};
-
-export default config;
-```
-
-To ustawienie owija Twój serwer deweloperski serwerem Live Sync, pobiera zdalne słowniki podczas uruchamiania i przesyła aktualizacje z CMS za pomocą SSE. Odśwież stronę, aby zobaczyć zmiany.
-
-Uwagi i ograniczenia:
-
-- Dodaj pochodzenie live sync do polityki bezpieczeństwa swojej strony (CSP). Upewnij się, że adres URL live sync jest dozwolony w `connect-src` (oraz `frame-ancestors`, jeśli ma to zastosowanie).
-- Live Sync nie działa ze statycznym outputem. W Next.js strona musi być dynamiczna, aby otrzymywać aktualizacje w czasie wykonywania (np. użyj `generateStaticParams`, `generateMetadata`, `getServerSideProps` lub `getStaticProps` odpowiednio, aby uniknąć pełnych ograniczeń statycznych).
-- W CMS każdy słownik ma flagę `live`. Tylko słowniki z `live=true` są pobierane przez API live sync; pozostałe są importowane dynamicznie i pozostają niezmienione w czasie wykonywania.
-- Flaga `live` jest oceniana dla każdego słownika podczas budowania (build time). Jeśli zdalna zawartość nie była oznaczona jako `live=true` podczas budowania (build time), musisz przebudować projekt, aby włączyć Live Sync dla tego słownika.
-- Serwer live sync musi mieć możliwość zapisu do `.intlayer`. W kontenerach upewnij się, że masz dostęp do zapisu do `/.intlayer`.
+Pełny przewodnik po konfiguracji (włączanie, uruchamianie serwera Live Sync, lokalny przepływ pracy programistycznej i ograniczenia) znajdziesz w [dokumentacji Live Sync](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/live-sync.md).
 
 ## Samodzielne hostowanie (Self-Hosting)
 

package/docs/pl/live-sync.md

@@ -0,0 +1,185 @@
+---
+createdAt: 2026-07-08
+updatedAt: 2026-07-08
+title: Synchronizacja na żywo | Odzwierciedlaj zmiany treści CMS w czasie rzeczywistym
+description: Pozwól swojej aplikacji odzwierciedlać zmiany treści w Intlayer CMS w czasie działania, bez konieczności przebudowy czy ponownego wdrożenia.
+keywords:
+  - Synchronizacja na żywo
+  - Live Sync
+  - CMS
+  - Edytor Wizualny
+  - Internacjonalizacja
+  - Dokumentacja
+  - Intlayer
+  - Next.js
+  - Vite
+history:
+  - version: 9.0.0
+    date: 2026-07-08
+    changes: "Przeniesiono z dokumentacji Intlayer CMS na osobną stronę"
+  - version: 6.0.1
+    date: 2025-09-22
+    changes: "Dodano dokumentację synchronizacji na żywo"
+  - version: 6.0.0
+    date: 2025-09-04
+    changes: "Zastąpiono pole `hotReload` polem `liveSync`"
+author: aymericzip
+---
+
+# Synchronizacja na żywo
+
+Synchronizacja na żywo pozwala Twojej aplikacji odzwierciedlać zmiany treści CMS w czasie rzeczywistym. Nie jest wymagane ponowne budowanie ani wdrażanie. Po włączeniu aktualizacje są przesyłane do serwera synchronizacji na żywo, który odświeża słowniki odczytywane przez Twoją aplikację.
+
+## Spis treści
+
+<TOC/>
+
+---
+
+## Włączanie synchronizacji na żywo
+
+Włącz synchronizację na żywo, aktualizując konfigurację Intlayer:
+
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  // ... inne ustawienia konfiguracyjne
+  editor: {
+    /**
+     * Włącza hot reloading konfiguracji lokalizacji, gdy wykryte zostaną zmiany.
+     * Na przykład, gdy słownik zostanie dodany lub zaktualizowany, aplikacja aktualizuje
+     * wyświetlaną na stronie zawartość.
+     *
+     * Ponieważ hot reloading wymaga ciągłego połączenia z serwerem,
+     * jest dostępny tylko dla klientów planu `enterprise`.
+     *
+     * Domyślnie: false
+     */
+    liveSync: true,
+  },
+  dictionary: {
+    /**
+     * Kontroluje sposób importowania słowników:
+     *
+     * - "live": Słowniki są pobierane dynamicznie za pomocą API Live Sync.
+     *   Zastępuje useIntlayer funkcją useDictionaryDynamic.
+     *
+     * Uwaga: Tryb live korzysta z API Live Sync do pobierania słowników. Jeśli wywołanie API
+     * zakończy się niepowodzeniem, słowniki są importowane dynamicznie.
+     * Uwaga: Tryb live jest używany tylko dla słowników zdalnych i oznaczonych flagą "live".
+     * Pozostałe używają trybu dynamicznego dla wydajności.
+     */
+    importMode: "fetch",
+  },
+};
+
+export default config;
+```
+
+Uruchom serwer Live Sync, aby otoczyć swoją aplikację:
+
+Przykład użycia samodzielnego serwera:
+
+```json5 fileName="package.json"
+{
+  "scripts": {
+    // ... inne skrypty
+    "live:start": "npx intlayer live",
+  },
+}
+```
+
+Możesz również używać swojego serwera aplikacji równolegle, korzystając z argumentu `--process`.
+
+Przykład użycia Next.js:
+
+```json5 fileName="package.json"
+{
+  "scripts": {
+    // ... inne skrypty
+    "build": "next build",
+    "dev": "next dev",
+    "start": "npx intlayer live --with 'next start'",
+  },
+}
+```
+
+Przykład użycia Vite:
+
+```json5 fileName="package.json"
+{
+  "scripts": {
+    // ... inne skrypty
+    "build": "vite build",
+    "dev": "vite dev",
+    "start": "npx intlayer live --with 'vite start'",
+  },
+}
+```
+
+Serwer Live Sync otacza Twoją aplikację i automatycznie stosuje zaktualizowaną zawartość w momencie jej pojawienia się.
+
+Aby otrzymywać powiadomienia o zmianach z CMS, serwer Live Sync utrzymuje połączenie SSE z backendem. Gdy zawartość w CMS ulega zmianie, backend przekazuje aktualizację do serwera Live Sync, który zapisuje nowe słowniki. Twoja aplikacja odzwierciedli aktualizację przy następnej nawigacji lub przeładowaniu przeglądarki, nie jest wymagane ponowne budowanie.
+
+Schemat przepływu (CMS/Backend -> Serwer Live Sync -> Serwer aplikacji -> Frontend):
+
+![Schemat przepływu Live Sync CMS/Backend/Serwer Live Sync/Serwer aplikacji/Frontend](https://github.com/aymericzip/intlayer/blob/main/docs/assets/live_sync_flow_scema.svg)
+
+Jak to działa:
+
+![Schemat logiki Live Sync](https://github.com/aymericzip/intlayer/blob/main/docs/assets/live_sync_logic_schema.svg)
+
+## Przebieg pracy podczas developmentu (lokalnie)
+
+- Podczas developmentu wszystkie zdalne słowniki są pobierane przy starcie aplikacji, dzięki czemu możesz szybko testować aktualizacje.
+- Aby przetestować Live Sync lokalnie z Next.js, opakuj swój serwer deweloperski:
+
+```json5 fileName="package.json"
+{
+  "scripts": {
+    // ... inne skrypty
+    "dev": "npx intlayer live --with 'next dev'",
+    // "dev": "npx intlayer live --with 'vite dev'", // Dla Vite
+  },
+}
+```
+
+Włącz optymalizację, aby Intlayer stosował transformacje importu Live podczas developmentu:
+
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  editor: {
+    applicationURL: "http://localhost:5173",
+    liveSyncURL: "http://localhost:4000",
+    liveSync: true,
+  },
+  dictionary: {
+    importMode: "fetch",
+  },
+  build: {
+    optimize: true,
+  },
+};
+
+export default config;
+```
+
+To ustawienie owija Twój serwer deweloperski serwerem Live Sync, pobiera zdalne słowniki podczas uruchamiania i przesyła aktualizacje z CMS za pomocą SSE. Odśwież stronę, aby zobaczyć zmiany.
+
+## Uwagi i ograniczenia
+
+- Dodaj pochodzenie live sync do polityki bezpieczeństwa swojej strony (CSP). Upewnij się, że adres URL live sync jest dozwolony w `connect-src` (oraz `frame-ancestors`, jeśli ma to zastosowanie).
+- Live Sync nie działa ze statycznym outputem. W Next.js strona musi być dynamiczna, aby otrzymywać aktualizacje w czasie wykonywania (np. użyj `generateStaticParams`, `generateMetadata`, `getServerSideProps` lub `getStaticProps` odpowiednio, aby uniknąć pełnych ograniczeń statycznych).
+- W CMS każdy słownik ma flagę `live`. Tylko słowniki z `live=true` są pobierane przez API live sync; pozostałe są importowane dynamicznie i pozostają niezmienione w czasie wykonywania.
+- Flaga `live` jest oceniana dla każdego słownika podczas budowania (build time). Jeśli zdalna zawartość nie była oznaczona jako `live=true` podczas budowania (build time), musisz przebudować projekt, aby włączyć Live Sync dla tego słownika.
+- Serwer live sync musi mieć możliwość zapisu do `.intlayer`. W kontenerach upewnij się, że masz dostęp do zapisu do `/.intlayer`.
+
+## Przydatne linki
+
+- [Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_CMS.md)
+- [Edytor Wizualny Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_visual_editor.md)
+- [Dokumentacja konfiguracji](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/configuration.md)
+- [Przewodnik po samodzielnym hostowaniu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/self_hosting.md)

package/docs/pl/releases/v9.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-06-14
-updatedAt: 2026-06-30
+updatedAt: 2026-07-08
 title: Nowy Intlayer v9 - Co nowego?
 description: Odkryj nowości w Intlayer v9. Przedstawiamy pakiety kompatybilności typu drop-in dla popularnych bibliotek i18n oraz wsparcie dla Kolekcji (Collections) i Wariantów (Variants).
 keywords:
@@ -204,6 +204,49 @@ const product = useIntlayer("product-copy", {
 
 ---
 
+## `@intlayer/analytics`: śledzenie ekspozycji treści i testy A/B
+
+Nowy opcjonalny pakiet, [`@intlayer/analytics`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md), pokazuje, jakie treści są faktycznie wyświetlane Twoim odwiedzającym — i domyka pętlę z **Collections & Variants**, umożliwiając testowanie treści A/B i mierzenie konwersji dla każdego wariantu.
+
+- **Śledzenie na poziomie providera**: `IntlayerProvider` (React / Next.js / React Native) automatycznie rejestruje zdarzenia `page_view` przy ładowaniu, zmianie trasy i zmianie języka.
+- **Śledzenie na poziomie węzła**: każde rozwiązanie `useIntlayer` zgłasza zdarzenie `content_exposure` — jaki klucz słownika, ścieżka klucza, język i (jeśli dotyczy) jaki **wariant** A/B został wyświetlony. Powtarzające się ekspozycje tego samego węzła w oknie wysyłki są łączone w jedno zdarzenie.
+- **Deterministyczne przypisanie A/B**: `getVariant(experimentKey, variants)` przypisuje wariant każdej sesji **bez komunikacji z serwerem**, dzięki czemu nie ma migotania przed pierwszym renderowaniem.
+- **`useConversion()`**: przypisuje cel (rejestracja, kliknięcie, zakup…) do wariantu, na który była wystawiona sesja.
+- **Zerowy koszt, gdy nie zainstalowano**: ten sam wzorzec tree-shakeable co `@intlayer/editor` — dynamiczny `import()` opakowany w `try/catch`, plus zmienna środowiskowa czasu kompilacji (`INTLAYER_ANALYTICS_ENABLED`), która całkowicie usuwa integrację z bundla dla aplikacji, które jej nie włączają.
+- **Bez nowego schematu konfiguracji**: ponownie wykorzystuje `editor.backendURL` (punkt końcowy wysyłki / self-hosting) i `editor.clientId` (klucz projektu, będący jednocześnie przełącznikiem włączania).
+- **Dbałość o prywatność**: anonimowe hashowanie sesji (SHA-256, bez przechowywania surowych identyfikatorów), brak przechowywania adresów IP, tylko przybliżona geolokalizacja na poziomie kraju, żądania wysyłane partiami mniej więcej co 20 sekund.
+- **Panel**: nowa strona **Analytics** (widoczna na pasku bocznym po wybraniu projektu) pokazuje aktywnych użytkowników, użytkowników dzisiaj, użytkowników z ostatnich 7/30/90 dni, wykres ewolucji odwiedzających oraz podział według języka i lokalizacji.
+
+```tsx fileName="CTAButton.tsx" codeFormat="tsx"
+import { useConversion } from "react-intlayer";
+
+const CTAButton = () => {
+  const trackConversion = useConversion();
+
+  return (
+    <button
+      onClick={() =>
+        trackConversion({
+          experimentKey: "homepage-hero",
+          variant: "black_friday",
+          goal: "cta_click",
+        })
+      }
+    >
+      Get started
+    </button>
+  );
+};
+```
+
+```bash packageManager="npm"
+npm install @intlayer/analytics
+```
+
+Dostępne już dziś dla React, Next.js i React Native (poprzez `react-intlayer`); inne wiązania frameworków (Vue, Svelte, Angular, …) są planowane, zgodnie z tym samym wzorcem wdrażania co `@intlayer/editor`. Pełny przewodnik znajdziesz w [dokumentacji Analytics](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md).
+
+---
+
 ## Vite Plugin: Bundled Compiler & Proxy
 
 Plugin Vite `intlayer()` teraz łączy **kompilator** i **proxy do routingu locale'ów** bezpośrednio, więc większość projektów potrzebuje tylko jednej wtyczki w `vite.config.ts`:
@@ -350,6 +393,7 @@ Jeśli aktualizujesz aplikację z wersji v8, pamiętaj, że wersja v9 nie zawier
 
 - [Przewodnik po pakietach kompatybilności (Compat Adapter Packages)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/compat/index.md)
 - [Dynamiczne słowniki - Kolekcje i Warianty](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dynamic_dictionaries/index.md)
+- [Analytics - Śledzenie ekspozycji treści i testy A/B](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md)
 - [Dokumentacja konfiguracji](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/configuration.md)
 - [SDK CMS - Programowy dostęp z @intlayer/api](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_CMS.md)
 - [Przewodnik po samodzielnym hostowaniu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/self_hosting.md)

package/docs/pt/cli/index.md

@@ -125,7 +125,7 @@ Para ver como configurar os idiomas disponíveis ou outros parâmetros, consulte
 
 ### Autenticação
 
-- **[Login](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/login.md)** - Autentique-se no Intlayer CMS e obtenha credenciais de acesso
+- **[Login](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/cli/login.md)** - Autentique-se no Intlayer CMS e obtenha credenciais de acesso
 
 ### Comandos Principais
 

package/docs/pt/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-06-17
+updatedAt: 2026-07-11
 title: Configuração (Configuration)
 description: Saiba como configurar o Intlayer para a sua aplicação. Entenda as várias configurações e opções disponíveis para personalizar o Intlayer conforme as suas necessidades.
 keywords:
@@ -14,6 +14,12 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 9.0.0
+    date: 2026-07-11
+    changes: "Adicionada a configuração `analytics`"
+  - version: 9.0.0
+    date: 2026-06-24
+    changes: "Add `enableProxy` option to the routing configuration"
   - version: 8.10.0
     date: 2026-06-17
     changes: "Adicionada a opção `format` à configuração do dicionário"
@@ -352,6 +358,30 @@ const config: IntlayerConfig = {
     liveSync: true,
   },
 
+  /**
+   * Configuração de analytics.
+   */
+  analytics: {
+    /**
+     * Se a recolha de analytics está ativada (visualizações de página, exposições de conteúdo, eventos A/B).
+     * Requer que `editor.clientId` esteja definido para a atribuição.
+     * Padrão: false
+     */
+    enabled: true,
+
+    /**
+     * Milissegundos entre os envios automáticos em lote para o backend.
+     * Padrão: 20000
+     */
+    flushInterval: 20000,
+
+    /**
+     * Fração de sessões a registar, de 0 (nenhuma) a 1 (todas).
+     * Padrão: 1
+     */
+    sampleRate: 1,
+  },
+
   /**
    * Definições de tradução e geração assistida por IA.
    */
@@ -668,6 +698,20 @@ Define as definições para o editor visual integrado, incluindo a porta do serv
 
 ---
 
+### Configuração de Analytics
+
+Define as definições relacionadas com os analytics do Intlayer: a recolha do conteúdo que é efetivamente mostrado aos utilizadores (visualizações de página, exposições de conteúdo) e o suporte a testes A/B de conteúdo.
+
+Os analytics são estritamente opt-in: nada é recolhido a menos que `analytics.enabled` esteja explicitamente definido como `true` **e** uma chave de projeto (`editor.clientId`) esteja configurada para a atribuição. Quando desativado (padrão), toda a integração de analytics é eliminada do bundle da sua aplicação (dead-code elimination).
+
+| Campo           | Descrição                                                                                    | Tipo      | Padrão  | Exemplo | Nota                                                                                                                                                 |
+| --------------- | -------------------------------------------------------------------------------------------- | --------- | ------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `enabled`       | Ativa a recolha de analytics (visualizações de página, exposições de conteúdo, eventos A/B). | `boolean` | `false` | `true`  | Requer que `editor.clientId` esteja definido para a atribuição; caso contrário, os analytics permanecem desativados mesmo que `enabled` seja `true`. |
+| `flushInterval` | Milissegundos entre os envios automáticos em lote para o backend.                            | `number`  | `20000` | `10000` |                                                                                                                                                      |
+| `sampleRate`    | Fração de sessões a registar, de `0` (nenhuma) a `1` (todas).                                | `number`  | `1`     | `0.5`   | A amostragem é determinística por sessão, pelo que uma sessão registada reporta todos os seus eventos (sem funis parciais).                          |
+
+---
+
 ### Configuração de Roteamento
 
 Definições que controlam o comportamento do roteamento, incluindo estrutura de URL, armazenamento de idiomas e gestão de middleware.

package/docs/pt/intlayer_CMS.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-08-23
-updatedAt: 2026-06-30
+updatedAt: 2026-07-08
 title: Intlayer CMS | Externalize seu conteúdo no Intlayer CMS
 description: Externalize seu conteúdo no Intlayer CMS para delegar a gestão do seu conteúdo para sua equipe.
 keywords:
@@ -18,6 +18,9 @@ slugs:
   - cms
 youtubeVideo: https://www.youtube.com/watch?v=UDDTnirwi_4
 history:
+  - version: 9.0.0
+    date: 2026-07-08
+    changes: "Seção «Sincronização ao vivo» movida para sua própria página (live-sync.md), mantendo aqui uma breve introdução com link"
   - version: 9.0.0
     date: 2026-06-30
     changes: "Adicionada seção de Auto-hospedagem: bootstrap Docker Compose, inventário de serviços, configuração SDK, recursos opcionais e notas de atualização"
@@ -248,148 +251,7 @@ Depois, poderá ver e gerir o seu dicionário no [Intlayer CMS](https://app.intl
 
 A Sincronização ao Vivo permite que a sua aplicação reflita as alterações de conteúdo do CMS em tempo de execução. Não é necessário reconstruir ou reimplantar. Quando ativada, as atualizações são transmitidas para um servidor de Sincronização ao Vivo que atualiza os dicionários que a sua aplicação lê.
 
-> A Sincronização ao Vivo requer uma conexão contínua com o servidor e está disponível no plano enterprise.
-
-Ative a Sincronização ao Vivo atualizando a sua configuração Intlayer:
-
-```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
-import type { IntlayerConfig } from "intlayer";
-
-const config: IntlayerConfig = {
-  // ... outras configurações
-  editor: {
-    /**
-     * Ativa o recarregamento a quente das configurações de localidade quando são detetadas alterações.
-     * Por exemplo, quando um dicionário é adicionado ou atualizado, a aplicação atualiza
-     * o conteúdo exibido na página.
-     *
-     * Como o recarregamento a quente requer uma conexão contínua com o servidor, está
-     * disponível apenas para clientes do plano `enterprise`.
-     *
-     * Padrão: false
-     */
-    liveSync: true,
-  },
-  dictionary: {
-    /**
-     * Controla como os dicionários são importados:
-     *
-     * - "live": Os dicionários são buscados dinamicamente usando a API de Sincronização ao Vivo.
-     *   Substitui useIntlayer por useDictionaryDynamic.
-     *
-     * Nota: O modo live usa a API de Sincronização ao Vivo para buscar os dicionários. Se a chamada da API
-     * falhar, os dicionários são importados dinamicamente.
-     * Nota: Apenas dicionários com conteúdo remoto e sinalizadores "live" usam o modo live.
-     * Outros usam o modo dinâmico para melhor desempenho.
-     */
-    importMode: "fetch",
-  },
-};
-
-export default config;
-```
-
-Inicie o servidor Live Sync para envolver sua aplicação:
-
-Exemplo usando Next.js:
-
-```json5 fileName="package.json"
-{
-  "scripts": {
-    // ... outros scripts
-    "build": "next build",
-    "dev": "next dev",
-    "start": "npx intlayer live --with 'next start'",
-  },
-}
-```
-
-Exemplo usando Vite:
-
-```json5 fileName="package.json"
-{
-  "scripts": {
-    // ... outros scripts
-    "build": "vite build",
-    "dev": "vite dev",
-    "start": "npx intlayer live --with 'vite start'",
-  },
-}
-```
-
-O servidor Live Sync envolve sua aplicação e aplica automaticamente o conteúdo atualizado assim que ele chega.
-
-Para receber notificações de alterações do CMS, o servidor Live Sync mantém uma conexão SSE com o backend. Quando o conteúdo muda no CMS, o backend encaminha a atualização para o servidor Live Sync, que grava os novos dicionários. Sua aplicação refletirá a atualização na próxima navegação ou recarregamento do navegador, sem necessidade de reconstrução.
-
-Fluxograma (CMS/Backend -> Servidor Live Sync -> Servidor de Aplicação -> Frontend):
-
-![Esquema Lógico do Live Sync](https://github.com/aymericzip/intlayer/blob/main/docs/assets/live_sync_logic_schema.svg)
-
-Como funciona:
-
-![Fluxo Live Sync CMS/Backend/Servidor Live Sync/Servidor de Aplicação/Frontend](https://github.com/aymericzip/intlayer/blob/main/docs/assets/live_sync_flow_scema.svg)
-
-### Fluxo de trabalho de desenvolvimento (local)
-
-- Em desenvolvimento, todos os dicionários remotos são buscados quando a aplicação inicia, para que você possa testar atualizações rapidamente.
-- Para testar o Live Sync localmente com Next.js, envolva seu servidor de desenvolvimento:
-
-```json5 fileName="package.json"
-{
-  "scripts": {
-    // ... outros scripts
-    "dev": "npx intlayer live --with 'next dev'",
-    // "dev": "npx intlayer live --with 'vite dev'", // Para Vite
-  },
-}
-```
-
-Habilite a otimização para que o Intlayer aplique as transformações de importação Live durante o desenvolvimento:
-
-```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
-import type { IntlayerConfig } from "intlayer";
-
-const config: IntlayerConfig = {
-  editor: {
-    applicationURL: "http://localhost:5173",
-    liveSyncURL: "http://localhost:4000",
-    liveSync: true,
-  },
-  dictionary: {
-    importMode: "fetch",
-  },
-  build: {
-    optimize: true,
-  },
-};
-
-export default config;
-```
-
-Esta configuração envolve seu servidor de desenvolvimento com o servidor Live Sync, busca dicionários remotos na inicialização e transmite atualizações do CMS via SSE. Atualize a página para ver as mudanças.
-
-Notas e restrições:
-
-- Adicione a origem do live sync à política de segurança do seu site (CSP). Certifique-se de que a URL do live sync esteja permitida em `connect-src` (e `frame-ancestors`, se relevante).
-- O Live Sync não funciona com saída estática. Para Next.js, a página deve ser dinâmica para receber atualizações em tempo de execução (por exemplo, use `generateStaticParams`, `generateMetadata`, `getServerSideProps` ou `getStaticProps` adequadamente para evitar restrições de somente estático).
-  /// No CMS, cada dicionário possui uma flag `live`. Apenas dicionários com `live=true` são buscados via API de sincronização ao vivo; os demais são importados dinamicamente e permanecem inalterados em tempo de execução.
-  /// A flag `live` é avaliada para cada dicionário no momento da compilação. Se o conteúdo remoto não foi marcado como `live=true` durante a compilação, você deve recompilar para habilitar a Sincronização ao Vivo para esse dicionário.
-  /// O servidor de sincronização ao vivo deve ter permissão para escrever em `.intlayer`. Em contêineres, assegure o acesso de escrita a `/.intlayer`.
-  ///
-  /// ## Depuração
-  ///
-  /// Se você encontrar algum problema com o CMS, verifique o seguinte:
-  ///
-  /// - A aplicação está em execução.
-  ///
-  /// - A configuração do [`editor`](https://intlayer.org/doc/concept/configuration#editor-configuration) está corretamente definida no seu arquivo de configuração do Intlayer.
-  /// - Campos obrigatórios:
-- A URL da aplicação deve corresponder àquela que você definiu na configuração do editor (`applicationURL`).
-- A URL do CMS
-
-- Certifique-se de que a configuração do projeto foi enviada para o Intlayer CMS.
-
-- O editor visual usa um iframe para exibir seu site. Certifique-se de que a Política de Segurança de Conteúdo (CSP) do seu site permita a URL do CMS como `frame-ancestors` ('https://app.intlayer.org' por padrão). Verifique o console do editor para qualquer erro.
+Para o guia de configuração completo (ativação, início do servidor Live Sync, fluxo de trabalho de desenvolvimento local e restrições), consulte a [documentação do Live Sync](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/live-sync.md).
 
 ## Auto-hospedagem