@intlayer/docs 9.0.0-canary.4 → 9.0.0-canary.5

package/docs/de/packages/intlayer/getMultilingualUrls.md

@@ -29,12 +29,28 @@ author: aymericzip
 
 ## Beschreibung
 
+Die `getMultilingualUrls`-Funktion generiert eine Zuordnung mehrsprachiger URLs, indem sie die angegebene URL mit jedem unterstützten Locale voranstellt. Sie kann sowohl absolute als auch relative URLs verarbeiten und wendet das entsprechende Locale-Präfix basierend auf der bereitgestellten Konfiguration oder den Standardeinstellungen an.
+
+**Wichtige Funktionen:**
+
+- Nur 1 Parameter ist erforderlich: `url`
+- Optionales `options`-Objekt mit `locales`, `defaultLocale` und `mode`
+- Verwendet die Internationalisierungskonfiguration Ihres Projekts als Standardeinstellungen
+- Unterstützt mehrere Routing-Modi: `prefix-no-default`, `prefix-all`, `no-prefix` und `search-params`
+- Gibt ein Zuordnungsobjekt mit allen Locales als Schlüssel und ihren entsprechenden URLs als Werte zurück
+
+---
+
+## Beschreibung
+
 Die Funktion `getMultilingualUrls` erzeugt eine Zuordnung mehrsprachiger URLs, indem sie die gegebene URL mit jedem unterstützten Gebietsschema (Locale) voranstellt. Sie kann sowohl absolute als auch relative URLs verarbeiten und wendet das entsprechende Gebietsschema-Präfix basierend auf der bereitgestellten Konfiguration oder den Standardwerten an.
 
 ---
 
 ## Parameter
 
+## Parameter
+
 - `url: string`
   - **Beschreibung**: Der ursprüngliche URL-String, der mit Gebietsschemata vorangestellt werden soll.
   - **Typ**: `string`
@@ -54,6 +70,33 @@ Die Funktion `getMultilingualUrls` erzeugt eine Zuordnung mehrsprachiger URLs, i
   - **Typ**: `boolean`
   - **Standard**: `prefixDefaultDefault`
 
