@intlayer/docs 8.9.4-canary.0 → 8.9.5

package/docs/de/dictionary/content_file.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-02-07
-updatedAt: 2026-01-28
+updatedAt: 2026-05-12
 title: Inhaltsdatei
 description: Erfahren Sie, wie Sie die Erweiterungen für Ihre Inhaltsdeklarationsdateien anpassen können. Folgen Sie dieser Dokumentation, um Bedingungen effizient in Ihrem Projekt umzusetzen.
 keywords:
@@ -12,6 +12,9 @@ slugs:
   - concept
   - content
 history:
+  - version: 8.9.0
+    date: 2026-05-12
+    changes: "Inhaltstyp `plural` hinzufügen"
   - version: 8.0.0
     date: 2026-01-28
     changes: "Inhaltstyp-Knoten `html` hinzugefügt"
@@ -66,6 +69,7 @@ import { type ReactNode } from "react";
 import {
   t,
   enu,
+  plural,
   cond,
   nest,
   md,
@@ -84,7 +88,8 @@ interface Content {
     };
   };
   multilingualContent: string; // Mehrsprachiger Inhalt
-  quantityContent: string; // Mengeninhalt
+  quantityContent: string;
+  pluralContent: string; // Mengeninhalt
   conditionalContent: string; // Bedingter Inhalt
   markdownContent: never; // Markdown-Inhalt
   htmlContent: never; // HTML-Inhalt
@@ -121,6 +126,10 @@ export default {
       ">5": "Einige Autos",
       ">19": "Viele Autos",
     }),
