---
createdAt: 2025-09-22
updatedAt: 2025-09-23
title: Neue Intlayer v7 - Was ist neu?
description: Entdecken Sie, was neu ist in Intlayer v7. Wichtige Verbesserungen in Leistung, Entwicklererfahrung und neue Funktionen zur Optimierung Ihres Internationalisierungs-Workflows.
keywords:
  - Intlayer
  - Lokalisierung
  - Entwicklung
  - Leistung
  - Entwicklererfahrung
  - Funktionen
  - React
  - Next.js
  - JavaScript
  - TypeScript
slugs:
  - doc
  - releases
  - v7
---

# Neue Intlayer v7 - Was ist neu?

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.

## Highlights

- Caching-Strategie für schnellere Builds
- Verbesserte TypeScript-Typgenerierung mit sprachspezifischen Typen
- Bundle-Optimierung: Sprachen als Strings statt als Enum
- Neue Routing-Modi: `prefix-no-default`, `prefix-all`, `no-prefix`, `search-params`
- DSGVO-konforme Sprachspeicherung mit localStorage als Standard
- Flexible Speicher-Konfiguration: Cookies, localStorage, sessionStorage oder mehrere gleichzeitig
- 30 % kleinere Paketgröße des Visual Editors
- Erweiterte Middleware-Konfigurationsoptionen
- Aktualisiertes Verhalten des Fill-Kommandos für bessere Inhaltsverwaltung
- Verbesserte Stabilität durch vollständige Aktualisierung der Content-Declaration-Dateien
- Intelligentes Retry-Management für höhere Übersetzungsgenauigkeit
- Parallelisierung für schnellere Übersetzungsverarbeitung
- Intelligentes Chunking zur Handhabung großer Dateien innerhalb der KI-Kontextgrenzen

---

## Leistung: Caching für schnellere Builds

Anstatt bei jedem Build die Content-Declaration-Dateien mit esbuild neu zu erstellen, implementiert Version 7 eine Caching-Strategie, die den Build-Prozess beschleunigt.

```bash packageManager="npm"
npx intlayer build
```

```bash packageManager="yarn"
yarn intlayer build
```

```bash packageManager="pnpm"
pnpm intlayer build
```

```bash packageManager="bun"
bun x intlayer build
```

Das neue Caching-System:

- Speichert kompilierte Content-Declaration-Dateien, um redundante Verarbeitung zu vermeiden
- Erkennt Änderungen und baut nur modifizierte Dateien neu auf
- Reduziert die Build-Zeiten bei großen Projekten erheblich

---

## TypeScript: Sprachspezifische Typgenerierung

TypeScript-Typen werden nun pro Sprache generiert, was eine stärkere Typisierung ermöglicht und Union-Typen über alle Sprachen hinweg eliminiert.

**Verhalten in v6:**

```tsx
const content = getIntlayer("my-title-content", "en");
// typeof content = { title: "My title" } | { title: "Mon titre" } | { title: "Mi título" }
```

**Verhalten in v7:**

```tsx
const content = getIntlayer("my-title-content", "en");
// typeof content = { title: "My title" }
```

Vorteile:

- Präzisere Autovervollständigung in Ihrer IDE
- Bessere Typensicherheit ohne Typverschmutzung über verschiedene Sprachen hinweg
- Verbesserte Leistung durch Reduzierung der Typkomplexität

---

## Bundle-Optimierung: Sprachen als Strings

Der Typ `Locales` ist kein Enum mehr, was bedeutet, dass er jetzt vollständig tree-shakeable ist und Ihr Bundle nicht mehr mit tausenden ungenutzten Sprachdatensätzen aufbläht.

**v6:**

```typescript
import { Locales } from "intlayer";
// Enum, das alle Sprachen enthält -> nicht tree-shakeable

const locale: Locales = Locales.ENGLISH;
```

**v7:**

```typescript
import { Locales, Locale } from "intlayer";
// String-Typ -> vollständig tree-shakeable

const locale: Locale = Locales.ENGLISH;
```

> Da `Locales` kein Enum mehr ist, müssen Sie den Typ von `Locales` zu `Locale` ändern, um die Sprache als Typ zu erhalten.

