@intlayer/docs 9.0.0-canary.6 → 9.0.0-canary.7

package/docs/de/intlayer_with_tanstack+solid.md

@@ -228,11 +228,15 @@ export default defineConfig({
     tanstackStart({
       router: {
         routeFileIgnorePattern:
-          ".content.(ts|tsx|js|mjs|cjs|jsx|json|jsonc|json5)$",
+          ".content.(ts|tsx|js|mjs|cjs|jsx|json|jsonc|json5|md|mdx|yaml|yml)$",
       },
     }),
     solidPlugin({ ssr: true }),
-    intlayer(),
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
   ],
 });
 ```
@@ -568,22 +572,25 @@ Sie können auch den `intlayerProxy` verwenden, um serverseitiges Routing zu Ihr
 
 > Beachten Sie, dass Sie für die Verwendung des `intlayerProxy` in der Produktion das Paket `vite-intlayer` von `devDependencies` zu `dependencies` verschieben müssen.
 
-```typescript {7,14-17} fileName="vite.config.ts"
+```typescript fileName="vite.config.ts"
 import { tanstackStart } from "@tanstack/solid-start/plugin/vite";
 import solid from "vite-plugin-solid";
 import { nitro } from "nitro/vite";
 import { defineConfig } from "vite";
-import { intlayer, intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
   plugins: [
-    intlayerProxy(), // Der Proxy sollte vor dem Server platziert werden, wenn Sie Nitro verwenden
     nitro(),
-    intlayer(),
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
     tanstackStart({
       router: {
         routeFileIgnorePattern:
-          ".content.(ts|tsx|js|mjs|cjs|jsx|json|jsonc|json5)$",
+          ".content.(ts|tsx|js|mjs|cjs|jsx|json|jsonc|json5|md|mdx|yaml|yml)$",
       },
     }),
     solid(),
@@ -826,9 +833,9 @@ bun x intlayer extract
  </Tab>
  <Tab value='Babel compiler'>
 
-Aktualisieren Sie Ihre `vite.config.ts`, um das `intlayerCompiler`-Plugin einzubinden:
+> Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
 
-> Seit Intlayer v9 ist der Compiler direkt in das `intlayer()` Plugin gebündelt und wird automatisch aktiviert, sobald `compiler.enabled` mit einem `compiler.output`-Pfad gesetzt ist. Die separate Registrierung von `intlayerCompiler()`, wie unten gezeigt, ist jetzt optional — er dedupliziert sich selbst, falls er hinzugefügt wird. Siehe die [v9 Release Notes](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/releases/v9.md).
+Aktualisieren Sie Ihre `vite.config.ts`, um das `intlayerCompiler`-Plugin einzubinden:
 
 ```ts fileName="vite.config.ts"
 import { intlayer, intlayerCompiler } from "vite-intlayer";
@@ -843,12 +850,12 @@ export default defineConfig({
     tanstackStart({
       router: {
         routeFileIgnorePattern:
-          ".content.(ts|tsx|js|mjs|cjs|jsx|json|jsonc|json5)$",
+          ".content.(ts|tsx|js|mjs|cjs|jsx|json|jsonc|json5|md|mdx|yaml|yml)$",
       },
     }),
     solidPlugin({ ssr: true }),
     intlayer(),
-    intlayerCompiler(),
+    intlayerCompiler(), // Adds the compiler plugin
   ],
 });
 ```

package/docs/de/intlayer_with_tanstack.md

@@ -242,11 +242,15 @@ import { intlayer } from "vite-intlayer";
 const config = defineConfig({
   plugins: [
     nitro(),
-    intlayer(),
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
     tanstackStart({
       router: {
         routeFileIgnorePattern:
-          ".content.(ts|tsx|js|mjs|cjs|jsx|json|jsonc|json5)$",
+          ".content.(ts|tsx|js|mjs|cjs|jsx|json|jsonc|json5|md|mdx|yaml|yml)$",
       },
     }),
     viteReact(),
@@ -650,22 +654,25 @@ Sie können auch den `intlayerProxy` verwenden, um serverseitiges Routing zu Ihr
 
 > Beachten Sie, dass Sie zur Verwendung des `intlayerProxy` in der Produktion das Paket `vite-intlayer` von `devDependencies` zu `dependencies` verschieben müssen.
 
-```typescript {7,14-17} fileName="vite.config.ts"
+```typescript fileName="vite.config.ts"
 import { tanstackStart } from "@tanstack/react-start/plugin/vite";
 import viteReact from "@vitejs/plugin-react";
 import { nitro } from "nitro/vite";
 import { defineConfig } from "vite";
-import { intlayer, intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
   plugins: [
-    intlayerProxy(), // Der Proxy sollte vor dem Server platziert werden, wenn Sie Nitro verwenden
     nitro(),
-    intlayer(),
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
     tanstackStart({
       router: {
         routeFileIgnorePattern:
-          ".content.(ts|tsx|js|mjs|cjs|jsx|json|jsonc|json5)$",
+          ".content.(ts|tsx|js|mjs|cjs|jsx|json|jsonc|json5|md|mdx|yaml|yml)$",
       },
     }),
     viteReact(),
@@ -906,6 +913,8 @@ bun x intlayer extract
  </Tab>
  <Tab value='Babel-Compiler'>
 
+> Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
+
 Aktualisieren Sie Ihre `vite.config.ts`, um das `intlayerCompiler`-Plugin aufzunehmen:
 
 ```ts fileName="vite.config.ts"
