@intlayer/docs 8.12.5-canary.0 → 9.0.0-canary.10

package/docs/de/compat/next-i18next.md

@@ -0,0 +1,57 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migration von next-i18next zu Intlayer"
+description: "Erfahren Sie, wie Sie Ihre Next.js-Anwendung von next-i18next zu Intlayer mithilfe des Compat-Adapters migrieren."
+keywords:
+  - next-i18next
+  - nextjs
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - next-i18next
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Verlauf initialisiert"
+author: aymericzip
+---
+
+# Migration von next-i18next zu Intlayer
+
+Für ein vollständiges und detailliertes Schritt-für-Schritt-Tutorial lesen Sie bitte unsere vollständige [next-i18next Migrationsanleitung](../migration_from_next-i18next_to_intlayer.md).
+
+Intlayer behandelt alle Next.js Pages Router- und App Router-Implementierungen transparent. Die Verwendung des Adapters ermöglicht Ihnen die Migration Ihrer `next-i18next`-Implementierung ohne Code-Umschreiben.
+
+## Was zu tun ist
+
+Um zu beginnen, führen Sie aus:
+
+```bash
+npx intlayer init
+```
+
+Dies erstellt die erforderliche Intlayer-Setup-Datei. Um im Hintergrund zu Intlayer zu wechseln, aktualisieren Sie Ihre `next.config.ts`:
+
+```typescript fileName="next.config.ts"
+import type { NextConfig } from "next";
+import { createNextI18nPlugin } from "@intlayer/next-i18next/plugin";
+
+const withIntlayer = createNextI18nPlugin();
+
+const nextConfig: NextConfig = {};
+
+export default withIntlayer(nextConfig);
+```
+
+## Was im Hintergrund geschieht
+
+Das `createNextI18nPlugin` kombiniert das native Verhalten von Next.js mit dem Kern-`next-intlayer`-Plugin und injiziert alle erforderlichen Webpack/Turbopack-Aliase für `next-i18next`, `react-i18next` und `i18next`.
+
+Im Hintergrund:
+
+- **`serverSideTranslations` & `appWithTranslation`:** Sie fungieren nun als Wrapper für Intlayers interne Loader und umgehen die umfangreiche statische JSON-Injektion.
+- **Client-Hooks:** Delegiert sofort an `@intlayer/react-i18next` und behält alle Formatierungs-, Plural- und verschachtelte Namespace-Funktionen bei.

package/docs/de/compat/next-intl.md

@@ -0,0 +1,59 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migration von next-intl zu Intlayer"
+description: "Erfahren Sie, wie Sie Ihre Next.js-Anwendung von next-intl zu Intlayer mithilfe des Compat-Adapters migrieren."
+keywords:
+  - next-intl
+  - nextjs
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - next-intl
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Verlauf initialisiert"
+author: aymericzip
+---
+
+# Migration von next-intl zu Intlayer
+
+Für ein vollständiges und detailliertes Schritt-für-Schritt-Tutorial lesen Sie bitte unsere vollständige [next-intl Migrationsanleitung](../migration_from_next-intl_to_intlayer.md).
+
+Die Migration von `next-intl` zu Intlayer ermöglicht es Ihnen, Ihr Anwendungsrouting und Ihre Syntax vollständig ungestört beizubehalten.
+
+## Was zu tun ist
+
+Führen Sie den folgenden Befehl in Ihrem Repository aus:
+
+```bash
+npx intlayer init
+```
+
+Dadurch wird eine `intlayer.config.ts` erstellt. Verwenden Sie in Ihrer `next.config.ts` den Plugin-Wrapper, um die `next-intl`-Aliase nahtlos zu `@intlayer/next-intl` weiterzuleiten.
+
+```typescript fileName="next.config.ts"
+import type { NextConfig } from "next";
+import { createNextIntlPlugin } from "@intlayer/next-intl/plugin";
+
+const withIntlayer = createNextIntlPlugin();
+
+const nextConfig: NextConfig = {};
+
+export default withIntlayer(nextConfig);
+```
+
+## Was im Hintergrund geschieht
+
+Der Bundler-Wrapper ersetzt Übersetzungen, **lässt die `next-intl/navigation`-Funktionen jedoch intakt** (z.B. `Link`, `redirect`, `usePathname`).
+
+Im Hintergrund:
+
+- **ICU-Laufzeit:** Plurale (`=0`, `one`, `other`), select/selectordinal, `#`-Argumente und formatierte Argumente (`{ts, date, long}`) werden korrekt mit dem gemeinsamen `resolveMessage(..., 'icu')`-Resolver ausgeführt.
+- **`useTranslations()` & `getTranslations()`:** Die einfachen Scope-Aufrufe extrahieren das erste Schlüsselsegment als korrekten Wörterbuch-Bezeichner. Verschachtelte Namespaces werden elegant in Wörterbuchpfade und Präfixe aufgeteilt.
+- **Rich Formatting:** Sowohl `t.rich()` als auch `t.markup()` sind vollständig nativ implementiert und konvertieren HTML-ähnliche Knoten in gerenderte React-Abschnitte.
+- **`useFormatter`:** `relativeTime`, `list`, `dateTimeRange` und benannte Formate aus der Konfiguration überbrücken zu den nativen `Intl`-Formatierern des Kerns.