+### Optionale Parameter
+
+- `options?: object`
+  - **Description**: Konfigurationsobjekt für das URL-Lokalisierungsverhalten.
+  - **Type**: `object`
+  - **Required**: No (Optional)
+
+  - `options.locales?: Locales[]`
+    - **Description**: Array von unterstützten Locales. Falls nicht angegeben, werden die konfigurierten Locales aus Ihrer Projektkonfiguration verwendet.
+    - **Type**: `Locales[]`
+    - **Default**: [`Project Configuration`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/configuration.md#middleware)
+
+  - `options.defaultLocale?: Locales`
+    - **Description**: Das Standard-Locale für die Anwendung. Falls nicht angegeben, wird das konfigurierte Standard-Locale aus Ihrer Projektkonfiguration verwendet.
+    - **Type**: `Locales`
+    - **Default**: [`Project Configuration`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/configuration.md#middleware)
+
+  - `options.mode?: 'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params'`
+    - **Description**: Der URL-Routing-Modus für die Locale-Behandlung. Falls nicht angegeben, wird der konfigurierte Modus aus Ihrer Projektkonfiguration verwendet.
+    - **Type**: `'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params'`
+    - **Default**: [`Project Configuration`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/configuration.md#middleware)
+    - **Modes**:
+      - `prefix-no-default`: Kein Präfix für Standard-Locale, Präfix für alle anderen
+      - `prefix-all`: Präfix für alle Locales einschließlich Standard
+      - `no-prefix`: Kein Locale-Präfix in der URL
+      - `search-params`: Abfrageparameter für Locale verwenden (z. B. `?locale=fr`)
+
 ### Rückgabewert
 
 - **Typ**: `IConfigLocales<string>`
@@ -63,6 +106,20 @@ Die Funktion `getMultilingualUrls` erzeugt eine Zuordnung mehrsprachiger URLs, i
 
 ## Beispielhafte Verwendung
 
+### Grundlegende Verwendung (verwendet Projektkonfiguration)
+
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
+import { getMultilingualUrls, Locales } from "intlayer";
+
+// Verwendet die Konfiguration Ihres Projekts für locales, defaultLocale und mode
+getMultilingualUrls("/dashboard");
+// Ausgabe (vorausgesetzt, die Projektkonfiguration hat en, fr mit mode 'prefix-no-default'):
+// {
+//   en: "/dashboard",
+//   fr: "/fr/dashboard"
+// }
+```
+
 ### Relative URLs
 
 ```typescript codeFormat={["typescript", "esm", "commonjs"]}
@@ -97,6 +154,60 @@ getMultilingualUrls(
 
 ---
 
+### Verschiedene Routing-Modi
+
+```typescript
+// prefix-no-default: Kein Präfix für Standardsprache
+getMultilingualUrls("/dashboard", {
+  locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+  defaultLocale: Locales.ENGLISH,
+  mode: "prefix-no-default",
+});
+// Ausgabe: {
+//   en: "/dashboard",
+//   fr: "/fr/dashboard",
+//   es: "/es/dashboard"
+// }
+
+// prefix-all: Präfix für alle Sprachen
+getMultilingualUrls("/dashboard", {
+  locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+  defaultLocale: Locales.ENGLISH,
+  mode: "prefix-all",
+});
+// Ausgabe: {
+//   en: "/en/dashboard",
+//   fr: "/fr/dashboard",
+//   es: "/es/dashboard"
+// }
+
+// no-prefix: Kein Sprachpräfix in URLs
+getMultilingualUrls("/dashboard", {
+  locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+  defaultLocale: Locales.ENGLISH,
+  mode: "no-prefix",
+});
+// Ausgabe: {
+//   en: "/dashboard",
+//   fr: "/dashboard",
+//   es: "/dashboard"
+// }
+
+// search-params: Sprache als Query-Parameter
+getMultilingualUrls("/dashboard", {
+  locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+  defaultLocale: Locales.ENGLISH,
+  mode: "search-params",
+});
+// Ausgabe: {
+//   en: "/dashboard?locale=en",
+//   fr: "/dashboard?locale=fr",
+//   es: "/dashboard?locale=es"
+// }
+```
+
+---
+
 ## Randfälle
 
 - **Kein Gebietsschema-Segment:**

package/docs/de/packages/react-intlayer/useDictionary.md

@@ -24,42 +24,6 @@ history:
 author: aymericzip
 ---
 
-# React-Integration: `useDictionary` Hook Dokumentation
-
-Dieser Abschnitt bietet eine detaillierte Anleitung zur Verwendung des `useDictionary` Hooks in React-Anwendungen, um eine effiziente Handhabung lokalisierter Inhalte ohne visuellen Editor zu ermöglichen.
-
-## Importieren von `useDictionary` in React
-
-Der `useDictionary` Hook kann in React-Anwendungen integriert werden, indem er je nach Kontext importiert wird:
-
-- **Client-Komponente:**
-
-  ```typescript codeFormat="typescript"
-  import { useDictionary } from "react-intlayer"; // Wird in clientseitigen React-Komponenten verwendet
-  ```
-
-  ```javascript codeFormat="esm"
-  import { useDictionary } from "react-intlayer"; // Wird in clientseitigen React-Komponenten verwendet
-  ```
-
-  ```javascript codeFormat="commonjs"
-  const { useDictionary } = require("react-intlayer"); // Wird in clientseitigen React-Komponenten verwendet
-  ```
-
-- **Server-Komponente:**
-
-  ```typescript codeFormat="typescript"
-  import { useDictionary } from "react-intlayer/server"; // Wird in serverseitigen React-Komponenten verwendet
-  ```
-
-  ```javascript codeFormat="esm"
-  import { useDictionary } from "react-intlayer/server"; // Wird in serverseitigen React-Komponenten verwendet
-  ```
-
-  ```javascript codeFormat="commonjs"
-  const { useDictionary } = require("react-intlayer/server"); // Wird in serverseitigen React-Komponenten verwendet
-  ```
-
 ## Parameter
 
 Der Hook akzeptiert zwei Parameter:
@@ -67,57 +31,6 @@ Der Hook akzeptiert zwei Parameter:
 1. **`dictionary`**: Ein deklariertes Wörterbuchobjekt, das lokalisierte Inhalte für bestimmte Schlüssel enthält.
 2. **`locale`** (optional): Die gewünschte Locale. Standardmäßig wird die Locale des aktuellen Kontexts verwendet, wenn keine angegeben ist.
 
-## Wörterbuch
-
-Alle Wörterbuchobjekte sollten in strukturierten Inhaltsdateien deklariert werden, um Typsicherheit zu gewährleisten und Laufzeitfehler zu vermeiden. Die [Einrichtungsanweisungen finden Sie hier](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/dictionary/content_file.md). Hier ist ein Beispiel für die Inhaltsdeklaration:
-
-```typescript fileName="./component.content.ts" contentDeclarationFormat={["typescript", "esm", "commonjs"]}
-import { t, type Dictionary } from "intlayer";
-
-const componentContent = {
-  key: "component-example",
-  content: {
-    title: t({
-      en: "Client Component Example",
-      fr: "Exemple de composant client",
-      es: "Ejemplo de componente cliente",
-    }),
-    content: t({
-      en: "This is the content of a client component example",
-      fr: "Ceci est le contenu d'un exemple de composant client",
-      es: "Este es el contenido de un ejemplo de componente cliente",
-    }),
-  },
-} satisfies Dictionary;
-
-export default componentContent;
-```
-
-```json fileName="./component.content.json" contentDeclarationFormat="json"
-{
-  "$schema": "https://intlayer.org/schema.json",
-  "key": "component-example",
-  "content": {
-    "title": {
-      "nodeType": "translation",
-      "translation": {
-        "en": "Client Component Example",
-        "fr": "Exemple de composant client",
-        "es": "Ejemplo de componente cliente"
-      }
-    },
-    "content": {
-      "nodeType": "translation",
-      "translation": {
-        "en": "This is the content of a client component example",
-        "fr": "Ceci est le contenu d'un exemple de composant client",
-        "es": "Este es el contenido de un ejemplo de componente cliente"
-      }
-    }
-  }
-}
-```
-
 ## Beispiel für die Verwendung in React
 
 Nachfolgend ein Beispiel, wie der `useDictionary` Hook in einer React-Komponente verwendet wird:
@@ -141,35 +54,6 @@ const ComponentExample: FC = () => {
 };
 ```
 
-## Server-Integration
-
-Wenn Sie den `useDictionary` Hook außerhalb des `IntlayerProvider` verwenden, muss die Locale beim Rendern der Komponente explizit als Parameter übergeben werden:
-
-```tsx fileName="./ServerComponentExample.tsx" codeFormat={["typescript", "esm"]}
-import type { FC } from "react";
-import { useDictionary } from "react-intlayer/server";
-import clientComponentExampleContent from "./component.content";
-
-const ServerComponentExample: FC<{ locale: string }> = ({ locale }) => {
-  const { content } = useDictionary(clientComponentExampleContent, locale);
-
-  return (
-    <div>
-      <h1>{content.title}</h1>
-      <p>{content.content}</p>
-    </div>
-  );
-};
-```
-
-## Hinweise zu Attributen
-
-Im Gegensatz zu Integrationen mit visuellen Editoren gelten hier keine Attribute wie `buttonTitle.value`. Stattdessen greifen Sie direkt auf die lokalisierten Strings zu, wie sie in Ihrem Inhalt deklariert sind.
-
-```jsx
-<button title={content.title}>{content.content}</button>
-```
-
 ## Zusätzliche Tipps
 
 - **Typensicherheit**: Verwenden Sie stets `Dictionary`, um Ihre Wörterbücher zu definieren und so Typensicherheit zu gewährleisten.

package/docs/de/packages/react-intlayer/useIntlayer.md

@@ -29,49 +29,6 @@ author: aymericzip
 
 Dieser Abschnitt bietet eine detaillierte Anleitung zur Verwendung des `useIntlayer` Hooks in React-Anwendungen, um eine effiziente Inhaltslokalisierung zu ermöglichen.
 
-## Importieren von `useIntlayer` in React
-
-Der `useIntlayer` Hook kann in React-Anwendungen integriert werden, indem er je nach Kontext importiert wird:
-
-- **Client-Komponente:**
-
-  ```typescript codeFormat="typescript"
-  import { useIntlayer } from "react-intlayer"; // Wird in clientseitigen React-Komponenten verwendet
-  ```
-
-  ```javascript codeFormat="esm"
-  import { useIntlayer } from "react-intlayer"; // Wird in clientseitigen React-Komponenten verwendet
-  ```
-
-  ```javascript codeFormat="commonjs"
-  const { useIntlayer } = require("react-intlayer"); // Wird in clientseitigen React-Komponenten verwendet
-  ```
-
-- **Server-Komponente:**
-
-  ```typescript codeFormat="commonjs"
-  import { useIntlayer } from "react-intlayer/server"; // Wird in serverseitigen React-Komponenten verwendet
-  ```
-
-  ```javascript codeFormat="esm"
-  import { useIntlayer } from "react-intlayer/server"; // Wird in serverseitigen React-Komponenten verwendet
-  ```
-
-  ```javascript codeFormat="commonjs"
-  const { useIntlayer } = require("react-intlayer/server"); // Wird in serverseitigen React-Komponenten verwendet
-  ```
-
-## Parameter
-
-Der Hook akzeptiert zwei Parameter:
-
-1. **`key`**: Der Wörterbuchschlüssel, um lokalisierten Inhalt abzurufen.
-2. **`locale`** (optional): Die gewünschte Locale. Standardmäßig wird die Locale des Kontexts verwendet, falls nicht angegeben.
-
-## Wörterbuch
-
-Alle Wörterbuchschlüssel müssen in Inhaltsdeklarationsdateien deklariert werden, um die Typsicherheit zu erhöhen und Fehler zu vermeiden. Die [Setup-Anleitung finden Sie hier](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/dictionary/content_file.md).
-
 ## Beispielhafte Verwendung in React
 
 Demonstration des `useIntlayer` Hooks innerhalb einer React-Komponente:
@@ -142,14 +99,6 @@ const ServerComponentExample = () => {
 };
 ```
 
-## Umgang mit Attributen
-
-Beim Lokalisieren von Attributen greifen Sie entsprechend auf die Inhaltswerte zu:
-
-```jsx
-<button title={content.buttonTitle.value}>{content.buttonText}</button>
-```
-
 ## Zusätzliche Ressourcen
 
 - **Intlayer Visual Editor**: Für eine intuitivere Verwaltung von Inhalten finden Sie die Dokumentation zum visuellen Editor [hier](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/intlayer_visual_editor.md).

package/docs/de/releases/v6.md

@@ -25,6 +25,10 @@ author: aymericzip
 
 Willkommen bei Intlayer v6! Diese Version konzentriert sich auf Leistung, Entwicklererfahrung und Zuverlässigkeit. Nachfolgend finden Sie die Highlights, Migrationshinweise und kopierbare Beispiele.
 
+## Inhaltsverzeichnis
+
+<TOC levels={[2]} maxDepth={1} />
+
 ## Highlights
 
 - Neuer Befehl: `npx intlayer content test` zum Erkennen fehlender Übersetzungen
@@ -265,12 +269,6 @@ Siehe [Konfiguration](https://github.com/aymericzip/intlayer/blob/main/docs/docs
 
 ---
 
-## Stärkere Validierung
-
-Die Verarbeitung von Wörterbüchern führt jetzt eine robustere Validierung durch. Wenn ein Wörterbuch nicht verarbeitet werden kann, verhindert Intlayer, dass Ihre Anwendung abstürzt, und zeigt umsetzbare Fehler an.
-
----
-
 ## Live-Updates mit CMS (Produktionssicher)
 
 Liefern Sie Live-Inhaltsaktualisierungen (z. B. redaktionelle Updates) in der Produktion, ohne Ihre Anwendung neu zu bauen.
@@ -337,6 +335,12 @@ Siehe [CMS und Live-Sync](https://github.com/aymericzip/intlayer/blob/main/docs/
 
 ---
 
+## Migrationsnoten von v6 zu v7
+
+Weitere Informationen finden Sie in den [Migrationsnoten von v6 zu v7](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/releases/v7.md).
+
+---
+
 ## Nützliche Links
 
 - [CLI-Referenz](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/cli/index.md)

package/docs/de/releases/v7.md

@@ -25,6 +25,10 @@ author: aymericzip
 
 Willkommen bei Intlayer v7! Dieses große Release bringt bedeutende Verbesserungen in Leistung, Typsicherheit und Entwicklererfahrung. Nachfolgend finden Sie die Highlights, Migrationshinweise und praktische Beispiele.
 
+## Inhaltsverzeichnis
+
+<TOC levels={[2]} maxDepth={1} />
+
 ## Highlights
 
 - Caching-Strategie für schnellere Builds
@@ -260,6 +264,126 @@ Dies führt zu schnelleren Downloadzeiten und verbesserter Laufzeitleistung Ihre
 
 ---
 
+## Automatische Code-Formatierung: formatCommand-Konfiguration
+
+v7 führt die `formatCommand`-Option in der Editor-Konfiguration ein, die es Ihnen ermöglicht, Inhaltsdateien automatisch zu formatieren, wenn sie von Intlayer geschrieben werden. Dies gewährleistet einen konsistenten Code-Stil und eine konsistente Formatierung in Ihren Content-Deklarationsdateien.
+
+Falls nicht gesetzt, versucht Intlayer, den Format-Befehl automatisch zu erkennen. Durch den Versuch, die folgenden Befehle aufzulösen: prettier, biome, eslint.
+
+### Konfiguration
+
+Die `formatCommand`-Option akzeptiert eine String-Vorlage, wobei `{{file}}` durch den tatsächlichen Dateipfad ersetzt wird:
+
+```typescript fileName="intlayer.config.ts"
+export default {
+  content: {
+    formatCommand: 'bun x biome format "{{file}}" --write --log-level none',
+  },
+};
+```
+
+### Unterstützte Formatter
+
+Sie können jeden Code-Formatter verwenden, der Dateipfade als Argumente akzeptiert:
+
+**Using Biome:**
+
+```typescript
+formatCommand: 'bun x biome format "{{file}}" --write --log-level none';
+```
+
+**Using Prettier:**
+
+```typescript
+formatCommand: 'npx prettier --write "{{file}}" --log-level silent';
+```
+
+**Using ESLint:**
+
+```typescript
+formatCommand: 'npx eslint --fix "{{file}}" --quiet';
+```
+
+**Using Bun's built-in formatter:**
+
+```typescript
+formatCommand: 'bun format "{{file}}"';
+```
+
+### Vorteile
+
+- **Konsistente Formatierung**: Alle Inhaltsdateien werden automatisch gemäß den Stilrichtlinien Ihres Projekts formatiert
+- **Developer Experience**: Keine manuelle Formatierung von Dateien nach dem Schreiben durch Intlayer erforderlich
+- **Team-Konsistenz**: Stellt sicher, dass alle Teammitglieder die gleiche Formatierung auf Inhaltsdateien anwenden
+- **CI/CD-Integration**: Inhaltsdateien behalten konsistente Formatierung in automatisierten Workflows bei
+
+### Funktionsweise
+
+Wenn Intlayer eine Content-Deklarationsdatei (`.content.ts`, `.content.js`, etc.) schreibt oder aktualisiert, führt es automatisch den angegebenen Format-Befehl auf der Datei aus. Der Platzhalter `{{file}}` wird durch den tatsächlichen Dateipfad ersetzt, und der Befehl wird im Basisverzeichnis des Projekts ausgeführt.
+
+---
+
+## Dictionary-Konfiguration: Bessere Organisation und Struktur
+
+v7 führt einen neuen dedizierten `dictionary`-Konfigurationsbereich ein, der eine bessere Organisation für wörterbuchbezogene Einstellungen und verbessertes Content-Management bietet.
+
+### Neue Dictionary-Konfigurationsstruktur
+
+Die `fill`-Eigenschaft wurde aus dem `content`-Abschnitt in einen neuen `dictionary`-Abschnitt verschoben, was eine klarere Trennung der Verantwortlichkeiten ermöglicht:
+
+**v6-Konfiguration:**
+
+```typescript fileName="intlayer.config.ts"
+export default {
+  content: {
+    autoFill: "./{{fileName}}.content.json",
+    contentDir: ["src"],
+  },
+};
+```
+
+**v7-Konfiguration:**
+
+```typescript fileName="intlayer.config.ts"
+export default {
+  content: {
+    contentDir: ["src"],
+  },
+  dictionary: {
+    fill: "./{{fileName}}.content.json",
+  },
+};
+```
+
+### Vorteile der neuen Struktur
+
+- **Klarere Organisation**: Dictionary-spezifische Einstellungen sind nun zusammengefasst
+- **Bessere Separation of Concerns**: Content Discovery vs. Dictionary-Operationen sind klar getrennt
+- **Verbesserte Wartbarkeit**: Einfacher zu verstehen und zu modifizieren Dictionary-bezogene Konfigurationen
+- **Zukünftige Erweiterbarkeit**: Der Dictionary-Bereich kann zusätzliche Dictionary-spezifische Einstellungen aufnehmen
+- **Umfassendes Dictionary-Management**: Umfasst Eigenschaften wie `title`, `live`, `priority`, `tags`, `version` und `description` zum Erstellen und Verwalten neuer Dictionaries
+
+### Konfigurationsverwendung
+
+Die Wörterbuchkonfiguration dient zwei Hauptzwecken:
+
+1. **Standardwerte**: Definieren Sie Standardwerte beim Erstellen von Content-Deklarationsdateien
+2. **Fallback-Verhalten**: Stellen Sie Fallback-Werte bereit, wenn bestimmte Felder nicht definiert sind, sodass Sie das Wörterbuch-Betriebsverhalten global definieren können
+
+Der Wörterbuchbereich umfasst umfassende Eigenschaften zur Wörterbuchverwaltung:
+
+- **`fill`**: Auto-Fill-Verhalten für die Content-Generierung
+- **`title`**: Standardtitel für neue Wörterbücher
+- **`live`**: Live-Sync-Konfiguration für Echtzeit-Updates
+- **`priority`**: Prioritätseinstellungen für die Wörterbuchauflösung
+- **`tags`**: Standard-Tags für die Content-Organisation
+- **`version`**: Versionsverwaltung für Wörterbuch-Updates
+- **`description`**: Standardbeschreibung für neue Inhalte
+
+Weitere Informationen zu Content-Deklarationsdateien und wie Konfigurationswerte angewendet werden, finden Sie in der [Content-Datei-Dokumentation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/dictionary/content_file.md).
+
+---
+
 ## Fill-Befehl: Aktualisiertes Verhalten für besseres Content-Management
 
 v7 führt ein verbessertes Verhalten für den `fill`-Befehl ein, das ein vorhersehbareres und flexibleres Content-Management ermöglicht:
@@ -407,6 +531,10 @@ Das System führt automatisch aus:
 - **`middleware.prefixDefault`**: Ersetzt durch `routing.mode`
 - **`middleware.noPrefix`**: Ersetzt durch `routing.mode`
 
+### Neue Konfigurationen
+
+- **`editor.formatCommand`**: Neue Option für automatische Code-Formatierung von Content-Dateien
+
 ### Migrationszuordnung
 
 #### Konfigurationszuordnung

package/docs/de/releases/v9.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-06-14
-updatedAt: 2026-06-14
+updatedAt: 2026-06-23
 title: Neues Intlayer v9 – Was ist neu?
 description: Entdecken Sie die Neuerungen in Intlayer v9. Einführung von Drop-in-Kompatibilitätspaketen für beliebte i18n-Bibliotheken und Unterstützung für Collections, Variants und Dynamic Records.
 keywords:
@@ -216,6 +216,42 @@ Zur Build-Zeit scannen `@intlayer/swc` und `@intlayer/babel` Ihre Dateien und er
 
 ---
 
+## Vite Plugin: Bundled Compiler & Proxy
+
+Das `intlayer()` Vite Plugin bündelt nun den **Compiler** und den **Locale-Routing Proxy** direkt, sodass die meisten Projekte nur ein einzelnes Plugin in `vite.config.ts` benötigen:
+
+```ts fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import { intlayer } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [intlayer()],
+});
+```
+
+- **Compiler**: Aktiviert sich automatisch, wenn `compiler.enabled` gesetzt ist und ein `compiler.output` Pfad konfiguriert ist. Sie müssen `intlayerCompiler()` nicht mehr separat registrieren.
+- **Proxy**: Aktiviert sich automatisch basierend auf der neuen `routing.enableProxy` Option (`true` standardmäßig). Es verbindet die Locale-Erkennung / Umleitung / Rewrite Middleware in Entwicklung, Preview und Production SSR. Sie müssen `intlayerProxy()` nicht mehr separat registrieren.
+
+### `routing.enableProxy` Option
+
+Eine neue `routing.enableProxy` Option kontrolliert, ob der Locale-Routing-Proxy eingebunden ist. Sie ist standardmäßig auf `true` gesetzt. Deaktivieren Sie sie, wenn Sie das Locale-Routing selbst handhaben möchten:
+
+```ts fileName="intlayer.config.ts"
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  routing: {
+    enableProxy: false, // Standard: true
+  },
+};
+
+export default config;
+```
+
+Die eigenständigen `intlayerCompiler()` und `intlayerProxy()` Plugins bleiben für erweiterte Setups exportiert. Die Registrierung neben `intlayer()` ist sicher — jedes Plugin dedupliziert sich selbst und läuft nur einmal.
+
+---
+
 ## Migrationshinweise von v8
 
 Wenn Sie von v8 upgraden, beachten Sie, dass v9 keine Breaking Changes enthält. Hier sind jedoch die wichtigsten Änderungen:

package/docs/de/roadmap.md

@@ -29,6 +29,12 @@ Intlayer ist eine Content-Management- und Internationalisierungslösung, die dar
 
 ---
 
+## Inhaltsverzeichnis
+
+<TOC/>
+
+---
+
 ## Aktuelle Funktionen
 
 ### 1. Inhaltsdeklaration
@@ -319,22 +325,6 @@ Intlayer unterstützt **TypeScript** (auch JavaScript) und **JSON** zur Deklarat
 
 ### 4. SEO-Verbesserungen
 
-- Werkzeuge zur **Analyse von Schlüsselwörtern**, der Suchintention der Nutzer und aufkommenden Trends.
-- Vorschläge für verbesserten Inhalt zur besseren Platzierung und zur Verfolgung der langfristigen Leistung.
-
-### 5. Kompatibilität mit weiteren Frameworks
-
-- Es wird daran gearbeitet, **Solid, Svelte, Angular** und weitere zu unterstützen.
-- Ziel ist es, Intlayer mit **jeder JavaScript-basierten Anwendung** kompatibel zu machen.
-
----
-
-## Fazit
-
-- Das System würde im Hintergrund Übersetzungen generieren und Sie dann zur Validierung oder Bearbeitung auffordern.
-
-### 4. SEO-Verbesserungen
-
 - Werkzeuge zur **Analyse von Schlüsselwörtern**, der Suchintention der Nutzer und aufkommenden Trends.
 - Vorschläge für verbesserten Inhalt zur besseren Platzierung und Verfolgung der langfristigen Leistung.
 

package/docs/en/bundle_optimization.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-11-25
-updatedAt: 2026-06-07
+updatedAt: 2026-06-24
 title: Optimizing i18n Bundle Size & Performance
 description: Reduce application bundle size by optimizing internationalization (i18n) content. Learn how to leverage tree shaking and lazy loading for dictionaries with Intlayer.
 keywords:
@@ -16,6 +16,9 @@ slugs:
   - concept
   - bundle-optimization
 history:
+  - version: 8.12.0
+    date: 2026-06-24
+    changes: "List Babel plugins in required pipeline order (extract → purge → minify → optimize) in the reference tables"
   - version: 8.12.0
     date: 2026-06-07
     changes: "Add `intlayerPurgeBabelPlugin` and `intlayerMinifyBabelPlugin` for Babel/Webpack; clarify plugin pipeline"
@@ -191,12 +194,14 @@ Intlayer's build optimization is split across several discrete plugins, each wit
 
 These are used directly in `babel.config.js` for Webpack-based setups (Next.js with Babel, CRA, custom Webpack, etc.).
 
+The table below lists them in their required pipeline order (the same order they must appear in `babel.config.js`):
+
 | Plugin                        | What it does                                                                                                   |
 | :---------------------------- | :------------------------------------------------------------------------------------------------------------- |
 | `intlayerExtractBabelPlugin`  | Scans `.content.ts` files and writes compiled dictionaries to `.intlayer/`                                     |
-| `intlayerOptimizeBabelPlugin` | Rewrites `useIntlayer('key')` → `useDictionary(hash)` and injects the matching dictionary `import`             |
 | `intlayerPurgeBabelPlugin`    | Scans all source files, removes **unused content fields** from compiled `.intlayer/**/*.json` dictionary files |
 | `intlayerMinifyBabelPlugin`   | **Renames content field keys** to short alphabetic aliases (`title` → `a`) in both JSON files and source code  |
+| `intlayerOptimizeBabelPlugin` | Rewrites `useIntlayer('key')` → `useDictionary(hash)` and injects the matching dictionary `import`             |
 
 > **Plugin order matters.** In your `babel.config.js` the purge and minify plugins must appear **before** the optimize plugin. The optimize pass replaces `useIntlayer('key')` with an opaque `useDictionary(hash)` call, erasing the dictionary-key information that the purge and minify passes need to identify which fields are used.
 
@@ -205,9 +210,9 @@ Each Babel plugin has a matching options helper that reads your `intlayer.config
 | Options helper               | Used with                     |
 | :--------------------------- | :---------------------------- |
 | `getExtractPluginOptions()`  | `intlayerExtractBabelPlugin`  |
-| `getOptimizePluginOptions()` | `intlayerOptimizeBabelPlugin` |
 | `getPurgePluginOptions()`    | `intlayerPurgeBabelPlugin`    |
 | `getMinifyPluginOptions()`   | `intlayerMinifyBabelPlugin`   |
+| `getOptimizePluginOptions()` | `intlayerOptimizeBabelPlugin` |
 
 ### Vite plugins (`vite-intlayer`)