@@ -915,7 +924,7 @@ import { intlayer, intlayerCompiler } from "vite-intlayer";
 export default defineConfig({
   plugins: [
     intlayer(),
-    intlayerCompiler(), // Fügt das Compiler-Plugin hinzu
+    intlayerCompiler(), // Adds the compiler plugin
   ],
 });
 ```

package/docs/de/intlayer_with_vite+lit.md

@@ -205,7 +205,13 @@ import { intlayer } from "vite-intlayer";
 
 // https://vitejs.dev/config/
 export default defineConfig({
-  plugins: [intlayer()],
+  plugins: [
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
+  ],
 });
 ```
 
@@ -474,12 +480,15 @@ Fügen Sie zuerst `intlayerProxy` zu Ihrer Vite-Konfiguration hinzu:
 
 ```typescript {3,7} fileName="vite.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { defineConfig } from "vite";
-import { intlayer, intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
   plugins: [
-    intlayerProxy(), // should be placed first
-    intlayer(),
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
   ],
 });
 ```

package/docs/de/intlayer_with_vite+preact.md

@@ -829,6 +829,8 @@ bun x intlayer extract
  </Tab>
  <Tab value='Babel-Compiler'>
 
+> Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
+
 Aktualisieren Sie Ihre `vite.config.ts`, um das `intlayerCompiler`-Plugin aufzunehmen:
 
 ```ts fileName="vite.config.ts"
@@ -838,7 +840,7 @@ import { intlayer, intlayerCompiler } from "vite-intlayer";
 export default defineConfig({
   plugins: [
     intlayer(),
-    intlayerCompiler(), // Fügt das Compiler-Plugin hinzu
+    intlayerCompiler(), // Adds the compiler plugin
   ],
 });
 ```

package/docs/de/intlayer_with_vite+react.md

@@ -519,14 +519,17 @@ Parallel dazu können Sie auch das `intlayerProxy` verwenden, um serverseitiges
 ```typescript {3,7} fileName="vite.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { defineConfig } from "vite";
 import react from "@vitejs/plugin-react-swc";
-import { intlayer, intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 // https://vitejs.dev/config/
 export default defineConfig({
   plugins: [
-    intlayerProxy(), // should be placed first
     react(),
-    intlayer(),
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
   ],
 });
 ```
@@ -830,6 +833,8 @@ bun x intlayer extract
  </Tab>
  <Tab value='Babel-Compiler'>
 
+> Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
+
 Aktualisieren Sie Ihre `vite.config.ts`, um das `intlayerCompiler`-Plugin aufzunehmen:
 
 ```ts fileName="vite.config.ts"
@@ -839,7 +844,7 @@ import { intlayer, intlayerCompiler } from "vite-intlayer";
 export default defineConfig({
   plugins: [
     intlayer(),
-    intlayerCompiler(), // Fügt das Compiler-Plugin hinzu
+    intlayerCompiler(), // Adds the compiler plugin
   ],
 });
 ```