package/docs/de/compat/next-translate.md

@@ -0,0 +1,45 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migration von Next Translate zu Intlayer"
+description: "Erfahren Sie, wie Sie Ihre Next.js-Anwendung von next-translate zu Intlayer mithilfe des Compat-Adapters migrieren."
+keywords:
+  - next-translate
+  - nextjs
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - next-translate
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Verlauf initialisiert"
+author: aymericzip
+---
+
+# Migration von Next Translate zu Intlayer
+
+Die Migration von `next-translate` zu Intlayer ist ein nahezu direkter Ersatz, der Ihre bestehende Syntax und Tags beibehält.
+
+## Was zu tun ist
+
+Initialisieren Sie Intlayer in Ihrem Projekt:
+
+```bash
+npx intlayer init
+```
+
+Die CLI richtet Ihre Konfiguration ein. Anschließend können Sie das Intlayer-Plugin in Ihrer `next.config.ts` anwenden, das Build-Zeit-Subpfad-Aliase injiziert und `next-translate/useTranslation` auf `@intlayer/next-translate` abbildet.
+
+## Was im Hintergrund geschieht
+
+`next-translate` stellt Hooks wie `useTranslation('ns')`, `t('ns:key.path')` und die `<Trans>`-Komponente bereit.
+
+Im Hintergrund:
+
+- **Interpolation & Plurale:** Es basiert eng auf dem `react-i18next`-Adapter-Verhalten. `{{var}}`-Platzhalter und Pluralisierung, die aus Suffixen wie `key_0`, `key_one` und `key_other` zugeordnet werden, werden dynamisch behandelt.
+- **`<Trans>`-Komponente:** Direkt unterstützt für HTML-ähnliches Tag-Parsing neben einem arraybasierten `components`-Prop.
+- **Namespaces:** Subpfad-Aliasing stellt sicher, dass Ihr `useTranslation` auf die korrekten internen Wörterbuch-Namespaces verweist, ohne manuelle Änderungen.

package/docs/de/compat/ngx-translate.md

