@intlayer/docs 8.9.4-canary.0 → 8.9.5

package/docs/pl/dictionary/content_file.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-02-07
-updatedAt: 2026-01-28
+updatedAt: 2026-05-12
 title: Plik z Treścią
 description: Dowiedz się, jak dostosować rozszerzenia dla plików deklaracji treści. Postępuj zgodnie z tą dokumentacją, aby efektywnie wdrażać warunki w swoim projekcie.
 keywords:
@@ -12,6 +12,9 @@ slugs:
   - concept
   - content
 history:
+  - version: 8.9.0
+    date: 2026-05-12
+    changes: "Add `plural` content node type"
   - version: 8.0.0
     date: 2026-01-28
     changes: "Dodano typ węzła zawartości `html`"
@@ -66,6 +69,7 @@ import { type ReactNode } from "react";
 import {
   t,
   enu,
+  plural,
   cond,
   nest,
   md,
@@ -85,6 +89,7 @@ interface Content {
   };
   multilingualContent: string;
   quantityContent: string;
+  pluralContent: string;
   conditionalContent: string;
   markdownContent: never;
   htmlContent: never;
@@ -120,6 +125,10 @@ export default {
       ">5": "Kilka samochodów",
       ">19": "Wiele samochodów",
     }),
+    pluralContent: plural({
+      one: "One car",
+      other: "{{count}} cars",
+    }),
     conditionalContent: cond({
       true: "Walidacja jest włączona",
       false: "Walidacja jest wyłączona",
@@ -174,6 +183,13 @@ export default {
         ">5": "Kilka samochodów",
         ">19": "Wiele samochodów",
       },
+      "pluralContent": {
+        "nodeType": "plural",
+        "plural": {
+          "one": "One car",
+          "other": "{{count}} cars",
+        },
+      },
     },
     "conditionalContent": {
       "nodeType": "condition",
@@ -221,6 +237,7 @@ Węzły treści są podstawowymi elementami zawartości słownika. Mogą to być
 - **Wartości prymitywne**: łańcuchy znaków, liczby, wartości logiczne, null, undefined
 - **Węzły typowane**: Specjalne typy zawartości, takie jak tłumaczenia, warunki, markdown itp.
 - **Funkcje**: Dynamiczna zawartość, która może być oceniana w czasie wykonywania [zobacz Pobieranie funkcji](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dictionary/function_fetching.md)
+- **Plural Content**: See Plural Content [See Plural Content](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dictionary/plural.md)
 - **Zagnieżdżona zawartość**: Odwołania do innych słowników
 
 #### Typy zawartości
@@ -551,6 +568,8 @@ multilingualContent: t({
 });
 ```
 
+> See [Zawartość tłumaczenia (`t`) Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dictionary/translation.md) for more information.
+
 ### Zawartość warunkowa (`cond`)
 
 Treść, która zmienia się w zależności od warunków logicznych (boolean):
@@ -564,6 +583,8 @@ conditionalContent: cond({
 });
 ```
 
+> See [Zawartość warunkowa (`cond`) Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dictionary/condition.md) for more information.
+
 ### Treść enumeracyjna (`enu`)
 
 Treść, która zmienia się w zależności od wartości enumeracyjnych:
@@ -578,6 +599,23 @@ statusContent: enu({
 });
 ```
 
+> See [Treść enumeracyjna (`enu`) Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dictionary/enumeration.md) for more information.
+
+### Plural Content (`plural`)
+
+Content that varies based on plural rules:
+
+```typescript
+import { plural } from "intlayer";
+
+pluralContent: plural({
+  one: "One car",
+  other: "{{count}} cars",
+});
+```
+
+> See [Plural Content Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dictionary/plural.md) for more information.
+
 ### Treść wstawiana (`insert`)
 
 Treść, którą można wstawić do innej treści:
@@ -588,6 +626,8 @@ import { insert } from "intlayer";
 insertionContent: insert("Ten tekst można wstawić w dowolne miejsce");
 ```
 
+> See [Treść wstawiana (`insert`) Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dictionary/insertion.md) for more information.
+
 ### Treść zagnieżdżona (`nest`)
 
 Odniesienia do innych słowników:
@@ -598,6 +638,8 @@ import { nest } from "intlayer";
 nestedContent: nest("about-page");
 ```
 
+> See [Treść zagnieżdżona (`nest`) Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dictionary/nesting.md) for more information.
+
 ### Zawartość Markdown (`md`)
 
 Treść sformatowana w Markdown:
@@ -610,6 +652,8 @@ markdownContent: md(
 );
 ```
 
+> See [Zawartość Markdown (`md`) Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dictionary/markdown.md) for more information.
+
 ### Zawartość HTML (`html`)
 
 Zawartość HTML, która może używać standardowych tagów lub niestandardowych komponentów:
@@ -627,6 +671,8 @@ localizedHtmlContent: t({
 });
 ```
 
+> See [Zawartość HTML (`html`) Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dictionary/html.md) for more information.
+
 ### Zawartość według płci (`gender`)
 
 Treść zmieniająca się w zależności od płci:
@@ -641,6 +687,8 @@ genderContent: gender({
 });
 ```
 
+> See [Zawartość według płci (`gender`) Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dictionary/gender.md) for more information.
+
 ### Zawartość pliku (`file`)
 
 Odniesienia do plików zewnętrznych:
@@ -651,6 +699,8 @@ import { file } from "intlayer";
 fileContent: file("./path/to/content.txt");
 ```
 
+> See [Zawartość pliku (`file`) Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dictionary/file.md) for more information.
+
 ## Tworzenie plików z zawartością
 
 ### Podstawowa struktura pliku z zawartością

package/docs/pl/mcp_server.md

@@ -23,7 +23,7 @@ history:
     changes: "Dodano konfigurację Claude Desktop"
   - version: 5.5.12
     date: 2025-07-10
-    changes: "Dodano transport SSE i zdalny serwer"
+    changes: "Dodano transport Streamable HTTP i zdalny serwer"
   - version: 5.5.10
     date: 2025-06-29
     changes: "Inicjalizacja historii"
@@ -51,12 +51,12 @@ Włączając Serwer Intlayer MCP w swoim IDE, zyskujesz:
 
 > Pełną listę poleceń i opcji znajdziesz w [dokumentacji Intlayer CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/cli/index.md).
 
-## Serwer lokalny (stdio) vs Serwer zdalny (SSE)
+## Serwer lokalny (stdio) vs Serwer zdalny (Streamable HTTP)
 
 Serwer MCP można używać na dwa sposoby:
 
 - Serwer lokalny (stdio)
-- Serwer zdalny (SSE)
+- Serwer zdalny (Streamable HTTP)
 
 ### Serwer lokalny (stdio) (zalecany)
 
@@ -64,7 +64,7 @@ Intlayer udostępnia pakiet NPM, który można zainstalować lokalnie na swoim k
 
 Ten serwer jest zalecanym sposobem korzystania z serwera MCP, ponieważ integruje wszystkie funkcje serwera MCP, w tym narzędzia CLI.
 
-### Serwer zdalny (SSE)
+### Serwer zdalny (Streamable HTTP)
 
 Serwer MCP może być również używany zdalnie, korzystając z metody transportu SSE. Serwer ten jest hostowany przez Intlayer i jest dostępny pod adresem https://mcp.intlayer.org. Do tego serwera można uzyskać dostęp publicznie, bez żadnej autoryzacji, i jest on bezpłatny w użyciu.
 
@@ -97,7 +97,7 @@ bun x intlayer init mcp
 To polecenie:
 
 1. Zapyta, której platformy używasz (Cursor, VS Code, Claude Desktop itp.).
-2. Zapyta, której metody transportu chcesz użyć (serwer lokalny (stdio) lub serwer zdalny (SSE)).
+2. Zapyta, której metody transportu chcesz użyć (serwer lokalny (stdio) lub serwer zdalny (Streamable HTTP)).
 3. Automatycznie zaktualizuje Twój plik konfiguracyjny (np. `.cursor/mcp.json`, `.vscode/mcp.json` lub globalną konfigurację Claude Desktop).
 
 ---
@@ -107,7 +107,7 @@ To polecenie:
 1. Otwórz paletę komend (Ctrl+Shift+P lub Cmd+Shift+P).
 2. Wpisz `Intlayer: Setup AI Agent Skills`
 3. Wybierze platformę, której używasz (np. `VS Code`, `Cursor`, `Windsurf`, `OpenCode`, `Claude Code`, `GitHub Copilot Workspace` itp.).
-4. Wybierz MCP do zainstalowania (stdio, SSE)
+4. Wybierz MCP do zainstalowania (stdio, Streamable HTTP)
 5. Naciśnij Enter.
 
 ---
@@ -131,16 +131,16 @@ W katalogu głównym projektu dodaj następujący plik konfiguracyjny `.cursor/m
 }
 ```
 
-### Serwer zdalny (SSE)
+### Serwer zdalny (Streamable HTTP)
 
-Aby połączyć się ze zdalnym serwerem Intlayer MCP za pomocą Server-Sent Events (SSE), możesz skonfigurować swojego klienta MCP do łączenia się z usługą hostowaną.
+Aby połączyć się ze zdalnym serwerem Intlayer MCP za pomocą Server-Sent Events (Streamable HTTP), możesz skonfigurować swojego klienta MCP do łączenia się z usługą hostowaną.
 
 ```json fileName=".cursor/mcp.json"
 {
   "mcpServers": {
-    "intlayer": {
-      "url": "https://mcp.intlayer.org",
-      "transport": "sse"
+    "intlayer-sse": {
+      "command": "npx",
+      "args": ["-y", "mcp-remote@latest", "https://mcp.intlayer.org"]
     }
   }
 }
@@ -172,16 +172,16 @@ Utwórz plik `.vscode/mcp.json` w katalogu głównym projektu:
 }
 ```
 
-### Serwer zdalny (SSE)
+### Serwer zdalny (Streamable HTTP)
 
-Aby połączyć się ze zdalnym serwerem Intlayer MCP za pomocą Server-Sent Events (SSE), możesz skonfigurować swojego klienta MCP do łączenia się z usługą hostowaną.
+Aby połączyć się ze zdalnym serwerem Intlayer MCP za pomocą Server-Sent Events (Streamable HTTP), możesz skonfigurować swojego klienta MCP do łączenia się z usługą hostowaną.
 
 ```json fileName=".vscode/mcp.json"
 {
   "servers": {
-    "intlayer": {
-      "url": "https://mcp.intlayer.org",
-      "type": "sse"
+    "intlayer-sse": {
+      "command": "npx",
+      "args": ["-y", "mcp-remote@latest", "https://mcp.intlayer.org"]
     }
   }
 }
@@ -191,7 +191,7 @@ Aby połączyć się ze zdalnym serwerem Intlayer MCP za pomocą Server-Sent Eve
 
 ## Konfiguracja w ChatGPT
 
-### Serwer zdalny (SSE)
+### Serwer zdalny (Streamable HTTP)
 
 Postępuj zgodnie z [oficjalną dokumentacją](https://platform.openai.com/docs/mcp#test-and-connect-your-mcp-server), aby skonfigurować serwer MCP w ChatGPT.
 
@@ -232,6 +232,19 @@ Postępuj zgodnie z [oficjalną dokumentacją](https://modelcontextprotocol.io/q
 }
 ```
 
+### Serwer zdalny (Streamable HTTP)
+
+```json fileName="claude_desktop_config.json"
+{
+  "mcpServers": {
+    "intlayer-sse": {
+      "command": "npx",
+      "args": ["-y", "mcp-remote@latest", "https://mcp.intlayer.org"]
+    }
+  }
+}
+```
+
 ---
 
 ## Korzystanie z serwera MCP przez CLI

package/docs/pl/plugins/sync-po.md

@@ -0,0 +1,333 @@
+---
+createdAt: 2026-05-10
+updatedAt: 2026-05-10
+title: Plugin Sync PO
+description: Synchronizuj słowniki Intlayer z plikami Gettext PO. Zachowaj istniejące i18n, używając Intlayer do zarządzania, tłumaczenia i testowania swoich komunikatów.
+keywords:
+  - Intlayer
+  - Sync PO
+  - Gettext
+  - i18n
+  - tłumaczenia
+slugs:
+  - doc
+  - plugin
+  - sync-po
+youtubeVideo: https://www.youtube.com/watch?v=MpGMxniDHNg
+history:
+  - version: 8.9.4
+    date: 2026-05-10
+    changes: "Początkowa dokumentacja pluginu Sync PO"
+---
+
+# Sync PO (mosty i18n) - Sync PO ze wsparciem ICU / i18next
+
+Używaj Intlayer jako dodatku do swojego istniejącego stosu i18n. Ten plugin utrzymuje synchronizację komunikatów Gettext PO ze słownikami Intlayer, dzięki czemu możesz:
+
+- Zachować istniejący przepływ pracy tłumaczeń oparty na plikach PO.
+- Zarządzać i tłumaczyć swoje komunikaty za pomocą Intlayer (CLI, CI, dostawcy, CMS), bez refaktoryzacji aplikacji.
+- Dostarczać samouczki i treści SEO skierowane do każdego ekosystemu, sugerując Intlayer jako warstwę zarządzania plikami PO.
+
+Uwagi i aktualny zakres:
+
+- Externalizacja do CMS działa dla tłumaczeń i klasycznego tekstu.
+- Brak jeszcze wsparcia dla wstawek, liczb mnogich/ICU lub zaawansowanych funkcji runtime innych bibliotek wewnątrz samych wpisów PO.
+- Edytor wizualny nie jest jeszcze wspierany dla wyjść i18n firm trzecich.
+
+### Kiedy używać tego pluginu
+
+- Używasz już plików Gettext PO do swoich tłumaczeń.
+- Chcesz korzystać z wypełniania wspomaganego przez AI, testów w CI i operacji na treści bez zmiany swojego runtime'u renderowania.
+
+## Instalacja
+
+```bash
+pnpm add -D @intlayer/sync-po-plugin
+# lub
+npm i -D @intlayer/sync-po-plugin
+```
+
+## Pluginy
+
+Ten pakiet dostarcza dwa pluginy:
+
+- `loadPO`: Ładuje pliki PO do słowników Intlayer.
+  - Ten plugin służy do ładowania plików PO ze źródła i zostaną one wczytane do słowników Intlayer. Może on przeszukiwać całą bazę kodu w poszukiwaniu konkretnych plików PO.
+    Plugin ten może być używany:
+    - jeśli używasz biblioteki i18n, która narzuca określoną lokalizację dla ładowania plików PO, ale chcesz umieścić swoją deklarację treści w dowolnym miejscu w swojej bazie kodu.
+    - Może być również używany, jeśli chcesz pobierać komunikaty ze zdalnego źródła (np. CMS, API itp.) i przechowywać je w plikach PO.
+
+  > Pod maską ten plugin przeszuka całą bazę kodu, znajdzie konkretne pliki PO i załaduje je do słowników Intlayer.
+  > Pamiętaj, że ten plugin nie będzie zapisywał wyników i tłumaczeń z powrotem do plików PO.
+
+- `syncPO`: Synchronizuje pliki PO ze słownikami Intlayer.
+  - Ten plugin służy do synchronizacji plików PO ze słownikami Intlayer. Może on przeszukiwać podaną lokalizację i ładować pliki PO pasujące do wzorca. Plugin ten jest przydatny, jeśli chcesz czerpać korzyści z Intlayer, korzystając jednocześnie z innej biblioteki i18n.
+
+## Używanie obu pluginów
+
+```ts fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+import { loadPO, syncPO } from "@intlayer/sync-po-plugin";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
+
+  // Utrzymuj synchronizację aktualnych plików PO ze słownikami Intlayer
+  plugins: [
+    /**
+     * Załaduje wszystkie pliki PO w src pasujące do wzorca {key}.i18n.po
+     */
+    loadPO({
+      source: ({ key }) => `./src/**/${key}.i18n.po`,
+      locale: Locales.ENGLISH,
+      priority: 1, // Zapewnia, że te pliki PO mają pierwszeństwo przed plikami w `./locales/en/${key}.po`
+    }),
+    /**
+     * Załaduje i zapisze wyniki oraz tłumaczenia z powrotem do plików PO w katalogu locales
+     */
+    syncPO({
+      source: ({ key, locale }) => `./locales/${locale}/${key}.po`,
+      priority: 0,
+    }),
+  ],
+};
+
+export default config;
+```
+
+## Plugin `syncPO`
+
+### Szybki start
+
+Dodaj plugin do swojego `intlayer.config.ts` i skieruj go na istniejącą strukturę plików PO.
+
+```ts fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+import { syncPO } from "@intlayer/sync-po-plugin";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
+
+  // Utrzymuj synchronizację aktualnych plików PO ze słownikami Intlayer
+  plugins: [
+    syncPO({
+      // Układ według języka i przestrzeni nazw
+      source: ({ key, locale }) => `./locales/${locale}/${key}.po`,
+    }),
+  ],
+};
+
+export default config;
+```
+
+Alternatywa: pojedynczy plik na język:
+
+```ts fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+import { syncPO } from "@intlayer/sync-po-plugin";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH],
+    defaultLocale: Locales.ENGLISH,
+  },
+  plugins: [
+    syncPO({
+      source: ({ locale }) => `./locales/${locale}.po`,
+    }),
+  ],
+};
+
+export default config;
+```
+
+#### Jak to działa
+
+- Odczyt: plugin wykrywa pliki PO za pomocą konstruktora `source` i ładuje je jako słowniki Intlayer.
+- Zapis: po zbudowaniu i wypełnieniu, zapisuje zlokalizowane pliki PO z powrotem pod tymi samymi ścieżkami (z odpowiednimi nagłówkami Gettext).
+- Automatyczne wypełnianie: plugin deklaruje ścieżkę `autoFill` dla każdego słownika. Uruchomienie `intlayer fill` domyślnie aktualizuje tylko brakujące tłumaczenia w plikach PO.
+
+API:
+
+```ts
+syncPO({
+  source: ({ key, locale }) => string, // wymagane
+  location?: string, // opcjonalna etykieta, domyślnie: "sync-po::path/to/source"
+  priority?: number, // opcjonalny priorytet dla rozwiązywania konfliktów, domyślnie: 0
+});
+```
+
+### Wiele źródeł PO i priorytet
+
+Możesz dodać wiele pluginów `syncPO`, aby synchronizować różne źródła PO. Jest to przydatne, gdy masz wiele źródeł tłumaczeń lub różne struktury PO w swoim projekcie.
+
+#### System priorytetów
+
+Gdy wiele pluginów celuje w ten sam klucz słownika, parametr `priority` decyduje, który plugin ma pierwszeństwo:
+
+- Wyższe numery priorytetu wygrywają z niższymi
+- Domyślny priorytet plików `.content` to `0`
+- Domyślny priorytet pluginów to `0`
+- Pluginy o tym samym priorytecie są przetwarzane w kolejności, w jakiej pojawiają się w konfiguracji
+
+```ts fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+import { syncPO } from "@intlayer/sync-po-plugin";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH],
+    defaultLocale: Locales.ENGLISH,
+  },
+
+  plugins: [
+    // Główne źródło PO (najwyższy priorytet)
+    syncPO({
+      source: ({ key, locale }) => `./locales/${locale}/${key}.po`,
+      location: "main-translations",
+      priority: 10,
+    }),
+
+    // Zapasowe źródło PO (niższy priorytet)
+    syncPO({
+      source: ({ locale }) => `./fallback-locales/${locale}.po`,
+      location: "fallback-translations",
+      priority: 5,
+    }),
+
+    // Starsze źródło PO (najniższy priorytet)
+    syncPO({
+      source: ({ locale }) => `/my/other/app/legacy/${locale}/messages.po`,
+      location: "legacy-translations",
+      priority: 1,
+    }),
+  ],
+};
+
+export default config;
+```
+
+## Plugin Load PO
+
+### Szybki start
+
+Dodaj plugin do swojego `intlayer.config.ts`, aby wczytać istniejące pliki PO jako słowniki Intlayer. Ten plugin jest tylko do odczytu (brak zapisu na dysku):
+
+```ts fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+import { loadPO } from "@intlayer/sync-po-plugin";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
+
+  plugins: [
+    // Wczytaj komunikaty PO znajdujące się w dowolnym miejscu w drzewie źródeł
+    loadPO({
+      source: ({ key }) => `./src/**/${key}.i18n.po`,
+      // Ładuj jeden język na instancję pluginu (domyślnie defaultLocale z konfiguracji)
+      locale: Locales.ENGLISH,
+      priority: 0,
+    }),
+  ],
+};
+
+export default config;
+```
+
+Alternatywa: układ według języka, nadal tylko do odczytu (ładowany jest tylko wybrany język):
+
+```ts fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+import { loadPO } from "@intlayer/sync-po-plugin";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH],
+    defaultLocale: Locales.ENGLISH,
+  },
+  plugins: [
+    loadPO({
+      // Tylko pliki dla Locales.FRENCH zostaną wczytane z tego wzorca
+      source: ({ key, locale }) => `./locales/${locale}/${key}.po`,
+      locale: Locales.FRENCH,
+    }),
+  ],
+};
+
+export default config;
+```
+
+### Jak to działa
+
+- Wykrywanie: buduje glob z konstruktora `source` i zbiera pasujące pliki PO.
+- Wczytywanie: ładuje każdy plik PO jako słownik Intlayer z podanym `locale`.
+- Tylko do odczytu: nie zapisuje ani nie formatuje plików wynikowych; użyj `syncPO`, jeśli potrzebujesz synchronizacji w obie strony.
+- Gotowy do automatycznego wypełniania: definiuje ścieżkę `fill`, aby `intlayer content fill` mógł uzupełnić brakujące klucze.
+
+### API
+
+```ts
+loadPO({
+  // Buduj ścieżki do plików PO. `locale` jest opcjonalny, jeśli Twoja struktura nie ma segmentu języka
+  source: ({ key, locale }) => string,
+
+  // Docelowy język dla słowników ładowanych przez tę instancję pluginu
+  // Domyślnie configuration.internationalization.defaultLocale
+  locale?: Locale,
+
+  // Opcjonalna etykieta do identyfikacji źródła
+  location?: string, // domyślnie: "plugin"
+
+  // Priorytet używany do rozwiązywania konfliktów z innymi źródłami
+  priority?: number, // domyślnie: 0
+});
+```
+
+### Zachowanie i konwencje
+
+- Jeśli maska `source` zawiera symbol zastępczy języka, wczytywane są tylko pliki dla wybranego `locale`.
+- Jeśli w masce nie ma segmentu `{key}`, kluczem słownika jest "index".
+- Klucze są wyprowadzane ze ścieżek plików poprzez zastąpienie symbolu zastępczego `{key}` w konstruktorze `source`.
+- Plugin używa tylko wykrytych plików i nie tworzy brakujących języków ani kluczy.
+- Ścieżka `fill` jest wywnioskowana z `source` i używana do aktualizacji brakujących wartości przez CLI, gdy się na to zdecydujesz.
+
+## Rozwiązywanie konfliktów
+
+Gdy ten sam klucz tłumaczenia istnieje w wielu źródłach PO:
+
+1. Plugin o najwyższym priorytecie określa ostateczną wartość
+2. Źródła o niższym priorytecie są używane jako rezerwowe dla brakujących kluczy
+3. Pozwala to na zachowanie starszych tłumaczeń przy jednoczesnym stopniowym przechodzeniu na nowe struktury
+
+## CLI
+
+Zsynchronizowane pliki PO będą traktowane jak inne pliki `.content`. Oznacza to, że wszystkie polecenia intlayer będą dostępne dla zsynchronizowanych plików PO. W tym:
+
+- `intlayer content test` aby przetestować, czy brakuje tłumaczeń
+- `intlayer content list` aby wyświetlić listę zsynchronizowanych plików PO
+- `intlayer content fill` aby wypełnić brakujące tłumaczenia
+- `intlayer content push` aby wysłać zsynchronizowane pliki PO
+- `intlayer content pull` aby pobrać zsynchronizowane pliki PO
+
+Zobacz [Intlayer CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/cli/index.md) po więcej szczegółów.
+
+## Ograniczenia (aktualne)
+
+- Brak wsparcia dla wstawek lub liczb mnogich/ICU przy celowaniu w biblioteki firm trzecich.
+- Edytor wizualny nie jest jeszcze dostępny dla runtime'ów innych niż Intlayer.
+- Tylko synchronizacja PO; formaty katalogów inne niż PO nie są wspierane.
+
+## Dlaczego to ważne
+
+- Możemy polecać uznane rozwiązania i18n i pozycjonować Intlayer jako dodatek.
+- Wykorzystujemy ich SEO/słowa kluczowe za pomocą samouczków, które kończą się sugestią użycia Intlayer do zarządzania plikami PO.
+- Rozszerza grono odbiorców z „nowych projektów” na „każdy zespół korzystający już z i18n”.

package/docs/pt/benchmark/index.md

@@ -30,6 +30,3 @@ Abaixo estão os relatórios detalhados e a documentação técnica de cada fram
 - [**Vue Benchmark Report**](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/benchmark/vue.md)
 - [**Solid Benchmark Report**](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/benchmark/solid.md)
 - [**Svelte Benchmark Report**](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/benchmark/svelte.md)
-- [**Vue Benchmark Report**](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/benchmark/vue.md)
-- [**Solid Benchmark Report**](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/benchmark/solid.md)
-- [**Svelte Benchmark Report**](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/benchmark/svelte.md)