package/docs/de/intlayer_with_vite+react_compiler.md

@@ -213,11 +213,18 @@ Fügen Sie das Intlayer-Plugin zu Ihrer Konfiguration hinzu.
 ```typescript fileName="vite.config.ts"
 import { defineConfig } from "vite";
 import react from "@vitejs/plugin-react-swc";
-import { intlayer, intlayerCompiler } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 // https://vitejs.dev/config/
 export default defineConfig({
-  plugins: [react(), intlayer(), intlayerCompiler()],
+  plugins: [
+    react(),
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
+  ],
 });
 ```
 

package/docs/de/intlayer_with_vite+solid.md

@@ -596,6 +596,8 @@ bun x intlayer extract
  </Tab>
  <Tab value='Babel-Compiler'>
 
+> Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
+
 Aktualisieren Sie Ihre `vite.config.ts`, um das `intlayerCompiler`-Plugin aufzunehmen:
 
 ```ts fileName="vite.config.ts"
@@ -605,7 +607,7 @@ import { intlayer, intlayerCompiler } from "vite-intlayer";
 export default defineConfig({
   plugins: [
     intlayer(),
-    intlayerCompiler(), // Fügt das Compiler-Plugin hinzu
+    intlayerCompiler(), // Adds the compiler plugin
   ],
 });
 ```

package/docs/de/intlayer_with_vite+svelte.md

@@ -448,13 +448,16 @@ Parallel dazu können Sie auch den `intlayerProxy` verwenden, um serverseitiges
 ```typescript {3,7} fileName="vite.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { defineConfig } from "vite";
 import { svelte } from "@sveltejs/vite-plugin-svelte";
-import { intlayer, intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
   plugins: [
-    intlayerProxy(), // should be placed first
     svelte(),
-    intlayer(),
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
   ],
 });
 ```
@@ -586,6 +589,8 @@ bun x intlayer extract
  </Tab>
  <Tab value='Babel-Compiler'>
 
+> Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
+
 Aktualisieren Sie Ihre `vite.config.ts`, um das `intlayerCompiler`-Plugin aufzunehmen:
 
 ```ts fileName="vite.config.ts"
@@ -595,7 +600,7 @@ import { intlayer, intlayerCompiler } from "vite-intlayer";
 export default defineConfig({
   plugins: [
     intlayer(),
-    intlayerCompiler(), // Fügt das Compiler-Plugin hinzu
+    intlayerCompiler(), // Adds the compiler plugin
   ],
 });
 ```

package/docs/de/intlayer_with_vite+vanilla.md

@@ -205,7 +205,13 @@ import { intlayer } from "vite-intlayer";
 
 // https://vitejs.dev/config/
 export default defineConfig({
-  plugins: [intlayer()],
+  plugins: [
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
+  ],
 });
 ```
 
@@ -466,12 +472,15 @@ Fügen Sie zuerst `intlayerProxy` zu Ihrer Vite-Konfiguration hinzu:
 
 ```typescript {3,7} fileName="vite.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { defineConfig } from "vite";
-import { intlayer, intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
   plugins: [
-    intlayerProxy(), // sollte zuerst platziert werden
-    intlayer(),
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
   ],
 });
 ```
@@ -603,6 +612,8 @@ bun x intlayer extract
  </Tab>
  <Tab value='Babel-Compiler'>
 
+> Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
+
 Aktualisieren Sie Ihre `vite.config.ts`, um das Plugin `intlayerCompiler` aufzunehmen:
 
 ```ts fileName="vite.config.ts"
@@ -612,7 +623,7 @@ import { intlayer, intlayerCompiler } from "vite-intlayer";
 export default defineConfig({
   plugins: [
     intlayer(),
-    intlayerCompiler(), // Fügt das Compiler-Plugin hinzu
+    intlayerCompiler(), // Adds the compiler plugin
   ],
 });
 ```

package/docs/de/intlayer_with_vite+vue.md

@@ -638,14 +638,17 @@ Parallel dazu können Sie auch das `intlayerProxy` verwenden, um serverseitiges
 ```typescript {3,7} fileName="vite.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { defineConfig } from "vite";
 import vue from "@vitejs/plugin-vue";
