@intlayer/docs 9.0.0-canary.2 → 9.0.0-canary.21

package/docs/pl/releases/v7.md

@@ -25,6 +25,10 @@ author: aymericzip
 
 Witamy w Intlayer v7! To duże wydanie wprowadza znaczące ulepszenia w wydajności, bezpieczeństwie typów oraz doświadczeniu deweloperskim. Poniżej znajdują się najważniejsze zmiany, wraz z notatkami migracyjnymi i praktycznymi przykładami.
 
+## Spis treści
+
+<TOC levels={[2]} maxDepth={1} />
+
 ## Najważniejsze zmiany
 
 - Strategia buforowania dla szybszych kompilacji
@@ -260,6 +264,126 @@ Skutkuje to szybszym czasem pobierania i lepszą wydajnością działania Twojej
 
 ---
 
+## Automatyczne formatowanie kodu: konfiguracja formatCommand
+
+v7 wprowadza opcję `formatCommand` w konfiguracji edytora, pozwalającą na automatyczne formatowanie plików zawartości podczas ich zapisywania przez Intlayer. Zapewnia to spójny styl kodu i formatowanie we wszystkich plikach deklaracji zawartości.
+
+Jeśli nie jest ustawiony, Intlayer spróbuje automatycznie wykryć polecenie formatowania. Próbując rozwiązać następujące polecenia: prettier, biome, eslint.
+
+### Konfiguracja
+
+Opcja `formatCommand` akceptuje szablon ciągu znaków, w którym `{{file}}` zostanie zastąpiony rzeczywistą ścieżką pliku:
+
+```typescript fileName="intlayer.config.ts"
+export default {
+  content: {
+    formatCommand: 'bun x biome format "{{file}}" --write --log-level none',
+  },
+};
+```
+
+### Obsługiwane formatory
+
+Możesz używać dowolnego formatera kodu, który akceptuje ścieżki plików jako argumenty:
+
+**Używając Biome:**
+
+```typescript
+formatCommand: 'bun x biome format "{{file}}" --write --log-level none';
+```
+
+**Używając Prettier:**
+
+```typescript
+formatCommand: 'npx prettier --write "{{file}}" --log-level silent';
+```
+
+**Używając ESLint:**
+
+```typescript
+formatCommand: 'npx eslint --fix "{{file}}" --quiet';
+```
+
+**Używając wbudowanego formatera Bun:**
+
+```typescript
+formatCommand: 'bun format "{{file}}"';
+```
+
+### Korzyści
+
+- **Spójne formatowanie**: Wszystkie pliki zawartości są automatycznie formatowane zgodnie z wytycznymi stylu Twojego projektu
+- **Doświadczenie deweloperskie**: Nie ma potrzeby ręcznego formatowania plików po ich wygenerowaniu przez Intlayer
+- **Spójność zespołu**: Zapewnia, że wszyscy członkowie zespołu mają zastosowane to samo formatowanie do plików zawartości
+- **Integracja CI/CD**: Pliki zawartości zachowują spójne formatowanie w zautomatyzowanych przepływach pracy
+
+### Jak to działa
+
+Gdy Intlayer zapisuje lub aktualizuje plik deklaracji zawartości (`.content.ts`, `.content.js`, itp.), automatycznie uruchamia określone polecenie formatowania na pliku. Symbol zastępczy `{{file}}` jest zastępowany rzeczywistą ścieżką pliku, a polecenie jest wykonywane w katalogu bazowym projektu.
+
+---
+
+## Konfiguracja Dictionary: Lepsza organizacja i struktura
+
+v7 wprowadza nową dedykowaną sekcję konfiguracji `dictionary`, która zapewnia lepszą organizację ustawień związanych ze słownikiem i ulepszone zarządzanie zawartością.
+
+### Nowa struktura konfiguracji słownika
+
+Właściwość `fill` została przeniesiona z sekcji `content` do nowej sekcji `dictionary`, zapewniając wyraźniejsze rozdzielenie odpowiedzialności:
+
+**Konfiguracja v6:**
+
+```typescript fileName="intlayer.config.ts"
+export default {
+  content: {
+    autoFill: "./{{fileName}}.content.json",
+    contentDir: ["src"],
+  },
+};
+```
+
+**Konfiguracja v7:**
+
+```typescript fileName="intlayer.config.ts"
+export default {
+  content: {
+    contentDir: ["src"],
+  },
+  dictionary: {
+    fill: "./{{fileName}}.content.json",
+  },
+};
+```
+
+### Korzyści nowej struktury
+
+- **Wyraźniejsza organizacja**: Ustawienia specyficzne dla słownika są teraz pogrupowane
+- **Lepsza separacja obaw**: Odkrywanie zawartości a operacje na słowniku są wyraźnie rozdzielone
+- **Ulepszona łatwość utrzymania**: Łatwiej zrozumieć i modyfikować konfiguracje związane ze słownikami
+- **Przyszła rozszerzalność**: Sekcja słownika może zawierać dodatkowe ustawienia specyficzne dla słownika
+- **Kompleksowe zarządzanie słownikami**: Obejmuje właściwości takie jak `title`, `live`, `priority`, `tags`, `version` i `description` do tworzenia i zarządzania nowymi słownikami
+
+### Użycie konfiguracji
+
+Konfiguracja słownika służy dwóm głównym celom:
+
+1. **Wartości domyślne**: Definiowanie wartości domyślnych podczas tworzenia plików deklaracji treści
+2. **Zachowanie fallbacku**: Dostarczanie wartości fallbacku, gdy określone pola nie są zdefiniowane, umożliwiając globalną definicję zachowania operacji słownika
+
+Sekcja słownika zawiera kompleksowe właściwości do zarządzania słownikiem:
+
+- **`fill`**: Zachowanie auto-fill dla generowania treści
+- **`title`**: Domyślny tytuł dla nowych słowników
+- **`live`**: Konfiguracja live sync dla aktualizacji w czasie rzeczywistym
+- **`priority`**: Ustawienia priorytetu dla rozdzielczości słownika
+- **`tags`**: Domyślne tagi do organizacji treści
+- **`version`**: Zarządzanie wersjami dla aktualizacji słownika
+- **`description`**: Domyślny opis dla nowej treści
+
+Aby uzyskać więcej informacji o plikach deklaracji treści i sposobie zastosowania wartości konfiguracji, zobacz [Dokumentację pliku treści](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dictionary/content_file.md).
+
+---
+
 ## Komenda fill: Zaktualizowane zachowanie dla lepszego zarządzania treścią
 
 Wersja 7 wprowadza ulepszone zachowanie komendy `fill`, zapewniając bardziej przewidywalne i elastyczne zarządzanie treścią:
@@ -407,6 +531,10 @@ System automatycznie:
 - **`middleware.prefixDefault`**: Zastąpione przez `routing.mode`
 - **`middleware.noPrefix`**: Zastąpione przez `routing.mode`
 
+### Nowe konfiguracje
+
+- **`editor.formatCommand`**: Nowa opcja do automatycznego formatowania kodu plików zawartości
+
 ### Mapowanie migracji
 
 #### Mapowanie konfiguracji

package/docs/pl/releases/v9.md

@@ -1,15 +1,16 @@
 ---
 createdAt: 2026-06-14
-updatedAt: 2026-06-14
+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), Wariantów (Variants) i Dynamicznych Rekordów (Dynamic Records).
+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:
   - Intlayer
   - Kompatybilność
   - Migracja
   - Kolekcje
   - Warianty
-  - Dynamiczne Rekordy
+  - Self-Hosting
+  - Docker
   - i18next
   - next-intl
   - vue-i18n
@@ -22,7 +23,7 @@ author: aymericzip
 
 # Nowy Intlayer v9 - Co nowego?
 
-Witaj w Intlayer v9! To główne wydanie (major release) stanowi ogromny krok milowy w upraszczaniu ścieżki migracji do Intlayer dzięki **pakietom kompatybilności (Compat Adapter Packages)** dla najpopularniejszych bibliotek i18n (takich jak `react-i18next`, `next-intl`, `vue-i18n` itp.) oraz wprowadza wsparcie dla bogatych struktur treści: **Kolekcji (Collections)**, **Wariantów (Variants)** i **Dynamicznych Rekordów (Dynamic Records)**.
+Witaj w Intlayer v9! To główne wydanie (major release) stanowi ogromny krok milowy w upraszczaniu ścieżki migracji do Intlayer dzięki **pakietom kompatybilności (Compat Adapter Packages)** dla najpopularniejszych bibliotek i18n (takich jak `react-i18next`, `next-intl`, `vue-i18n` itp.) oraz wprowadza wsparcie dla bogatych struktur treści: **Kolekcji (Collections)** i **Wariantów (Variants)**.
 
 ## Spis treści
 