+    pluralContent: plural({
+      one: "One car",
+      other: "{{count}} cars",
+    }),
     conditionalContent: cond({
       true: "Validierung ist aktiviert",
       false: "Validierung ist deaktiviert",
@@ -175,6 +184,13 @@ export default {
         ">5": "Einige Autos",
         ">19": "Viele Autos",
       },
+      "pluralContent": {
+        "nodeType": "plural",
+        "plural": {
+          "one": "One car",
+          "other": "{{count}} cars",
+        },
+      },
     },
     "conditionalContent": {
       "nodeType": "condition",
@@ -222,6 +238,7 @@ Inhaltsknoten sind die Bausteine des Wörterbuchinhalts. Sie können sein:
 - **Primitive Werte**: Zeichenketten, Zahlen, Booleans, null, undefined
 - **Typisierte Knoten**: Spezielle Inhaltstypen wie Übersetzungen, Bedingungen, Markdown usw.
 - **Funktionen**: Dynamische Inhalte, die zur Laufzeit ausgewertet werden können [siehe Funktionsabruf](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/dictionary/function_fetching.md)
+- **Plural-Inhalt**: Siehe Plural-Inhalt [Siehe Plural-Inhalt](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/dictionary/plural.md)
 - **Verschachtelte Inhalte**: Verweise auf andere Wörterbücher
 
 #### Inhaltstypen
@@ -540,6 +557,8 @@ multilingualContent: t({
 });
 ```
 
+> Siehe [Übersetzungsinhalt (`t`) Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/dictionary/translation.md) für weitere Informationen.
+
 ### Bedingter Inhalt (`cond`)
 
 Inhalt, der sich basierend auf booleschen Bedingungen ändert:
@@ -553,6 +572,8 @@ conditionalContent: cond({
 });
 ```
 
+> Siehe [Bedingter Inhalt (`cond`) Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/dictionary/condition.md) für weitere Informationen.
+
 ### Aufzählungsinhalt (`enu`)
 
 Inhalt, der auf aufgezählten Werten basiert und variiert:
@@ -567,6 +588,23 @@ statusContent: enu({
 });
 ```
 
+> Siehe [Aufzählungsinhalt (`enu`) Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/dictionary/enumeration.md) für weitere Informationen.
+
+### Plural-Inhalt (`plural`)
+
+Inhalt, der je nach Pluralregeln variiert:
+
+```typescript
+import { plural } from "intlayer";
+
+pluralContent: plural({
+  one: "One car",
+  other: "{{count}} cars",
+});
+```
+
+> Siehe [Plural-Inhalt Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/dictionary/plural.md) für weitere Informationen.
+
 ### Einfügeinhalt (`insert`)
 
 Inhalt, der in anderen Inhalt eingefügt werden kann:
@@ -577,6 +615,8 @@ import { insert } from "intlayer";
 insertionContent: insert("Dieser Text kann überall eingefügt werden");
 ```
 
+> Siehe [Einfügeinhalt (`insert`) Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/dictionary/insertion.md) für weitere Informationen.
+
 ### Verschachtelter Inhalt (`nest`)
 
 Verweise auf andere Wörterbücher:
@@ -587,6 +627,8 @@ import { nest } from "intlayer";
 nestedContent: nest("about-page");
 ```
 
+> Siehe [Verschachtelter Inhalt (`nest`) Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/dictionary/nesting.md) für weitere Informationen.
+
 ### Markdown-Inhalt (`md`)
 
 Rich-Text-Inhalt im Markdown-Format:
@@ -599,6 +641,8 @@ markdownContent: md(
 );
 ```
 
+> Siehe [Markdown-Inhalt (`md`) Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/dictionary/markdown.md) für weitere Informationen.
+
 ### HTML-Inhalt (`html`)
 
 Rich-HTML-Inhalt, der Standard-Tags oder benutzerdefinierte Komponenten verwenden kann:
@@ -616,6 +660,8 @@ localizedHtmlContent: t({
 });
 ```
 
+> Siehe [HTML-Inhalt (`html`) Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/dictionary/html.md) für weitere Informationen.
+
 ### Geschlechtsabhängiger Inhalt (`gender`)
 
 Inhalt, der sich je nach Geschlecht unterscheidet:
@@ -630,6 +676,8 @@ genderContent: gender({
 });
 ```
 
+> Siehe [Geschlechtsabhängiger Inhalt (`gender`) Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/dictionary/gender.md) für weitere Informationen.
+
 ### Dateiinhalt (`file`)
 
 Verweise auf externe Dateien:
@@ -640,6 +688,8 @@ import { file } from "intlayer";
 fileContent: file("./path/to/content.txt");
 ```
 
+> Siehe [Dateiinhalt (`file`) Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/dictionary/file.md) für weitere Informationen.
+
 ## Erstellen von Inhaltsdateien
 
 ### Grundstruktur einer Inhaltsdatei

package/docs/de/mcp_server.md

@@ -51,12 +51,12 @@ Durch die Aktivierung des Intlayer MCP Servers in Ihrer IDE erhalten Sie:
 
   > Die vollständige Liste der Befehle und Optionen finden Sie in der [Intlayer CLI-Dokumentation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/cli/index.md).
 
-## Lokaler Server (stdio) vs. Remote-Server (SSE)
+## Lokaler Server (stdio) vs. Remote-Server (Streamable HTTP)
 
 Der MCP-Server kann auf zwei Arten verwendet werden:
 
 - Lokaler Server (stdio)
-- Remote-Server (SSE)
+- Remote-Server (Streamable HTTP)
 
 ### Lokaler Server (stdio) (empfohlen)
 
@@ -64,7 +64,7 @@ Intlayer stellt ein NPM-Paket bereit, das lokal auf Ihrem Rechner installiert we
 
 Dieser Server ist die empfohlene Methode zur Nutzung des MCP-Servers, da er alle Funktionen des MCP-Servers integriert, einschließlich der CLI-Tools.
 
-### Remote-Server (SSE)
+### Remote-Server (Streamable HTTP)
 
 Der MCP-Server kann auch remote über die SSE-Transportmethode verwendet werden. Dieser Server wird von Intlayer gehostet und ist unter https://mcp.intlayer.org verfügbar. Auf diesen Server kann öffentlich, ohne Authentifizierung zuzugreifen, und die Nutzung ist kostenlos.
 
@@ -97,7 +97,7 @@ bun x intlayer init mcp
 Dieser Befehl wird:
 
 1. Sie fragen, welche Plattform Sie verwenden (Cursor, VS Code, Claude Desktop usw.).
-2. Sie fragen, welche Transportmethode Sie verwenden möchten (lokal (stdio) oder remote (SSE)).
+2. Sie fragen, welche Transportmethode Sie verwenden möchten (lokal (stdio) oder remote (Streamable HTTP)).
 3. Automatisch Ihre Konfigurationsdatei aktualisieren (z. B. `.cursor/mcp.json`, `.vscode/mcp.json` oder die globale Claude Desktop-Konfiguration).
 
 ---
@@ -107,7 +107,7 @@ Dieser Befehl wird:
 1. Öffnen Sie die Befehlspalette (Strg+Umschalt+P oder Cmd+Umschalt+P).
 2. Geben Sie `Intlayer: Setup AI Agent Skills` ein.
 3. Wählen Sie die von Ihnen verwendete Plattform aus (z. B. `VS Code`, `Cursor`, `Windsurf`, `OpenCode`, `Claude Code`, `GitHub Copilot Workspace` usw.).
-4. Wählen Sie den zu installierenden MCP aus (stdio, SSE).
+4. Wählen Sie den zu installierenden MCP aus (stdio, Streamable HTTP).
 5. Drücken Sie die Eingabetaste.
 
 ---
@@ -131,16 +131,16 @@ Fügen Sie im Stammverzeichnis Ihres Projekts die folgende Konfigurationsdatei `
 }
 ```
 
-### Remote-Server (SSE)
+### Remote-Server (Streamable HTTP)
 
-Um eine Verbindung zu einem entfernten Intlayer MCP-Server über Server-Sent Events (SSE) herzustellen, können Sie Ihren MCP-Client so konfigurieren, dass er sich mit dem gehosteten Dienst verbindet.
+Um eine Verbindung zu einem entfernten Intlayer MCP-Server über Server-Sent Events (Streamable HTTP) herzustellen, können Sie Ihren MCP-Client so konfigurieren, dass er sich mit dem gehosteten Dienst verbindet.
 
 ```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 @@ Erstellen Sie eine Datei `.vscode/mcp.json` im Stammverzeichnis Ihres Projekts:
 }
 ```
 
-### Remote-Server (SSE)
+### Remote-Server (Streamable HTTP)
 
-Um eine Verbindung zu einem entfernten Intlayer MCP-Server über Server-Sent Events (SSE) herzustellen, können Sie Ihren MCP-Client so konfigurieren, dass er sich mit dem gehosteten Dienst verbindet.
+Um eine Verbindung zu einem entfernten Intlayer MCP-Server über Server-Sent Events (Streamable HTTP) herzustellen, können Sie Ihren MCP-Client so konfigurieren, dass er sich mit dem gehosteten Dienst verbindet.
 
 ```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 @@ Um eine Verbindung zu einem entfernten Intlayer MCP-Server über Server-Sent Eve
 
 ## Einrichtung in ChatGPT
 