-import { intlayer, intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 // https://vitejs.dev/config/
 export default defineConfig({
   plugins: [
-    intlayerProxy(), // should be placed first
     vue(),
-    intlayer(),
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
   ],
 });
 ```
@@ -970,6 +973,8 @@ bun x intlayer extract
  </Tab>
  <Tab value='Babel-Compiler'>
 
+> Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
+
 Aktualisieren Sie Ihre `vite.config.ts`, um das `intlayerCompiler`-Plugin aufzunehmen:
 
 ```ts fileName="vite.config.ts"
@@ -979,7 +984,7 @@ import { intlayer, intlayerCompiler } from "vite-intlayer";
 export default defineConfig({
   plugins: [
     intlayer(),
-    intlayerCompiler(), // Fügt das Compiler-Plugin hinzu
+    intlayerCompiler(), // Adds the compiler plugin
   ],
 });
 ```

package/docs/de/packages/@intlayer_babel/export.md

@@ -0,0 +1,131 @@
+---
+createdAt: 2026-06-25
+updatedAt: 2026-06-25
+title: "@intlayer/babel-Paketdokumentation"
+description: Babel-Plugins für Intlayer zur Handhabung der Inhaltsextraktion, Importoptimierung, Bereinigung ungenutzter Felder und Maskierung von Feldnamen während des Builds.
+keywords:
+  - "@intlayer/babel"
+  - babel
+  - plugin
+  - internationalisierung
+  - i18n
+  - compiler
+  - optimieren
+  - bereinigen
+  - minifizieren
+slugs:
+  - doc
+  - packages
+  - "@intlayer/babel"
+  - export
+history:
+  - version: 9.0.0
+    date: 2026-06-25
+    changes: "Vereinheitlichte Dokumentation aller Exporte"
+author: aymericzip
+---
+
+# @intlayer/babel-Paket
+
+Das Paket `@intlayer/babel` stellt eine Reihe spezialisierter Babel-Plugins für Intlayer bereit. Diese Plugins decken den gesamten Build-Zyklus ab: Extrahieren von Inhaltsdeklarationen, Umschreiben von `useIntlayer`- / `getIntlayer`-Aufrufen in optimierte Wörterbuch-Importe, Bereinigen ungenutzter Felder und Minimieren von Feldnamen.
+
+## Installation
+
+```bash
+npm install @intlayer/babel
+```
+
+## Exporte
+
+Import:
+
+```ts
+import { ... } from "@intlayer/babel";
+```
+
+---
+
+### Plugins
+
+| Funktion / Klasse              | Beschreibung                                                                                                                                                                                                                  |
+| ------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `intlayerExtractBabelPlugin`   | Babel-Plugin, das übersetzbare Inhalte aus Quelldateien extrahiert und `useIntlayer` / `getIntlayer` hooks automatisch einfügt. Entwickelt für die Verwendung mit Next.js und Babel-basierten Build-Tools.                    |
+| `intlayerOptimizeBabelPlugin`  | Babel-Plugin, das `useIntlayer`- und `getIntlayer`-Aufrufe transformiert und deren Importe in optimierte JSON-Wörterbuch-Importe umschreibt (statisch, dynamisch oder über fetch).                                            |
+| `intlayerPurgeBabelPlugin`     | Babel-Plugin, das Quelldateien analysiert und kompilierte Wörterbuch-JSON-Dateien umschreibt, um ungenutzte Felder zu entfernen (`build.purge`) oder sie in kurze Aliase umzubenennen (`build.minify`).                       |
+| `intlayerMinifyBabelPlugin`    | Babel-Plugin, das Quelldateien so umschreibt, dass sie die kurzen Feld-Aliase verwenden, die während der Minifizierungsphase zugewiesen wurden (z. B. `content.title` ← `content.a`). Basiert auf `intlayerPurgeBabelPlugin`. |
+| `makeFieldRenameBabelPlugin`   | Factory-Funktion, die ein Babel-Plugin erzeugt, um Zugriffe auf Inhaltsfelder von Wörterbüchern in Quelldateien entsprechend der in `PruneContext` befüllten `dictionaryKeyToFieldRenameMap` umzubenennen.                    |
+| `makeUsageAnalyzerBabelPlugin` | Factory-Funktion, die ein Babel-Plugin erzeugt, um die Verwendung von `useIntlayer` / `getIntlayer` im Quellcode zu analysieren und Feldnutzungsdaten im gemeinsamen `PruneContext` zu aggregieren.                           |
+| `getSharedPruneContext`        | Hilfsfunktion, die das gemeinsame `PruneContext`-Objekt für das angegebene Basisverzeichnis zurückgibt, oder `null`, wenn es noch nicht initialisiert wurde.                                                                  |
+
+---
+
+### Hilfsprogramme zur Plugin-Konfiguration
+
+| Funktion                   | Beschreibung                                                                                                                                                                |
+| -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `getExtractPluginOptions`  | Lädt die Intlayer-Konfiguration und gibt `ExtractPluginOptions` zurück, die für die Verwendung mit `intlayerExtractBabelPlugin` bereit sind.                                |
+| `getOptimizePluginOptions` | Lädt die Intlayer-Konfiguration und kompilierte Wörterbücher und gibt `OptimizePluginOptions` zurück, die für die Verwendung mit `intlayerOptimizeBabelPlugin` bereit sind. |
+| `getPurgePluginOptions`    | Lädt die Intlayer-Konfiguration und gibt `PurgePluginOptions` zurück, die für die Verwendung mit `intlayerPurgeBabelPlugin` bereit sind.                                    |
+| `getMinifyPluginOptions`   | Lädt die Intlayer-Konfiguration und gibt `MinifyPluginOptions` zurück, die für die Verwendung mit `intlayerMinifyBabelPlugin` bereit sind.                                  |
+
+---
+
+### Typen
+
+| Typ                     | Beschreibung                                                                                                                        |
+| ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
+| `CompilerMode`          | Compiler-Modus: `'dev'` für die Entwicklung mit HMR-Unterstützung oder `'build'` für Produktions-Builds.                            |
+| `ExtractPluginOptions`  | Optionen für `intlayerExtractBabelPlugin`: Dateiliste, Konfiguration, `onExtract`-Callback usw.                                     |
+| `ExtractResult`         | Extraktionsergebnis: Wörterbuchschlüssel, Dateipfad, Inhalt und Sprache.                                                            |
+| `OptimizePluginOptions` | Optionen für `intlayerOptimizeBabelPlugin`: Wörterbuchpfade, Importmodus, Moduszuordnung pro Wörterbuch usw.                        |
+| `PurgePluginOptions`    | Optionen für `intlayerPurgeBabelPlugin`: Basisverzeichnis, Bereinigungs-/Minifizierungs-/Optimierungs-Flags, Komponentendateiliste. |
+| `MinifyPluginOptions`   | Optionen für `intlayerMinifyBabelPlugin`: Basisverzeichnis, Minifizierungs-/Optimierungs-/editorEnabled-Flags.                      |
+| `PruneContext`          | Gemeinsamer Zustand zwischen Analyse- und Bereinigungs-Plugins: Feldnutzungszuordnungen, Umbenennungszuordnungen usw.               |
+| `DictionaryFieldUsage`  | Ergebnis der Feldnutzung für ein einzelnes Wörterbuch: `Set<string>` oder `'all'`, wenn die statische Analyse nicht eindeutig ist.  |
+| `NestedRenameEntry`     | Knoten im Umbenennungsbaum: der `shortName` und die Zuordnung der Unterknoten.                                                      |
+| `NestedRenameMap`       | Eine Ebene im Umbenennungsbaum: `Map<string, NestedRenameEntry>`.                                                                   |
+| `CompatCallerConfig`    | Konfiguration für einen kompatiblen Nutzungsanalysator für `compat-adapter`-Pakete (Name des Aufrufers und Verarbeitungsoptionen).  |
+| `ScriptBlock`           | Skriptblock, der aus einer SFC-Datei (Vue oder Svelte) extrahiert wurde: Inhalt, Start-Offset und End-Offset.                       |
+
+---
+
+### Hilfsfunktionen
+
+| Funktion                          | Beschreibung                                                                                                                                                                      |
+| --------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `generateShortFieldName`          | Konvertiert eine Ganzzahl (beginnend bei Null) in einen kurzen alphabetischen Bezeichner: `0` → `'a'`, `25` → `'z'`, `26` → `'aa'`, etc.                                          |
+| `buildNestedRenameMapFromContent` | Erstellt rekursiv eine `NestedRenameMap` aus dem Inhaltswert eines kompilierten Wörterbuchs unter Berücksichtigung von Intlayer-Knotenstrukturen (translation, enumeration usw.). |
+| `createPruneContext`              | Erstellt ein neues leeres `PruneContext`-Objekt, das mit Standardwerten initialisiert ist.                                                                                        |
+| `extractScriptBlocks`             | Extrahiert `<script>`-Blöcke aus SFC-Dateien (Vue / Svelte) für die anschließende Babel-Analyse.                                                                                  |
+| `BABEL_PARSER_OPTIONS`            | Konstante, die Babel-Parser-Optionen darstellt und die unterstützten Frameworks (React/Vue/Svelte/Angular/...) abdeckt.                                                           |
+| `INTLAYER_CALLER_NAMES`           | Konstante Liste der ursprünglichen Intlayer-Aufrufernamen: `['useIntlayer', 'getIntlayer']`.                                                                                      |
+
+---
+
+## Beispielhafte Verwendung
+
+```js
+// babel.config.js
+const {
+  intlayerExtractBabelPlugin,
+  intlayerPurgeBabelPlugin,
+  intlayerMinifyBabelPlugin,
+  intlayerOptimizeBabelPlugin,
+  getExtractPluginOptions,
+  getPurgePluginOptions,
+  getMinifyPluginOptions,
+  getOptimizePluginOptions,
+} = require("@intlayer/babel");
+
+module.exports = {
+  presets: ["next/babel"],
+  plugins: [
+    [intlayerExtractBabelPlugin, getExtractPluginOptions()],
+    [intlayerPurgeBabelPlugin, getPurgePluginOptions()],
+    [intlayerMinifyBabelPlugin, getMinifyPluginOptions()],
+    [intlayerOptimizeBabelPlugin, getOptimizePluginOptions()],
+  ],
+};
+```
+
+> **Hinweis:** Das `intlayerPurgeBabelPlugin` muss **vor** `intlayerMinifyBabelPlugin` deklariert werden, da Letzteres die von Ersterem erstellte Umbenennungszuordnung liest. Zudem muss beiden `intlayerOptimizeBabelPlugin` vorausgehen, damit es die Wörterbuchschlüssel sehen kann, bevor die `useIntlayer`-Aufrufe umgeschrieben werden.

package/docs/de/packages/vite-intlayer/intlayerCompiler.md

@@ -0,0 +1,120 @@
+---
+createdAt: 2026-06-25
+updatedAt: 2026-06-25
+title: intlayerCompiler Vite-Plugin-Dokumentation | vite-intlayer
+description: Vite-Plugin, das Inline-Intlayer-Inhaltsdeklarationen aus Komponentendateien extrahiert und sie während der Build-/Transformationszeit in Wörterbuch-JSON-Dateien schreibt.
+keywords:
+  - intlayerCompiler
+  - vite
+  - plugin
+  - compiler
+  - content
+  - dictionary
+  - internationalization
+  - i18n
+slugs:
+  - doc
+  - packages
+  - vite-intlayer
+  - intlayerCompiler
+history:
+  - version: 9.0.0
+    date: 2026-06-25
+    changes: "In intlayer() integriert; Dokumentation initialisiert"
+author: aymericzip
+---
+
+# intlayerCompiler
+
+`intlayerCompiler` ist ein Vite-Plugin, das Komponenten-Quelldateien nach **Inline-Intlayer-Inhaltsdeklarationen** scannt — also Inhalten, die direkt in einer Komponente statt in einer separaten `.content.ts`-Datei definiert sind — und diese während der Transformationsphase in Wörterbuch-JSON-Dateien schreibt.
+
+> **Seit Intlayer v9** ist `intlayerCompiler` automatisch im Hauptplugin [`intlayer()`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/packages/vite-intlayer/intlayer.md) enthalten, wenn sowohl `compiler.enabled` auf `true` gesetzt als auch `compiler.output` in Ihrer Intlayer-Konfiguration konfiguriert ist. Sie müssen es nur dann separat registrieren, wenn Sie die volle Kontrolle über die Compiler-spezifische Konfiguration wünschen.
+
+## Verwendung
+
+### Als Teil von `intlayer()` (empfohlen, v9+)
+
+Aktivieren Sie den Compiler in Ihrer Intlayer-Konfiguration:
+
+```ts
+// intlayer.config.ts
+import { defineConfig } from "intlayer";
+
+export default defineConfig({
+  compiler: {
+    enabled: true,
+    output: "./src/dictionaries", // Ort, an den extrahierte Wörterbücher geschrieben werden
+  },
+});
+```
+
+Verwenden Sie dann das Standard-Plugin ohne zusätzliche Registrierung:
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { intlayer } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [intlayer()],
+});
+```
+
+### Standalone (falls erforderlich)
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { intlayerCompiler } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [intlayerCompiler()],
+});
+```
+
+## Optionen
+
+```ts
+import type { IntlayerCompilerOptions } from "vite-intlayer";
+```
+
+| Option           | Typ                       | Beschreibung                                                                                              |
+| ---------------- | ------------------------- | --------------------------------------------------------------------------------------------------------- |
+| `configOptions`  | `GetConfigurationOptions` | Intlayer-Konfigurations-Overrides, die an `getConfiguration()` weitergeleitet werden.                     |
+| `compilerConfig` | `Partial<CompilerConfig>` | Overrides für den Compiler-spezifischen Konfigurationsabschnitt (z. B. `enabled`, `output`, `filesList`). |
+
+### Beispiel
+
+```ts
+intlayerCompiler({
+  configOptions: { configFile: "./config/intlayer.config.ts" },
+  compilerConfig: { enabled: true, output: "./src/dictionaries" },
+});
+```
+
+## Funktionsweise
+
+### Transformationsphase
+
+Für jede Quelldatei, die auf `compiler.filesList` passt, führt das Compiler-Plugin folgende Schritte aus:
+
+1. Übergibt den Dateiinhalt an `extractContent` aus `@intlayer/babel`.
+2. Ruft für jede gefundene Deklaration `onExtract` auf, wodurch die resultierende Wörterbuch-JSON-Datei in `compiler.output` geschrieben wird.
+3. Gibt den transformierten Quellcode zurück, bei dem Inline-Deklarationen durch Standardaufrufe von `useIntlayer('key')` / `getIntlayer('key')` ersetzt wurden.
+
+Unterstützte Dateitypen: `.ts`, `.tsx`, `.js`, `.jsx`, `.vue`, `.svelte`, `.astro`.
+
+### HMR (Hot Module Replacement)
+
+Wenn eine Komponentendatei im Entwicklungsmodus gespeichert wird, führt der Compiler folgende Schritte aus:
+
+1. Erkennt die Dateiänderung über Vites `handleHotUpdate`-Hook.
+2. Extrahiert den Inhalt der aktualisierten Datei erneut.
+3. Schreibt die aktualisierte Wörterbuch-JSON-Datei.
+4. Löst einen vollständigen Seitenreload aus (`server.ws.send({ type: 'full-reload' })`).
+
+Ein Debounce von 500 ms verhindert, dass das Schreiben des Wörterbuchs selbst (das ebenfalls ein Dateiänderungsereignis auslöst) eine unendliche Extraktionsschleife verursacht.
+
+### Deduplizierung
+
+`intlayerCompiler` verwendet denselben Deduplizierungsmechanismus (`createPrimaryInstanceGuard`) wie die anderen gebündelten Plugins. Wenn sowohl `intlayer()` (das den Compiler bündelt) als auch ein manueller `intlayerCompiler()`-Aufruf vorhanden sind, wird nur die erste registrierte Instanz ausgeführt — es werden keine Wörterbücher doppelt geschrieben.