@@ -0,0 +1,45 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migration von NGX-Translate zu Intlayer"
+description: "Erfahren Sie, wie Sie Ihre Angular-Anwendung von ngx-translate zu Intlayer mithilfe des Compat-Adapters migrieren."
+keywords:
+  - ngx-translate
+  - angular
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - ngx-translate
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Verlauf initialisiert"
+author: aymericzip
+---
+
+# Migration von NGX-Translate zu Intlayer
+
+Die Migration Ihrer Angular-Anwendung von `ngx-translate` zu Intlayer ist mit dem Compat-Adapter einfach und ermöglicht es Ihnen, die Notwendigkeit zu umgehen, alle Ihre Templates umzuschreiben.
+
+## Was zu tun ist
+
+Beginnen Sie mit der Ausführung von:
+
+```bash
+npx intlayer init
+```
+
+Dadurch wird die `intlayer.config.ts` eingerichtet. Ersetzen Sie Ihre `TranslateModule.forRoot()`-Setups und importieren Sie Aliase entsprechend, um auf `@intlayer/ngx-translate` zu verweisen.
+
+## Was im Hintergrund geschieht
+
+`ngx-translate` verwendet `TranslateService` (`instant`, `get`, `stream`) neben der `{{ 'KEY' | translate:params }}`-Pipe und der `[translate]`-Direktive.
+
+Im Hintergrund:
+
+- **Services:** `TranslateService` umhüllt `getIntlayer` und ein Locale-Observable und stellt genau dieselben Methoden bereit.
+- **Pipes & Direktiven:** Neu implementiert, um direkt gegen Intlayer-Wörterbücher aufzulösen.
+- **Loader:** `TranslateHttpLoader`-Setups werden in Warn-Stubs umgewandelt, da Intlayer Ihre Wörterbücher zur Build-Zeit (oder durch standardmäßige dynamische Imports) inhärent auflöst und bündelt und die Notwendigkeit von HTTP-Loadern vollständig eliminiert.

package/docs/de/compat/nuxtjs-i18n.md

@@ -0,0 +1,46 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migration von NuxtJS I18n zu Intlayer"
+description: "Erfahren Sie, wie Sie Ihre Nuxt.js-Anwendung von @nuxtjs/i18n zu Intlayer mithilfe des Compat-Adapters migrieren."
+keywords:
+  - nuxtjs-i18n
+  - nuxt
+  - vue
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - nuxtjs-i18n
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Verlauf initialisiert"
+author: aymericzip
+---
+
+# Migration von NuxtJS I18n zu Intlayer
+
+Die Migration Ihrer Nuxt-Anwendung von `@nuxtjs/i18n` zu Intlayer ist ein nahtloser Prozess mithilfe des Nuxt-Adapter-Moduls.
+
+## Was zu tun ist
+
+Um das Projekt zu initialisieren, führen Sie aus:
+
+```bash
+npx intlayer init
+```
+
+Dadurch wird `intlayer.config.ts` eingerichtet. Fügen Sie dann das Intlayer Nuxt-Modul (z.B. `@intlayer/nuxt-i18n`) in Ihrem `nuxt.config.ts`-Module-Array hinzu. Dies wendet automatisch die Compat-Konfiguration für Ihre Anwendung an.
+
+## Was im Hintergrund geschieht
+
+`@nuxtjs/i18n` umhüllt `vue-i18n` und stellt Nuxt-spezifische Routing-Composables bereit (`useLocalePath`, `useSwitchLocalePath`, `<NuxtLinkLocale>`).
+
+Im Hintergrund:
+
+- **Übersetzungen:** Basiert nativ auf dem `@intlayer/vue-i18n`-Compat-Layer für alle Zeichenketten-Übersetzungsaufgaben (vollständige Unterstützung von `vue-i18n`-Formaten, Pipe-Pluralen und Reaktivität).
+- **Routing:** Spiegelt die Routing-Composables mithilfe der lokalisierten URL-Helfer von Intlayer.
+- **Konfiguration:** Liest die `availableLocales` und Standardeinstellungen direkt aus Ihrer `intlayer.config.ts`, um Nuxt-Seiten automatisch zu koordinieren.

package/docs/de/compat/polyglot.md