Siehe die [Implementierungsdetails](https://github.com/aymericzip/intlayer/blob/main/packages/%40intlayer/types/src/index.ts) für weitere Informationen.

---

## Neue Routing-Modi für mehr Flexibilität

v7 führt eine einheitliche `routing.mode`-Konfiguration ein, die die vorherigen Optionen `prefixDefault` und `noPrefix` ersetzt und eine feinere Steuerung der URL-Struktur ermöglicht.

### Verfügbare Routing-Modi

- **`prefix-no-default`** (Standard): Die Standardsprache hat kein Präfix, andere Sprachen schon
  - `/dashboard` (en) oder `/fr/dashboard` (fr)
- **`prefix-all`**: Alle Sprachen haben ein Präfix
  - `/en/dashboard` (en) oder `/fr/dashboard` (fr)
- **`no-prefix`**: Keine Sprachpräfixe in URLs (Sprache wird über Speicher/Header gehandhabt)
  - `/dashboard` für alle Sprachen
- **`search-params`**: Sprache wird als Abfrageparameter übergeben
  - `/dashboard?locale=en` oder `/dashboard?locale=fr`

### Grundkonfiguration

```typescript
// intlayer.config.ts
export default {
  internationalization: {
    locales: ["en", "fr", "es"],
    defaultLocale: "en",
  },
  routing: {
    mode: "prefix-no-default", // Standard
  },
};
```

---

## DSGVO-Konformität: localStorage / Cookie-Speicherung

v7 legt besonderen Wert auf den Schutz der Privatsphäre der Nutzer, indem `localStorage` als Standard-Speichermechanismus anstelle von Cookies verwendet wird. Diese Änderung unterstützt die DSGVO-Konformität, indem sie die Notwendigkeit einer Cookie-Einwilligung für Spracheinstellungen vermeidet.

### Speicher-Konfigurationsoptionen

Das neue Feld `routing.storage` ist zusätzlich zu den bisherigen Optionen `middleware.cookieName` und `middleware.serverSetCookie` verfügbar und bietet flexible Speicher-Konfigurationen:

```typescript
// Speicher deaktivieren
storage: false

// Einfache Speichertypen
storage: 'cookie'
storage: 'localStorage'
storage: 'sessionStorage'

// Cookie mit benutzerdefinierten Attributen
storage: {
  type: 'cookie',
  name: 'custom-locale',
  domain: '.example.com',
  secure: true,
  sameSite: 'strict'
}

// localStorage mit benutzerdefiniertem Schlüssel
storage: {
  type: 'localStorage',
  name: 'custom-locale'
}

// Mehrere Speichertypen zur Redundanz
storage: ['cookie', 'localStorage']
```

### DSGVO-konformes Konfigurationsbeispiel

Für produktive Anwendungen, die Funktionalität mit DSGVO-Konformität in Einklang bringen müssen:

```typescript
// intlayer.config.ts
export default {
  internationalization: {
    locales: ["en", "fr", "es"],
    defaultLocale: "en",
  },
  routing: {
    mode: "prefix-no-default",
    storage: [
      {
        type: "localStorage", // Primärer Speicher (kein Einverständnis erforderlich)
        name: "user-locale",
      },
      {
        type: "cookie", // Optionale Cookie-Speicherung (erfordert Einverständnis)
        name: "user-locale",
        secure: true,
        sameSite: "strict",
        httpOnly: false,
      },
    ],
  },
};
```

### Aktivieren / Deaktivieren der Cookie-Speicherung

Beispiel mit React / Next.js:

Kann global definiert werden:

```typescript
<IntlayerProvider isCookieEnabled={false}>
  <App />
</IntlayerProvider>
```

Kann lokal für jeden Hook überschrieben werden:

```ts
const { setLocale } = useLocale({ isCookieEnabled: false });

setLocale("en");
```

**Hinweis:** Cookies sind standardmäßig aktiviert.
**Hinweis:** Prüfen Sie die [DSGVO-Cookie-Anforderungen](https://gdpr.eu/cookies/) für Ihren spezifischen Anwendungsfall.

---

## Visual Editor: 30 % kleineres Paket

Das Visual Editor-Paket wurde optimiert und ist nun 30 % kleiner als die vorherige Version, dank:

- Verbesserungen der Leistung des Code-Editors
- Entfernung unnötiger Abhängigkeiten von Intlayer-Kernpaketen
- Besseres Tree-Shaking und Modul-Bündelung

Dies führt zu schnelleren Downloadzeiten und verbesserter Laufzeitleistung Ihrer Anwendung.

---

## 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:

### Neues Fill-Verhalten

- **`fill: true`** - Überschreibt die aktuelle Datei mit ausgefülltem Inhalt für alle Sprachen
- **`fill: "path/to/file"`** - Füllt die angegebene Datei, ohne die aktuelle Datei zu verändern
- **`fill: false`** - Deaktiviert das automatische Ausfüllen vollständig

### Verbesserte Unterstützung für komplexe Inhaltsstrukturen

Der Fill-Befehl unterstützt jetzt komplexe Inhaltsdeklarationsstrukturen, einschließlich:

- **Zusammengesetzte Objekte**: Inhaltsdeklarationen, die auf andere Objekte verweisen
- **Destrukturierter Inhalt**: Inhalt, der Destrukturierungsmuster verwendet
- **Verschachtelte Verweise**: Objekte, die sich in komplexen Hierarchien gegenseitig aufrufen
- **Dynamische Inhaltsstrukturen**: Inhalt mit bedingten oder berechneten Eigenschaften

### Vorteile

- **Klarere Absicht**: Das Verhalten ist jetzt expliziter bezüglich dessen, was geändert wird
- **Bessere Trennung**: Inhaltsdateien können von ausgefüllten Übersetzungen getrennt gehalten werden
- **Verbesserter Arbeitsablauf**: Entwickler haben mehr Kontrolle darüber, wo Übersetzungen gespeichert werden
- **Unterstützung komplexer Strukturen**: Umgang mit anspruchsvollen Inhaltsarchitekturen mit mehreren miteinander verbundenen Objekten

### Beispielanwendung

```typescript
// Überschreibt die aktuelle Datei mit allen Sprachversionen
const content = {
  key: "example",
  fill: true, // Überschreibt diese Datei
  content: {
    title: "Hello World",
  },
};

// Füllt eine separate Datei, ohne die aktuelle Datei zu ändern
const content = {
  key: "example",
  fill: "./translations.json", // Erstellt/aktualisiert translations.json
  content: {
    title: "Hello World",
  },
};

// Deaktiviert Auto-Fill
const content = {
  key: "example",
  fill: false, // Kein Auto-Fill
  content: {
    title: "Hallo Welt",
  },
};

// Komplexe Inhaltsstruktur mit zusammengesetzten Objekten
const sharedContent = {
  buttons: {
    save: "Speichern", // Speichern-Button
    cancel: "Abbrechen", // Abbrechen-Button
  },
};

const content = {
  key: "complex-example",
  fill: true,
  content: {
    // Verweise auf andere Objekte
    sharedContent,

    // Destrukturierter Inhalt
    ...sharedContent,

    // Verschachtelte Verweise
    sections: [
      {
        ...sharedContent.buttons,
        header: "Abschnitt 1",
      },
    ],
  },
};
```

---

## Verbesserte Stabilität und Übersetzungsverwaltung

v7 führt mehrere Verbesserungen ein, um die Inhaltsübersetzung zuverlässiger und effizienter zu gestalten:

### Vollständige Aktualisierung der Inhaltsdeklarationsdateien

Das System aktualisiert jetzt `.content.{ts,js,cjs,mjs}`-Dateien anstelle von Teilaktualisierungen, was sicherstellt:

- **Datenintegrität**: Vollständige Datei-Neuschreibungen verhindern partielle Updates, die Inhalte beschädigen könnten
- **Konsistenz**: Alle Sprachversionen werden atomar aktualisiert, um Synchronisation zu gewährleisten
- **Zuverlässigkeit**: Verringert das Risiko unvollständiger oder fehlerhafter Inhaltsdateien

### Intelligentes Wiederholungsmanagement

Neue Wiederholungsmechanismen verhindern das Hochladen von Inhalten in falschen Formaten und vermeiden, dass der gesamte Füllprozess bei einem fehlgeschlagenen Request abbricht.

### Parallelisierung für schnellere Verarbeitung

Übersetzungsoperationen werden jetzt in einer Warteschlange ausgeführt, um sie parallel laufen zu lassen. Dies beschleunigt den Prozess erheblich.

### Intelligentes Chunking für große Dateien

Fortschrittliche Chunking-Strategien verarbeiten große Inhaltsdateien, ohne die Kontextfenster der KI zu überschreiten:

### Beispiel-Workflow

```typescript
// Große Inhaltsdatei wird automatisch in Chunks aufgeteilt
const content = {
  key: "large-documentation",
  fill: true,
  content: {
    // Große Inhalte werden automatisch für die KI-Verarbeitung in Abschnitte unterteilt
    introduction: "..." // 5000+ Zeichen
    sections: [
      // Mehrere große Abschnitte
    ]
  }
};
```

Das System führt automatisch aus:

1. Analysiert die Größe und Struktur des Inhalts
2. Unterteilt den Inhalt angemessen in Abschnitte
3. Verarbeitet die Abschnitte parallel
4. Validiert und versucht bei Bedarf erneut
5. Rekonstruiert die vollständige Datei

---

## Migrationshinweise von v6

### Entfernte Konfigurationen

- **`middleware.cookieName`**: Ersetzt durch `routing.storage`
- **`middleware.serverSetCookie`**: Ersetzt durch `routing.storage`
- **`middleware.prefixDefault`**: Ersetzt durch `routing.mode`
- **`middleware.noPrefix`**: Ersetzt durch `routing.mode`

### Migrationszuordnung

#### Konfigurationszuordnung

| v6 Konfiguration           | v7 Konfiguration                                                     |
| -------------------------- | -------------------------------------------------------------------- |
| `autoFill: xxx`            | `fill: xxx`                                                          |
| `prefixDefault: false`     | `mode: 'prefix-no-default'`                                          |
| `prefixDefault: true`      | `mode: 'prefix-all'`                                                 |
| `noPrefix: true`           | `mode: 'no-prefix'`                                                  |
| `cookieName: 'my-locale'`  | `storage: { type: 'cookie', name: 'my-locale' }`                     |
| `serverSetCookie: 'never'` | `storage: false` oder entfernen Sie den Cookie aus dem Storage-Array |

#### Beispiel Migration

**Vorher (v6):**

```typescript
export default {
  middleware: {
    headerName: "x-intlayer-locale",
    cookieName: "intlayer-locale",
    prefixDefault: false,
    basePath: "",
    serverSetCookie: "always",
    noPrefix: false,
  },
};
```

**Nachher (v7):**

```typescript
export default {
  routing: {
    mode: "prefix-no-default",
    storage: "localStorage", // oder 'cookie', falls Cookie-Speicherung benötigt wird
    headerName: "x-intlayer-locale",
    basePath: "",
  },
};
```

#### Wörterbuch-Inhaltszuordnung

| v6 Wörterbuch-Inhalt | v7 Wörterbuch-Inhalt |
| -------------------- | -------------------- |
| `autoFill: xxx`      | `fill: xxx`          |

#### Beispiel Migration

**Vorher (v6):**

```typescript
const content = {
  key: "example",
  autoFill: true, // Überschreibt diese Datei
  content: {
    title: "Hallo Welt",
  },
};
```

**Nach (v7):**

```typescript
const content = {
  key: "example",
  fill: true, // Überschreibt diese Datei
  content: {
    title: "Hallo Welt",
  },
};
```

---

## Migrationshinweise von v5 zu v6

Siehe die [Migrationshinweise von v5 zu v6](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/releases/v6.md) für weitere Informationen.

---

## Nützliche Links

- [Konfigurationsreferenz](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/configuration.md)
- [Middleware-Dokumentation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/packages/next-intlayer/index.md)
- [TypeScript-Typen](https://github.com/aymericzip/intlayer/blob/main/packages/%40intlayer/types/src/index.ts)
- [DSGVO Cookie-Richtlinien](https://gdpr.eu/cookies/)