@@ -41,8 +42,10 @@ Zastępując importy, zyskujesz wszystkie zalety Intlayer (w tym bezpieczeństwo
 - `@intlayer/i18next`
 - `@intlayer/react-i18next`
 - `@intlayer/next-intl`
+- `@intlayer/react-intl`
 - `@intlayer/next-i18next`
 - `@intlayer/vue-i18n`
+- `@intlayer/lingui`
 
 Na przykład, po prostu zmień:
 
@@ -100,7 +103,7 @@ Wszystkie adaptery kompatybilności kierują teraz proces rozwiązywania tłumac
 
 ---
 
-## Specyfikacja funkcji: Kolekcje, Warianty i Dynamiczne Rekordy
+## Specyfikacja funkcji: Kolekcje i Warianty
 
 Intlayer v9 wykracza poza statyczne obiekty klucz-wartość, umożliwiając słownikom deklarowanie dynamicznych struktur układu, które są w pełni typowane od początku do końca (end-to-end).
 
@@ -108,42 +111,48 @@ Intlayer v9 wykracza poza statyczne obiekty klucz-wartość, umożliwiając sło
 
 Zdefiniuj zarządzaną przez CMS uporządkowaną lista elementów (np. FAQ, produkty lub listy blogów):
 
-```ts fileName="faq.content.ts"
+```ts fileName="faq.1.content.ts"
 import { t, type Dictionary } from "intlayer";
 
 export default {
   key: "faq",
-  content: [
-    {
-      question: t({
-        pl: "Co to jest Intlayer?",
-        en: "What is Intlayer?",
-        fr: "Qu'est-ce qu'Intlayer ?",
-      }),
-      answer: t({
-        pl: "Zestaw narzędzi i18n.",
-        en: "An i18n toolkit.",
-        fr: "Une boîte à outils i18n.",
-      }),
-    },
-  ],
+  item: 1,
+  content: {
+    question: t({ en: "What is Intlayer?", fr: "Qu'est-ce qu'Intlayer ?" }),
+    answer: t({ en: "An i18n toolkit.", fr: "Une boîte à outils i18n." }),
+  },
+} satisfies Dictionary;
+```
+
+```ts fileName="faq.2.content.ts"
+import { t, type Dictionary } from "intlayer";
+
+export default {
+  key: "faq",
+  item: 2,
+  content: {
+    question: t({ en: "Is it free?", fr: "Est-ce gratuit ?" }),
+    answer: t({ en: "Yes, open-source.", fr: "Oui, open-source." }),
+  },
 } satisfies Dictionary;
 ```
 
 #### Użycie:
 
 ```ts
-// Pobierz wszystkie elementy
+// Fetch all items as an array
 const allFaqs = useIntlayer("faq"); // -> { question: string, answer: string }[]
 
-// Pobierz pojedynczy element po indeksie
-const faq = useIntlayer("faq", { item: 1 }); // -> { question: string, answer: string }
+// Fetch a single item by index
+const faq = useIntlayer("faq", { item: 2 }); // -> { question: string, answer: string }
 ```
 
 ### 2. Warianty (Variants)
 
 Dostarczaj testy A/B, nagłówki sezonowe, flagi funkcji (feature flags) lub niestandardowe strony docelowe (landing pages):
 
+#### Warianty tekstowe (np. testy A/B)
+
 ```ts fileName="hero.content.ts"
 import { t, type Dictionary } from "intlayer";
 
@@ -167,16 +176,14 @@ export default {
 const banner = useIntlayer("hero-banner", { variant: "black_friday" });
 ```
 
-### 3. Dynamiczne Rekordy (Dynamic Records)
-
-Definiuj słowniki, których wpisy są ładowane dynamicznie w czasie działania aplikacji (runtime) za pomocą identyfikatorów zapytań (query IDs):
+#### Warianty obiektowe (np. Dynamic Records)
 
 ```ts fileName="product.content.ts"
 import { t, type Dictionary } from "intlayer";
 
 export default {
   key: "product-copy",
-  meta: {
+  variant: {
     id: "prod_123",
     category: "books",
   },
@@ -191,28 +198,184 @@ export default {
 ```ts
 // Pobiera dynamicznie tylko żądany element (wymaga Suspense)
 const product = useIntlayer("product-copy", {
-  id: "prod_123",
-  category: "books",
+  variant: { id: "prod_123", category: "books" },
 });
 ```
 
 ---
 
-## Dynamiczne ładowanie i optymalizacja rozmiaru paczki (Bundle Size)
+## `@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`:
+
+```ts fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import { intlayer } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [intlayer()],
+});
+```
+
+- **Compiler**: Aktywuje się automatycznie, gdy `compiler.enabled` jest ustawione na `true` i skonfigurowana jest ścieżka `compiler.output`. Nie musisz już rejestrować `intlayerCompiler()` osobno.
+- **Proxy**: Aktywuje się automatycznie w oparciu o nową opcję `routing.enableProxy` (domyślnie `true`). Podłącza middleware do wykrywania locale'ów / przekierowywania / przepisywania w developmencie, preview i produkcyjnym SSR. Nie musisz już rejestrować `intlayerProxy()` osobno.
 
-Aby zachować niezwykle mały rozmiar paczek (bundles), Intlayer v9 wspiera dynamiczne leniwe ładowanie (lazy loading).
+### Opcja `routing.enableProxy`
 
-W swojej konfiguracji ustaw `importMode` na `'dynamic'` lub `'fetch'`:
+Nowa opcja `routing.enableProxy` kontroluje, czy proxy routingu lokalizacji jest podłączony. Domyślnie ma wartość `true`. Wyłącz to, jeśli chcesz samodzielnie obsługiwać routing lokalizacji:
 
 ```ts fileName="intlayer.config.ts"
-export default {
-  dictionary: {
-    importMode: "dynamic", // "static" | "dynamic" | "fetch"
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  routing: {
+    enableProxy: false, // Domyślnie: true
+  },
+};
+
+export default config;
+```
+
+Autonomiczne pluginy `intlayerCompiler()` i `intlayerProxy()` pozostają eksportowane dla zaawansowanych konfiguracji. Rejestrowanie ich razem z `intlayer()` jest bezpieczne — każdy plugin deduplikuje się i uruchamia się tylko raz.
+
+---
+
+## Kompilator domyślnie wyłączony
+
+Od Intlayer v9 **kompilator jest domyślnie wyłączony** (`compiler.enabled` ma teraz domyślnie wartość `false`). Aby włączyć ekstrakcję plików `.content.ts` w czasie budowania, ustaw `compiler.enabled: true` w swojej konfiguracji:
+
+```ts fileName="intlayer.config.ts"
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  compiler: {
+    enabled: true, // Domyślnie: false — wymagane do włączenia kompilatora od wersji v9
+    output: ({ fileName }) => `./${fileName}.content.ts`,
   },
 };
+
+export default config;
+```
+
+Gdy kompilator jest wyłączony, Intlayer pomija krok ekstrakcji w czasie budowania i opiera się na już zadeklarowanych słownikach. Włącz go tylko wtedy, gdy chcesz, aby plugin bundlera (`@intlayer/swc`, `@intlayer/babel` lub plugin Vite `intlayer()`) automatycznie wyodrębniał zawartość.
+
+---
+
+## React Native: importy z jednego pakietu
+
+W aplikacji React Native lub Expo nie musisz już żonglować pakietami `react-intlayer` i `react-native-intlayer`. Pakiet `react-native-intlayer` teraz **ponownie eksportuje pełne API `react-intlayer`** (hooki, narzędzia oraz podścieżki `/format`, `/html` i `/markdown`), a jego `IntlayerProvider` automatycznie stosuje polyfille React Native.
+
+Importuj wszystko z jednego pakietu `react-native-intlayer`:
+
+```tsx
+import {
+  IntlayerProvider,
+  useIntlayer,
+  useLocale,
+} from "react-native-intlayer";
+```
+
+```bash
+npm install intlayer react-native-intlayer
+```
+
+> Importowanie z `react-intlayer` nadal działa, ale `react-native-intlayer` jest teraz zalecanym pojedynczym punktem wejścia dla React Native — jego provider zawiera polyfille, których nie posiada zorientowany na web provider `react-intlayer`.
+
+---
+
+## SDK CMS: używaj Intlayer jako bezgłowej bazy danych treści
+
+Intlayer v9 dostarcza przejrzysty, samodzielnie uwierzytelniający się SDK w `@intlayer/api` do programowej interakcji z CMS — pobieranie projektów, pobieranie słowników oraz wysyłanie lub aktualizowanie ich z własnego serwera, skryptów lub CI. Uwierzytelnianie (OAuth2 `client_credentials`) jest obsługiwane i odświeżane za Ciebie.
+
+SDK jest podzielony na **dwa osobne importy**, dzięki czemu Twój bundle zawiera tylko te domeny, których faktycznie używasz:
+
+1. `createIntlayerCMS` — lekki **uwierzytelniacz** przechowujący poświadczenia i zarządzany token (bez dołączania klienta domeny).
+2. `dictionaryEndpoint`, `projectEndpoint`, … — **łączniki endpointów** dla poszczególnych domen, każdy importowany z własnej podścieżki.
+
+```ts fileName="cms.ts"
+import { createIntlayerCMS } from "@intlayer/api";
+import { dictionaryEndpoint } from "@intlayer/api/dictionary";
+
+// Konfiguracja jest opcjonalna: poświadczenia są pobierane z INTLAYER_CLIENT_ID /
+// INTLAYER_CLIENT_SECRET rozwiązywanych przez `@intlayer/config/built`.
+const cms = createIntlayerCMS();
+
+// Odczyt
+const { data: dictionaries } = await dictionaryEndpoint(cms).getDictionaries();
+
+// Zapis — używaj CMS jak bazy danych
+await dictionaryEndpoint(cms).pushDictionaries([myDictionary]);
 ```
 
-W czasie budowania (build time), `@intlayer/swc` oraz `@intlayer/babel` skanują Twoje pliki i zastępują wywołania `useIntlayer` / `getIntlayer` opakowaniami wspierającymi tree-shaking (`useDictionary` / `useDictionaryDynamic`). Ładowana jest tylko treść wymagana dla wybranego elementu kolekcji, wariantu lub języka (locale), co zapobiega dołączaniu nieużywanych tłumaczeń do Twojej paczki produkcyjnej (production bundle).
+> Bezpieczeństwo: poświadczenia CMS dają dostęp do zapisu Twoich treści. Twórz uwierzytelniacz wyłącznie **po stronie serwera** — nigdy nie wysyłaj `clientId` / `clientSecret` do przeglądarki.
+
+---
+
+## Samodzielne hostowanie (Self-Hosting)
+
+Intlayer v9 zapewnia pełne wsparcie dla uruchamiania własnej instancji Intlayer za pomocą jednej komendy — bez konieczności posiadania konta Intlayer Cloud.
+
+```sh
+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.
+
+### Uwzględnione serwisy
+
+| Serwis                                     | Przeznaczenie                                                                      |
+| ------------------------------------------ | ---------------------------------------------------------------------------------- |
+| **app** (TanStack Start)                   | Interfejs panelu na porcie `3000`                                                  |
+| **backend** (Fastify/Bun)                  | REST API na porcie `3100`                                                          |
+| **MongoDB 7** (jednowęzłowy zestaw replik) | Główna baza danych                                                                 |
+| **Redis 7**                                | Kolejki zadań i pamięć podręczna                                                   |
+| **MinIO**                                  | Magazyn obiektów zgodny z S3 (awatary, zrzuty ekranu)                              |
+| **Mailpit**                                | Lokalny odbiorca SMTP + interfejs webowy dla poczty transakcyjnej na porcie `8025` |
+
+Chromium (używany do generowania zrzutów ekranu przez Puppeteer) jest wbudowany w obraz backendu — żaden dodatkowy kontener nie jest potrzebny.
 
 ---
 
@@ -220,13 +383,17 @@ W czasie budowania (build time), `@intlayer/swc` oraz `@intlayer/babel` skanują
 
 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:
 
+- **Kompilator domyślnie wyłączony**: `compiler.enabled` ma teraz domyślnie wartość `false`. Jeśli polegasz na ekstrakcji plików `.content.ts` w czasie budowania, ustaw `compiler.enabled: true` w swoim `intlayer.config.ts`.
 - **Języki i dialekty (Locales & Dialects)**: Jeśli używasz zewnętrznych zależności i18n, dodaj odpowiednie pluginy adapterów kompatybilności w swojej konfiguracji lub konfiguracji bundlera, aby automatycznie przepisywać importy.
-- **Niestandardowe selektory (Custom Selectors)**: Podczas wywoływania `useIntlayer`, drugi parametr jest teraz zarezerwowany dla obiektu opcji zawierającego `{ locale, item, variant, id }`. Jeśli wcześniej przekazywałeś bezpośrednio ciąg znaków języka (locale string), nadal możesz to robić, jednak zaleca się używanie obiektu opcji przy bardziej zaawansowanych wyborach.
+- **Niestandardowe selektory (Custom Selectors)**: Podczas wywoływania `useIntlayer`, drugi parametr jest teraz zarezerwowany dla obiektu opcji zawierającego `{ locale, item, variant }`. Jeśli wcześniej przekazywałeś bezpośrednio ciąg znaków języka (locale string), nadal możesz to robić, jednak zaleca się używanie obiektu opcji przy bardziej zaawansowanych wyborach.
 
 ---
 
 ## Przydatne linki
 
 - [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, Warianty i Dynamiczne Rekordy](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dynamic_dictionaries/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/pl/roadmap.md

@@ -328,22 +328,6 @@ Intlayer obsługuje **TypeScript** (również JavaScript) oraz **JSON** do dekla
 
 ### 4. Ulepszenia SEO
 
-- Narzędzia do **analizy słów kluczowych**, intencji wyszukiwania użytkowników oraz pojawiających się trendów.
-- Sugestie ulepszonej treści dla lepszych pozycji w rankingach oraz monitorowanie długoterminowej wydajności.
-
-### 5. Zgodność z większą liczbą frameworków
-
-- Trwają prace nad wsparciem dla **Solid, Svelte, Angular** i innych.
-- Celem jest uczynienie Intlayer kompatybilnym z **dowolną aplikacją opartą na JavaScript**.
-
----
-
-## Podsumowanie
-
-- System generowałby tłumaczenia w tle, a następnie prosiłby Cię o ich zatwierdzenie lub edycję.
-
-### 4. Ulepszenia SEO
-
 - Narzędzia do **analizy słów kluczowych**, intencji wyszukiwania użytkowników oraz pojawiających się trendów.
 - Sugestie ulepszonej treści dla lepszych pozycji w rankingach oraz śledzenie długoterminowej wydajności.