@@ -0,0 +1,45 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migration von Polyglot.js zu Intlayer"
+description: "Erfahren Sie, wie Sie von Polyglot.js zu Intlayer mithilfe des Compat-Adapters migrieren."
+keywords:
+  - polyglot
+  - airbnb
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - polyglot
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Verlauf initialisiert"
+author: aymericzip
+---
+
+# Migration von Polyglot.js zu Intlayer
+
+Wenn Sie Airbnbs Polyglot.js verwenden, ist die Migration zu Intlayer mithilfe des Compat-Layers äußerst unkompliziert.
+
+## Was zu tun ist
+
+Führen Sie einfach den Initialisierungsbefehl in Ihrem Projekt aus:
+
+```bash
+npx intlayer init
+```
+
+Dadurch wird `intlayer.config.ts` generiert. Sie können dann den Bundler-Plugin-Alias verwenden, um Polyglot-Imports transparent zu `@intlayer/polyglot` weiterzuleiten.
+
+## Was im Hintergrund geschieht
+
+Die Syntax von Polyglot.js basiert typischerweise auf `polyglot.t('key', {name})` mit `%{name}`-Interpolationen und `smart_count`-Pluralen, die durch `"singular |||| plural"` getrennt sind.
+
+Im Hintergrund:
+
+- **Interpolation:** Der Compat-Layer behandelt `%{var}`-Platzhalter nativ.
+- **Plurale:** Die Zeichenkette wird bei `||||` aufgeteilt und gegen native `Intl.PluralRules` gemäß der aktiven Locale ausgewertet, wobei Polygots eigene Bucket-Reihenfolge pro Locale gespiegelt wird.
+- **Wörterbücher:** Sie umgehen die Notwendigkeit, riesige JSON-Konfigurationen an `new Polyglot()` bereitzustellen – Intlayer verwaltet die Wörterbücher dynamisch und bereinigt sie automatisch.

package/docs/de/compat/react-i18next.md

@@ -0,0 +1,58 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migration von react-i18next zu Intlayer"
+description: "Erfahren Sie, wie Sie Ihre React-Anwendung von react-i18next zu Intlayer mithilfe des Compat-Adapters migrieren."
+keywords:
+  - react-i18next
+  - i18next
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - react-i18next
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Verlauf initialisiert"
+author: aymericzip
+---
+
+# Migration von react-i18next zu Intlayer
+
+Für ein vollständiges und detailliertes Schritt-für-Schritt-Tutorial lesen Sie bitte unsere vollständige [react-i18next Migrationsanleitung](../migration_from_react-i18next_to_intlayer.md).
+
+Die Verwendung des Compat-Adapters von Intlayer ermöglicht Ihnen die Migration von `react-i18next` ohne Änderungen an den Imports Ihres Quellcodes.
+
+## Was zu tun ist
+
+Um das Projekt zu initialisieren, führen Sie aus:
+
+```bash
+npx intlayer init
+```
+
+Während der Initialisierung installiert Intlayer `@intlayer/react-i18next` und erstellt `intlayer.config.ts`. Wenden Sie in Ihrem Bundler (wie Vite) das Intlayer-Plugin an:
+
+```typescript fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import react from "@vitejs/plugin-react";
+import { reactI18nextVitePlugin } from "@intlayer/react-i18next/plugin";
+
+export default defineConfig({
+  plugins: [react(), reactI18nextVitePlugin()],
+});
+```
+
+## Was im Hintergrund geschieht
+
+Das `reactI18nextVitePlugin` umhüllt das Kern-`vite-intlayer`-Plugin und injiziert Auflösungs-Aliase für `react-i18next` und `i18next`, die sie zu `@intlayer/react-i18next` und `@intlayer/i18next` weiterleiten.
+
+Im Hintergrund:
+
+- **`useTranslation` & `withTranslation`:** Neu geschrieben, um Intlayers native Hooks zu verwenden, und bietet Ihnen automatische TypeScript-Vervollständigung für Ihre Wörterbuchschlüssel. Unterstützt nahtlos Namespaces (z.B. `t('namespace:key')`).
+- **Plurale & Kontext:** Behandelt i18nexts suffixbasierte Pluralisierung (`key_one`, `key_other`) mithilfe nativer `Intl.PluralRules` und Kontextsuffixe (`key_male`).
+- **`<Trans>`-Komponente:** Neu implementiert, um das `components`-Prop, Objekt- und Array-Formen und nummerierte Tags `<1>...</1>` zu unterstützen, die direkt Ihren React-Knoten zugeordnet werden.
+- **`i18n`-Instanz:** Löst Schlüssel direkt aus Intlayer auf, ohne große JSON-Dateien abzurufen, was zu deutlich kleineren Bundle-Größen führt.