-### Remote-Server (SSE)
+### Remote-Server (Streamable HTTP)
 
 Folgen Sie der [offiziellen Dokumentation](https://platform.openai.com/docs/mcp#test-and-connect-your-mcp-server), um den MCP-Server in ChatGPT zu konfigurieren.
 
@@ -231,6 +231,19 @@ Pfad der Konfigurationsdatei:
 }
 ```
 
+### Remote-Server (Streamable HTTP)
+
+```json fileName="claude_desktop_config.json"
+{
+  "mcpServers": {
+    "intlayer-sse": {
+      "command": "npx",
+      "args": ["-y", "mcp-remote@latest", "https://mcp.intlayer.org"]
+    }
+  }
+}
+```
+
 ---
 
 ## Verwendung des MCP-Servers über die CLI

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

@@ -0,0 +1,332 @@
+---
+createdAt: 2026-05-10
+updatedAt: 2026-05-10
+title: Sync PO Plugin
+description: Synchronisieren Sie Intlayer-Wörterbücher mit Gettext PO-Dateien. Behalten Sie Ihr bestehendes i18n bei, während Sie Intlayer zum Verwalten, Übersetzen und Testen Ihrer Nachrichten verwenden.
+keywords:
+  - Intlayer
+  - Sync PO
+  - Gettext
+  - i18n
+  - Übersetzungen
+slugs:
+  - doc
+  - plugin
+  - sync-po
+youtubeVideo: https://www.youtube.com/watch?v=MpGMxniDHNg
+history:
+  - version: 8.9.4
+    date: 2026-05-10
+    changes: "Erste Dokumentation für das Sync PO Plugin"
+---
+
+# Sync PO (i18n Brücken) - Sync PO mit ICU / i18next Unterstützung
+
+Verwenden Sie Intlayer als Add-on zu Ihrem bestehenden i18n-Stack. Dieses Plugin hält Ihre Gettext PO-Nachrichten mit Intlayer-Wörterbüchern synchron, damit Sie:
+
+- Ihren bestehenden PO-basierten Übersetzungs-Workflow beibehalten können.
+- Ihre Nachrichten mit Intlayer (CLI, CI, Anbieter, CMS) verwalten und übersetzen können, ohne Ihre App zu refaktorisieren.
+- Tutorials und SEO-Inhalte für jedes Ökosystem bereitstellen können, während Sie Intlayer als PO-Verwaltungsebene vorschlagen.
+
+Hinweise und aktueller Umfang:
+
+- Externalisierung in das CMS funktioniert für Übersetzungen und klassischen Text.
+- Noch keine Unterstützung für Platzhalter, Plurale/ICU oder fortgeschrittene Laufzeitfunktionen anderer Bibliotheken innerhalb der PO-Einträge selbst.
+- Der visuelle Editor wird für i18n-Ausgaben von Drittanbietern noch nicht unterstützt.
+
+### Wann Sie dieses Plugin verwenden sollten
+
+- Sie verwenden bereits Gettext PO-Dateien für Ihre Übersetzungen.
+- Sie möchten KI-gestütztes Ausfüllen, Tests in der CI und Content-Ops nutzen, ohne Ihre Rendering-Laufzeit zu ändern.
+
+## Installation
+
+```bash
+pnpm add -D @intlayer/sync-po-plugin
+# oder
+npm i -D @intlayer/sync-po-plugin
+```
+
+## Plugins
+
+Dieses Paket bietet zwei Plugins:
+
+- `loadPO`: Lädt PO-Dateien in Intlayer-Wörterbücher.
+  - Dieses Plugin wird verwendet, um PO-Dateien aus einer Quelle zu laden und in Intlayer-Wörterbücher zu integrieren. Es kann die gesamte Codebasis scannen und nach spezifischen PO-Dateien suchen.
+    Dieses Plugin kann verwendet werden:
+    - wenn Sie eine i18n-Bibliothek verwenden, die einen bestimmten Ort für das Laden Ihrer PO-Dateien vorschreibt, Sie aber Ihre Inhaltsdeklaration an einer beliebigen Stelle in Ihrer Codebasis platzieren möchten.
+    - Es kann auch verwendet werden, wenn Sie Ihre Nachrichten von einer Remote-Quelle (z. B. einem CMS, einer API usw.) abrufen und Ihre Nachrichten in PO-Dateien speichern möchten.
+
+  > Unter der Haube scannt dieses Plugin die gesamte Codebasis, sucht nach spezifischen PO-Dateien und lädt sie in Intlayer-Wörterbücher.
+  > Beachten Sie, dass dieses Plugin die Ausgabe und Übersetzungen nicht zurück in die PO-Dateien schreibt.
+
+- `syncPO`: Synchronisiert PO-Dateien mit Intlayer-Wörterbüchern.
+  - Dieses Plugin wird verwendet, um PO-Dateien mit Intlayer-Wörterbüchern zu synchronisieren. Es kann den angegebenen Ort scannen und die PO-Dateien laden, die dem Muster für spezifische PO-Dateien entsprechen. Dieses Plugin ist nützlich, wenn Sie die Vorteile von Intlayer nutzen möchten, während Sie eine andere i18n-Bibliothek verwenden.
+
+## Verwendung beider Plugins
+
+```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,
+  },
+
+  // Halten Sie Ihre aktuellen PO-Dateien mit Intlayer-Wörterbüchern synchron
+  plugins: [
+    /**
+     * Lädt alle PO-Dateien in src, die dem Muster {key}.i18n.po entsprechen
+     */
+    loadPO({
+      source: ({ key }) => `./src/**/${key}.i18n.po`,
+      locale: Locales.ENGLISH,
+      priority: 1, // Stellt sicher, dass diese PO-Dateien Vorrang vor Dateien unter `./locales/en/${key}.po` haben
+    }),
+    /**
+     * Lädt die Ausgabe und Übersetzungen und schreibt sie zurück in die PO-Dateien im Verzeichnis locales
+     */
+    syncPO({
+      source: ({ key, locale }) => `./locales/${locale}/${key}.po`,
+      priority: 0,
+    }),
+  ],
+};
+
+export default config;
+```
+
+## `syncPO` Plugin
+
+### Schnellstart
+
+Fügen Sie das Plugin zu Ihrer `intlayer.config.ts` hinzu und verweisen Sie auf Ihre bestehende PO-Struktur.
+
+```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,
+  },
+
+  // Halten Sie Ihre aktuellen PO-Dateien mit Intlayer-Wörterbüchern synchron
+  plugins: [
+    syncPO({
+      // Layout pro Sprache und pro Namespace
+      source: ({ key, locale }) => `./locales/${locale}/${key}.po`,
+    }),
+  ],
+};
+
+export default config;
+```
+
+Alternative: Eine Datei pro Sprache:
+
+```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;
+```
+
+#### Wie es funktioniert
+
+- Lesen: Das Plugin entdeckt PO-Dateien über Ihren `source`-Builder und lädt sie als Intlayer-Wörterbücher.
+- Schreiben: Nach dem Build und Ausfüllen schreibt es lokalisierte PO-Dateien zurück in dieselben Pfade (mit korrekten Gettext-Headern).
+- Automatisches Ausfüllen: Das Plugin deklariert einen `autoFill`-Pfad für jedes Wörterbuch. Das Ausführen von `intlayer fill` aktualisiert standardmäßig nur fehlende Übersetzungen in Ihren PO-Dateien.
+
+API:
+
+```ts
+syncPO({
+  source: ({ key, locale }) => string, // erforderlich
+  location?: string, // optionales Label, Standard: "sync-po::path/to/source"
+  priority?: number, // optionale Priorität für die Konfliktlösung, Standard: 0
+```
+
+### Mehrere PO-Quellen und Priorität
+
+Sie können mehrere `syncPO`-Plugins hinzufügen, um verschiedene PO-Quellen zu synchronisieren. Dies ist nützlich, wenn Sie mehrere Übersetzungsquellen oder unterschiedliche PO-Strukturen in Ihrem Projekt haben.
+
+#### Prioritätssystem
+
+Wenn mehrere Plugins auf denselben Wörterbuchschlüssel abzielen, bestimmt der Parameter `priority`, welches Plugin Vorrang hat:
+
+- Höhere Prioritätszahlen gewinnen gegenüber niedrigeren
+- Die Standardpriorität von `.content`-Dateien ist `0`
+- Die Standardpriorität von Plugins ist `0`
+- Plugins mit derselben Priorität werden in der Reihenfolge verarbeitet, in der sie in der Konfiguration erscheinen
+
+```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: [
+    // Primäre PO-Quelle (höchste Priorität)
+    syncPO({
+      source: ({ key, locale }) => `./locales/${locale}/${key}.po`,
+      location: "main-translations",
+      priority: 10,
+    }),
+
+    // Fallback PO-Quelle (niedrigere Priorität)
+    syncPO({
+      source: ({ locale }) => `./fallback-locales/${locale}.po`,
+      location: "fallback-translations",
+      priority: 5,
+    }),
+
+    // Legacy PO-Quelle (niedrigste Priorität)
+    syncPO({
+      source: ({ locale }) => `/my/other/app/legacy/${locale}/messages.po`,
+      location: "legacy-translations",
+      priority: 1,
+    }),
+  ],
+};
+
+export default config;
+```
+
+## Load PO Plugin
+
+### Schnellstart
+
+Fügen Sie das Plugin zu Ihrer `intlayer.config.ts` hinzu, um bestehende PO-Dateien als Intlayer-Wörterbücher zu erfassen. Dieses Plugin ist schreibgeschützt (keine Schreibvorgänge auf die Festplatte):
+
+```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: [
+    // Erfassen Sie PO-Nachrichten, die sich an einer beliebigen Stelle in Ihrem Quellbaum befinden
+    loadPO({
+      source: ({ key }) => `./src/**/${key}.i18n.po`,
+      // Lädt eine einzelne Sprache pro Plugin-Instanz (standardmäßig die defaultLocale der Konfiguration)
+      locale: Locales.ENGLISH,
+      priority: 0,
+    }),
+  ],
+};
+
+export default config;
+```
+
+Alternative: Layout pro Sprache, weiterhin schreibgeschützt (nur die ausgewählte Sprache wird geladen):
+
+```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({
+      // Nur Dateien für Locales.FRENCH werden über dieses Muster geladen
+      source: ({ key, locale }) => `./locales/${locale}/${key}.po`,
+      locale: Locales.FRENCH,
+    }),
+  ],
+};
+
+export default config;
+```
+
+### Wie es funktioniert
+
+- Entdecken: Erstellt einen Glob aus Ihrem `source`-Builder und sammelt passende PO-Dateien.
+- Erfassen: Lädt jede PO-Datei mit der angegebenen `locale` als Intlayer-Wörterbuch.
+- Schreibgeschützt: Schreibt oder formatiert keine Ausgabedateien; verwenden Sie `syncPO`, wenn Sie eine bidirektionale Synchronisierung benötigen.
+- Bereit für automatisches Ausfüllen: Definiert einen `fill`-Pfad, damit `intlayer content fill` fehlende Schlüssel ausfüllen kann.
+
+### API
+
+```ts
+loadPO({
+  // Pfade zu Ihren PO-Dateien erstellen. `locale` ist optional, wenn Ihre Struktur kein Sprachsegment hat
+  source: ({ key, locale }) => string,
+
+  // Zielsprache für die von dieser Plugin-Instanz geladenen Wörterbücher
+  // Standardmäßig configuration.internationalization.defaultLocale
+  locale?: Locale,
+
+  // Optionales Label zur Identifizierung der Quelle
+  location?: string, // Standard: "plugin"
+
+  // Priorität für die Konfliktlösung mit anderen Quellen
+  priority?: number, // Standard: 0
+});
+```
+
+### Verhalten und Konventionen
+
+- Wenn Ihre `source`-Maske einen Sprach-Platzhalter enthält, werden nur Dateien für die ausgewählte `locale` erfasst.
+- Wenn kein `{key}`-Segment in Ihrer Maske vorhanden ist, lautet der Wörterbuchschlüssel "index".
+- Schlüssel werden aus Dateipfaden abgeleitet, indem der Platzhalter `{key}` in Ihrem `source`-Builder ersetzt wird.
+- Das Plugin verwendet nur entdeckte Dateien und erzeugt keine fehlenden Sprachen oder Schlüssel.
+- Der `fill`-Pfad wird aus Ihrer `source` abgeleitet und verwendet, um fehlende Werte über die CLI zu aktualisieren, wenn Sie sich dafür entscheiden.
+
+## Konfliktlösung
+
+Wenn derselbe Übersetzungsschlüssel in mehreren PO-Quellen vorhanden ist:
+
+1. Das Plugin mit der höchsten Priorität bestimmt den endgültigen Wert
+2. Quellen mit niedrigerer Priorität werden als Fallback für fehlende Schlüssel verwendet
+3. Dies ermöglicht es Ihnen, Legacy-Übersetzungen beizubehalten, während Sie schrittweise zu neuen Strukturen migrieren
+
+## CLI
+
+Die synchronisierten PO-Dateien werden wie andere `.content`-Dateien behandelt. Das bedeutet, dass alle Intlayer-Befehle für die synchronisierten PO-Dateien verfügbar sind. Einschließlich:
+
+- `intlayer content test`, um zu testen, ob Übersetzungen fehlen
+- `intlayer content list`, um die synchronisierten PO-Dateien aufzulisten
+- `intlayer content fill`, um fehlende Übersetzungen auszufüllen
+- `intlayer content push`, um die synchronisierten PO-Dateien hochzuladen
+- `intlayer content pull`, um die synchronisierten PO-Dateien herunterzuladen
+
+Weitere Details finden Sie im [Intlayer CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/cli/index.md).
+
+## Einschränkungen (aktuell)
+
+- Keine Unterstützung für Platzhalter oder Plurale/ICU bei der Zieladressierung von Drittanbieter-Bibliotheken.
+- Der visuelle Editor ist für Nicht-Intlayer-Laufzeiten noch nicht verfügbar.
+- Nur PO-Synchronisation; andere Katalogformate als PO werden nicht unterstützt.
+
+## Warum das wichtig ist
+
+- Wir können etablierte i18n-Lösungen empfehlen und Intlayer als Add-on positionieren.
+- Wir nutzen deren SEO/Keywords mit Tutorials, die damit enden, Intlayer für die PO-Verwaltung vorzuschlagen.
+- Erweitert die Zielgruppe von „neuen Projekten“ auf „jedes Team, das bereits i18n verwendet“.

package/docs/en/benchmark/nextjs.md

@@ -61,6 +61,13 @@ Because the problem is hard, many solutions exist—some focused on DX, others o
 
 Intlayer tries to optimize across these dimensions.
 
+## TL;DR
+
+- **Intlayer** & **next-translate**: Top picks for Next.js performance, offering the smallest footprint and best static rendering support.
+- **next-intl**: Trendiest option but heavy and complex to optimize for large applications.
+- **next-i18next**: Popular and plugin-rich, but carries significant bundle weight (~3× Intlayer).
+- **Avoid**: **gt-next** and **lingo.dev** due to severe performance issues, vendor lock-in, and build-breaking bugs.
+
 ## Test your app
 
 To surface these issues, I built a free scanner you can try [here](https://intlayer.org/i18n-seo-scanner).
@@ -99,7 +106,7 @@ Finally, `Intlayer` applies a build-time optimization so `useIntlayer('my-key')`
 For this benchmark, we compared the following libraries:
 
 - `Base App` (No i18n library)
-- `next-intlayer` (v8.7.5)
+- `next-intlayer` (v8.7.12)
 - `next-i18next` (v16.0.5)
 - `next-intl` (v4.9.1)
 - `@lingui/core` (v5.3.0)
@@ -187,6 +194,8 @@ Personally I dislike having to regenerate JS files before every push, which crea
 Even if in theory the tree-shaking strategy works, it does include all locales in the bundle anyway. Paraglide offers no way to lazy-load the content. That means your page size grows in line with the number of locales you have.
 Finally, in comparison with other solutions, Paraglide does not use a store (e.g. React context) to retrieve the current locale to render the content. For each node parsed, it will request the locale from the localStorage / cookie etc. It leads to execution of unnecessary logic that impacts the component reactivity.
 
+> Note on paraglide: the solution inject code in your codebase to import, as a result the metric 'lib size' in the benchmark report is almost 0. Code gen is a good think, because the function used will include only the necessary logic (prefix all vs no prefix, cookie vs storage etc). In comparison Intlayer process to this filtering using env variables injections in the build to force the bundler to tree shake the content depending of the logic. Thanks to this, paraglide and intlayer end up being solution 6-10 times lighter than i18next or next-intl.
+
 ### 3 - Acceptable solutions
 
 **(Tolgee)** (`@tolgee/react@7.0.0`):
@@ -217,7 +226,7 @@ Message formats also differ: `next-intl` uses ICU MessageFormat, while `i18next`
 
 `next-translate` is my main recommendation if you like a `t()`-style API. It is elegant via `next-translate-plugin`, loading namespaces through `getStaticProps` with a Webpack / Turbopack loader. It is also the lightest option here (~2.5kb). For namespacing, defining namespaces per page or route in config is well thought out and easier to maintain than main alternatives like **next-intl** or **next-i18next**. In version `3.1.2`, I noted that static rendering did not work; Next.js fell back to dynamic rendering.
 
-**(Intlayer)** (`next-intlayer@8.7.5`):
+**(Intlayer)** (`next-intlayer@8.7.12`):
 
 I will not personally judge `next-intlayer` for objectivity’s sake, since it is my own solution.