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

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"),
+      },
+    }),
   ],
 });
 ```

package/docs/de/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-06-17
+updatedAt: 2026-07-11
 title: Konfiguration (Configuration)
 description: Erfahren Sie, wie Sie Intlayer für Ihre Anwendung konfigurieren. Verstehen Sie die verschiedenen Einstellungen und Optionen, um Intlayer an Ihre Bedürfnisse anzupassen.
 keywords:
@@ -14,6 +14,12 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 9.0.0
+    date: 2026-07-11
+    changes: "`analytics` Konfiguration hinzugefügt"
+  - version: 9.0.0
+    date: 2026-06-24
+    changes: "Add `enableProxy` option to the routing configuration"
   - version: 8.10.0
     date: 2026-06-17
     changes: "Option `format` zur Wörterbuchkonfiguration hinzugefügt"
@@ -352,6 +358,30 @@ const config: IntlayerConfig = {
     liveSync: true,
   },
 
+  /**
+   * Analytics-Konfiguration.
+   */
+  analytics: {
+    /**
+     * Ob die Analytics-Erfassung aktiviert ist (Seitenaufrufe, Content-Expositionen, A/B-Ereignisse).
+     * Erfordert, dass `editor.clientId` für die Zuordnung gesetzt ist.
+     * Standard: false
+     */
+    enabled: true,
+
+    /**
+     * Millisekunden zwischen automatischen gebündelten Übertragungen an das Backend.
+     * Standard: 20000
+     */
+    flushInterval: 20000,
+
+    /**
+     * Anteil der zu erfassenden Sitzungen, von 0 (keine) bis 1 (alle).
+     * Standard: 1
+     */
+    sampleRate: 1,
+  },
+
   /**
    * KI-gestützte Übersetzungs- und Generierungseinstellungen.
    */
@@ -668,6 +698,20 @@ Definiert Einstellungen für den integrierten Editor, einschließlich Server-Por
 
 ---
 
+### Analytics-Konfiguration (Analytics Configuration)
+
+Definiert Einstellungen für Intlayer Analytics: die Erfassung, welche Inhalte Nutzern tatsächlich angezeigt werden (Seitenaufrufe, Content-Expositionen), und die Unterstützung von A/B-Tests für Inhalte.
+
+Analytics ist streng Opt-in: Es wird nichts erfasst, es sei denn, `analytics.enabled` ist explizit auf `true` gesetzt **und** ein Projektschlüssel (`editor.clientId`) ist für die Zuordnung konfiguriert. Wenn deaktiviert (Standard), wird die gesamte Analytics-Integration aus Ihrem Anwendungs-Bundle per Dead-Code-Elimination entfernt.
+
+| Feld            | Beschreibung                                                                             | Typ       | Standard | Beispiel | Hinweis                                                                                                                                            |
+| --------------- | ---------------------------------------------------------------------------------------- | --------- | -------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `enabled`       | Aktiviert die Analytics-Erfassung (Seitenaufrufe, Content-Expositionen, A/B-Ereignisse). | `boolean` | `false`  | `true`   | Erfordert, dass `editor.clientId` für die Zuordnung gesetzt ist; andernfalls bleibt Analytics deaktiviert, selbst wenn `enabled` auf `true` steht. |
+| `flushInterval` | Millisekunden zwischen automatischen gebündelten Übertragungen an das Backend.           | `number`  | `20000`  | `10000`  |                                                                                                                                                    |
+| `sampleRate`    | Anteil der zu erfassenden Sitzungen, von `0` (keine) bis `1` (alle).                     | `number`  | `1`      | `0.5`    | Das Sampling ist pro Sitzung deterministisch, sodass eine erfasste Sitzung alle ihre Ereignisse meldet (keine unvollständigen Funnels).            |
+
+---
+
 ### Routing-Konfiguration
 
 Einstellungen, die das Routing-Verhalten steuern, einschließlich URL-Struktur, Sprachspeicherung und Middleware-Handhabung.
@@ -885,6 +929,21 @@ Einstellungen für die Inhaltsbehandlung in der Anwendung, einschließlich Verze
 
 ---
 
+### Systemkonfiguration
+
+Einstellungen für interne Pfade und Ausgabeergebnisse von Intlayer. Diese Einstellungen sind typischerweise intern und sollten normalerweise vom Benutzer nicht geändert werden.
+
+| Field                     | Description                                                                               | Type     | Default                           | Example              | Note                                                                 |
+| ------------------------- | ----------------------------------------------------------------------------------------- | -------- | --------------------------------- | -------------------- | -------------------------------------------------------------------- |
+| `baseDir`                 | Das Basisverzeichnis für das Projekt.                                                     | `string` | `process.cwd()`                   | `'/path/to/project'` | Wird verwendet, um alle Intlayer-bezogenen Verzeichnisse aufzulösen. |
+| `dictionariesDir`         | Der Verzeichnispfad zum Speichern von Lokalisierungswörterbüchern.                        | `string` | `'.intlayer/dictionary'`          |                      |                                                                      |
+| `moduleAugmentationDir`   | Verzeichnis für Modul-Augmentation, das bessere IDE-Vorschläge und Typprüfung ermöglicht. | `string` | `'.intlayer/types'`               | `'intlayer-types'`   | Stellen Sie sicher, dass dies in `tsconfig.json` enthalten ist.      |
+| `unmergedDictionariesDir` | Das Verzeichnis zum Speichern von nicht zusammengeführten Wörterbüchern.                  | `string` | `'.intlayer/unmerged_dictionary'` |                      |                                                                      |
+| `typesDir`                | Das Verzeichnis zum Speichern von Wörterbuchtypen.                                        | `string` | `'.intlayer/types'`               |                      |                                                                      |
+| `mainDir`                 | Das Verzeichnis, in dem die Hauptanwendungsdateien gespeichert sind.                      | `string` | `'.intlayer/main'`                |                      |                                                                      |
+| `configDir`               | Das Verzeichnis, in dem Konfigurationsdateien gespeichert sind.                           | `string` | `'.intlayer/config'`              |                      |                                                                      |
+| `cacheDir`                | Das Verzeichnis, in dem Cache-Dateien gespeichert sind.                                   | `string` | `'.intlayer/cache'`               |                      |                                                                      |
+
 ### Wörterbuchkonfiguration
 
 Einstellungen, die Wörterbuchoperationen steuern, einschließlich automatischem Ausfüllverhalten und Inhaltsgenerierung.
@@ -993,22 +1052,6 @@ Die Build-Optionen gelten für die Plugins `@intlayer/babel` und `@intlayer/swc`
 
 ---
 
-### Systemkonfiguration
-
-Diese Einstellungen sind für fortgeschrittene Anwendungsfälle und die interne Konfiguration von Intlayer gedacht.
-
-| Feld                      | Beschreibung                                         | Typ      | Standard                          | Beispiel | Hinweis |
-| ------------------------- | ---------------------------------------------------- | -------- | --------------------------------- | -------- | ------- |
-| `dictionariesDir`         | Verzeichnis für kompilierte Wörterbücher.            | `string` | `'.intlayer/dictionary'`          |          |         |
-| `moduleAugmentationDir`   | Verzeichnis für die TypeScript-Modul-Augmentierung.  | `string` | `'.intlayer/types'`               |          |         |
-| `unmergedDictionariesDir` | Verzeichnis für nicht zusammengeführte Wörterbücher. | `string` | `'.intlayer/unmerged_dictionary'` |          |         |
-| `typesDir`                | Verzeichnis für generierte Typen.                    | `string` | `'.intlayer/types'`               |          |         |
-| `mainDir`                 | Verzeichnis für die Intlayer-Hauptdatei.             | `string` | `'.intlayer/main'`                |          |         |
-| `configDir`               | Verzeichnis für kompilierte Konfigurationsdateien.   | `string` | `'.intlayer/config'`              |          |         |
-| `cacheDir`                | Verzeichnis für Cache-Dateien.                       | `string` | `'.intlayer/cache'`               |          |         |
-
----
-
 ### Compiler-Konfiguration
 
 Einstellungen, die den Intlayer-Compiler steuern, der Wörterbücher direkt aus Ihren Komponenten extrahiert.

package/docs/de/custom_domains.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-04-02
-updatedAt: 2026-04-02
+updatedAt: 2026-06-23
 title: Eigene Domains
 description: Erfahren Sie, wie Sie das domänenbasierte Locale-Routing in Intlayer konfigurieren, um verschiedene Locales über dedizierte Hostnamen bereitzustellen.
 keywords:
@@ -172,10 +172,16 @@ Das `intlayerProxy` Vite-Plugin wendet die gleiche Logik während der Entwicklun
 
 ```typescript fileName="vite.config.ts"
 import { defineConfig } from "vite";
-import { intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
-  plugins: [intlayerProxy()],
+  plugins: [
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
+  ],
 });
 ```
 

package/docs/de/custom_url_rewrites.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-01-26
+updatedAt: 2026-06-23
 title: Benutzerdefinierte URL Rewrites
 description: Erfahren Sie, wie Sie in Intlayer benutzerdefinierte URL Rewrites konfigurieren und verwenden, um locale-spezifische Pfade zu definieren.
 keywords:
@@ -342,10 +342,16 @@ Für SolidJS, Vue und Svelte verwaltet das `intlayerProxy`-Vite-Plugin die Rewri
 
 ```typescript fileName="vite.config.ts"
 import { defineConfig } from "vite";
-import { intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
-  plugins: [intlayerProxy()],
+  plugins: [
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
+  ],
 });
 ```