package/docs/de/compat/react-intl.md

@@ -0,0 +1,55 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migration von React Intl zu Intlayer"
+description: "Erfahren Sie, wie Sie Ihre React-Anwendung von react-intl zu Intlayer mithilfe des Compat-Adapters migrieren."
+keywords:
+  - react-intl
+  - formatjs
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - react-intl
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Verlauf initialisiert"
+author: aymericzip
+---
+
+# Migration von React Intl zu Intlayer
+
+Wenn Ihre React-Anwendung `react-intl` (FormatJS) verwendet, ist der Übergang zu Intlayer ein Kinderspiel. Unser Compat-Layer behandelt ICU MessageFormat und alle bestehenden `Formatted*`-Komponenten nahtlos.
+
+## Was zu tun ist
+
+Beginnen Sie mit der Ausführung des Initialisierungsbefehls in Ihrem Projekt:
+
+```bash
+npx intlayer init
+```
+
+Richten Sie dann das Intlayer Vite- oder Next.js-Plugin in Ihrer Konfiguration ein. Dieses Plugin injiziert Build-Zeit-Aliase, um `react-intl`-Imports zu `@intlayer/react-intl` weiterzuleiten.
+
+```typescript fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import react from "@vitejs/plugin-react";
+import reactIntlVitePlugin from "@intlayer/react-intl/plugin";
+
+export default defineConfig({
+  plugins: [react(), reactIntlVitePlugin()],
+});
+```
+
+## Was im Hintergrund geschieht
+
+Das Bundler-Plugin aliasiert `react-intl` zu `@intlayer/react-intl`. Anstatt große JSON-Dateien manuell zu parsen und Ihre Anwendung in einem `IntlProvider` zu umhüllen, extrahiert das Intlayer-Plugin Schlüssel statisch und verwendet Intlayer-Wörterbücher zur Laufzeit.
+
+Im Hintergrund:
+
+- **ICU MessageFormat:** Intlayer verwendet den `resolveMessage(..., 'icu')`-Resolver, der die ICU-Pluralisierung, Auswahl, Datums-/Zahlenformatierung und Rich-Text-Tags vollständig nativ unterstützt.
+- **Methoden- & JSX-Aufrufer:** `intl.formatMessage({ id: 'a.b' })` und `<FormattedMessage id="a.b">` werden durch die Intlayer-Compiler-Plugins (`@intlayer/babel` / `@intlayer/swc`) identifiziert, wobei flache, gepunktete Schlüssel so konvertiert werden, dass das erste Segment korrekt zum Intlayer-Wörterbuchschlüssel aufgelöst wird.
+- **Formatter:** `<FormattedNumber>`, `<FormattedDate>` etc. überbrücken zu den nativen `core/formatters` mithilfe von `Intl`.

package/docs/de/compat/svelte-i18n.md

@@ -0,0 +1,47 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migration von Svelte I18n zu Intlayer"
+description: "Erfahren Sie, wie Sie Ihre Svelte-Anwendung von svelte-i18n zu Intlayer mithilfe des Compat-Adapters migrieren."
+keywords:
+  - svelte-i18n
+  - svelte
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - svelte-i18n
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Verlauf initialisiert"
+author: aymericzip
+---
+
+# Migration von Svelte I18n zu Intlayer
+
+Das Verschieben Ihrer Svelte-Anwendung von `svelte-i18n` zu Intlayer dauert mit dem Compat-Adapter nur einen Moment.
+
+## Was zu tun ist
+
+Führen Sie einfach den Initialisierungsbefehl in Ihrem Projekt aus:
+
+```bash
+npx intlayer init
+```
+
+Dadurch wird `intlayer.config.ts` generiert. Stellen Sie sicher, dass Ihre SvelteKit/Vite-Plugins mit Intlayers Alias-Plugin umhüllt sind, um `svelte-i18n` nahtlos auf `@intlayer/svelte-i18n` abzubilden.
+
+## Was im Hintergrund geschieht
+
+Svelte-i18n basiert auf häufig verwendeten Stores (`$_`, `$t`, `$format` etc.) und ICU MessageFormat.
+
+Im Hintergrund:
+
+- **Stores:** Intlayer proxyt die `svelte-i18n`-Stores. `$_` wird zu einem abgeleiteten Store der aktuellen Locale, der einen Intlayer-Resolver zurückgibt.
+- **Schlüssel:** Ihre flachen Schlüssel (z.B. `$_('home.title')`) werden so ausgewertet, dass das erste Pfadsegment das Intlayer-Wörterbuch repräsentiert.
+- **ICU-Syntax:** Vollständig durch den gemeinsamen ICU-Resolver behandelt (äquivalentes `intl-messageformat`-Parsing).
+- **Formatter:** `$date`-, `$time`- und `$number`-Aufrufe leiten sicher zu Intlayers nativen Kern-Formatierern weiter.
+- **Babel/SWC-Analyse:** Der Intlayer-Analyzer liest die Svelte-Store-Aufrufer (`$_`) in Ihren `.svelte`-Quelldateien vor der Kompilierung, um automatisch die relevanten Wörterbuch-Chunks zu erstellen.

package/docs/de/compat/transloco.md

@@ -0,0 +1,45 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migration von Transloco zu Intlayer"
+description: "Erfahren Sie, wie Sie Ihre Angular-Anwendung von Transloco zu Intlayer mithilfe des Compat-Adapters migrieren."
+keywords:
+  - transloco
+  - angular
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - transloco
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Verlauf initialisiert"
+author: aymericzip
+---
+
+# Migration von Transloco zu Intlayer
+
+Wenn Ihre Angular-Anwendung derzeit `@jsverse/transloco` verwendet, können Sie mit unserem Compat-Adapter zu Intlayer migrieren. Dieser Übergang ermöglicht es Ihnen, Ihre bestehende Template-Syntax beizubehalten und gleichzeitig die leistungsstarke Wörterbuchstruktur von Intlayer zu nutzen.
+
+## Was zu tun ist
+
+Führen Sie einfach den Initialisierungsbefehl in Ihrem Projekt aus:
+
+```bash
+npx intlayer init
+```
+
+Dadurch wird die erforderliche `intlayer.config.ts`-Konfiguration generiert. Sie ersetzen dann Ihre Transloco-Imports durch `@intlayer/transloco`-Module oder verlassen sich auf die Build-Aliase.
+
+## Was im Hintergrund geschieht
+
+Transloco verwendet Scopes und einen `TranslocoService` (`translate`, `selectTranslate`) neben strukturellen Direktiven (`*transloco="let t"`) und Pipes (`| transloco`).
+
+Im Hintergrund:
+
+- **Scopes:** Ordnen sich natürlich den Intlayer-Wörterbuchschlüsseln zu und bieten eine hervorragende Bereinigungsgeschichte für die Bundle-Optimierung.
+- **Service & Direktiven:** Der Angular-Adapter von Intlayer ersetzt die Provider nahtlos und ermöglicht es Ihren bestehenden Template-Pipes und -Direktiven, Zeichenketten gegen Intlayer-Wörterbücher aufzulösen.
+- **Build-Zeit-Parsing:** Der TypeScript-Analyzer erkennt `instant/get`-Aufrufe, und Fallback-Bereinigung gewährleistet Korrektheit auch dann, wenn die Template-Nutzung nicht statisch verfolgbar ist.

package/docs/de/compat/vue-i18n.md

@@ -0,0 +1,58 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migration von Vue I18n zu Intlayer"
+description: "Erfahren Sie, wie Sie Ihre Vue-Anwendung von vue-i18n zu Intlayer mithilfe des Compat-Adapters migrieren."
+keywords:
+  - vue-i18n
+  - vue
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - vue-i18n
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Verlauf initialisiert"
+author: aymericzip
+---
+
+# Migration von Vue I18n zu Intlayer
+
+Wenn Ihre Vue-Anwendung derzeit `vue-i18n` verwendet, können Sie zu Intlayer migrieren, ohne Ihre Komponenten umzuschreiben oder Hooks zu übersetzen. Intlayer bietet einen Compat-Adapter, der die API von `vue-i18n` perfekt spiegelt und dabei die leistungsstarken Funktionen von Intlayer im Hintergrund nutzt.
+
+## Was zu tun ist
+
+Um zu beginnen, führen Sie einfach den Initialisierungsbefehl in Ihrem Projekt aus:
+
+```bash
+npx intlayer init
+```
+
+Während der Initialisierung richtet Intlayer Ihre Konfigurationsdatei (`intlayer.config.ts`) ein und bereitet Ihr Projekt für die Migration vor. Sie müssen lediglich das Intlayer-Plugin zu Ihrer Vite-Konfiguration hinzufügen, um die `vue-i18n`-Imports automatisch zu aliasieren.
+
+```typescript fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import vue from "@vitejs/plugin-vue";
+import vueI18nVitePlugin from "@intlayer/vue-i18n/plugin";
+
+export default defineConfig({
+  plugins: [vue(), vueI18nVitePlugin()],
+});
+```
+
+## Was im Hintergrund geschieht
+
+Das `vueI18nVitePlugin` injiziert einen Modul-Alias in Ihren Bundler. Jeder Import von `vue-i18n` in Ihrem Codebase wird transparent zu `@intlayer/vue-i18n` weitergeleitet.
+
+**Im Hintergrund behandelt der Adapter die komplexe `vue-i18n`-Syntax nativ:**
+
+- **Interpolation & Plurale:** Löst `{name}`- und Listen-`{0}`-Interpolationen auf. Pipe-Plurale (`"car | cars"`) werden basierend auf positionaler Semantik in Intlayer-Enumerations-/Plural-Knoten umgewandelt.
+- **Formate:** Funktionen wie `d()` und `n()` umhüllen `Intl` im Hintergrund und berücksichtigen die in Ihren Optionen definierten `datetimeFormats` und `numberFormats`.
+- **Globaler & lokaler Zustand:** `global.locale` wird einem `WritableComputedRef` zugeordnet, das vom Intlayer-Client unterstützt wird, sodass sich die Reaktivität genau wie erwartet verhält (z.B. `locale.value = 'fr'`).
+- **Direktiven:** Die `v-t`-Direktive ist registriert und funktioniert normal.
+
+Ihre Anwendung rendert weiterhin genau wie zuvor, aber der Inhalt wird von Ihren Intlayer-Wörterbüchern bereitgestellt, was Ihnen Typsicherheit, bessere Bundle-Optimierung und nahtlose CMS-Integration bietet.

package/docs/de/compiler.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-09-09
-updatedAt: 2026-03-12
+updatedAt: 2026-06-23
 title: Intlayer Compiler | Automatisierte Inhaltsextraktion für i18n
 description: Automatisieren Sie Ihren Internationalisierungsprozess mit dem Intlayer Compiler. Extrahieren Sie Inhalte direkt aus Ihren Komponenten für schnellere und effizientere i18n in Vite, Next.js und mehr.
 keywords:
@@ -60,6 +60,8 @@ Als Alternative, um Ihren i18n-Prozess zu automatisieren und gleichzeitig die vo
 
 ## Verwendung
 
+> The quickest way to wire the compiler in is the interactive setup: run `npx intlayer init --interactive` and select **Compiler**. On Vite there is nothing to configure — the compiler is plugged in directly through the `intlayerCompiler()` plugin. On Next.js the command scaffolds the `babel.config.js` shown below. The non-interactive `intlayer init` leaves the compiler setup untouched.
+
 <Tabs>
  <Tab value='vite'>
 
@@ -79,12 +81,15 @@ Aktualisieren Sie Ihre `vite.config.ts`, um das `intlayerCompiler` Plugin einzub
 
 ```ts fileName="vite.config.ts"
 import { defineConfig } from "vite";
-import { intlayer, intlayerCompiler } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
   plugins: [
-    intlayer(),
-    intlayerCompiler(), // Fügt das Compiler-Plugin hinzu
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
   ],
 });
 ```