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

package/docs/de/dynamic_dictionaries/index.md

@@ -1,13 +1,12 @@
 ---
 createdAt: 2026-06-12
-updatedAt: 2026-06-12
+updatedAt: 2026-06-26
 title: Dynamische Wörterbücher
-description: Übersicht über die drei dynamischen Wörterbuchfunktionen von Intlayer — Sammlungen, Varianten und dynamische Einträge — zur Erstellung flexibler, zur Laufzeit gesteuerter i18n-Inhalte.
+description: Überblick über die Funktionen für dynamische Wörterbücher von Intlayer — Sammlungen und Varianten — zum Erstellen flexibler, zur Laufzeit gesteuerter i18n-Inhalte.
 keywords:
   - Dynamische Wörterbücher
   - Sammlungen
   - Varianten
-  - Dynamische Einträge
   - Intlayer
   - Internationalisierung
 slugs:
@@ -17,38 +16,39 @@ slugs:
 history:
   - version: 9.0.0
     date: 2026-06-12
-    changes: "Veröffentlichung der dynamischen Wörterbuchfunktion"
+    changes: "Veröffentlichung der Funktion für dynamische Wörterbücher"
+  - version: 9.1.0
+    date: 2026-06-26
+    changes: "Dynamische Datensätze in Varianten zusammengeführt — `variant` akzeptiert jetzt einen String oder ein Objekt"
 author: aymericzip
 ---
 
 # Dynamische Wörterbücher
 
-Intlayer unterstützt drei Mechanismen zur Darstellung von Inhalten, die über ein einzelnes statisches Wörterbuch pro Schlüssel hinausgehen. Jeder Mechanismus wird über ein **Metadatenfeld auf oberster Ebene** in der Inhaltsdatei deklariert; es ist keine Wrapper-Funktion erforderlich.
+Intlayer unterstützt zwei Mechanismen, um Inhalte auszudrücken, die über ein einzelnes statisches Wörterbuch pro Schlüssel hinausgehen. Jeder wird über ein **Metadatenfeld auf oberster Ebene** in der Inhaltsdatei deklariert; es ist keine Wrapper-Funktion nötig.
 
-| Funktion                                                                                                                     | Metadatenfeld     | Selector in `useIntlayer` |
-| ---------------------------------------------------------------------------------------------------------------------------- | ----------------- | ------------------------- |
-| [Sammlungen](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/dynamic_dictionaries/collections.md)              | `item: N`         | `{ item: N }`             |
-| [Varianten](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/dynamic_dictionaries/variants.md)                  | `variant: "name"` | `{ variant: "name" }`     |
-| [Dynamische Einträge](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/dynamic_dictionaries/dynamic_content.md) | `meta: { id, … }` | `{ id, … }`               |
+| Funktion                                                                                                        | Metadatenfeld                             | Selektor in `useIntlayer`                         |
+| --------------------------------------------------------------------------------------------------------------- | ----------------------------------------- | ------------------------------------------------- |
+| [Sammlungen](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/dynamic_dictionaries/collections.md) | `item: N`                                 | `{ item: N }`                                     |
+| [Varianten](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/dynamic_dictionaries/variants.md)     | `variant: "name"` _oder_ `variant: { … }` | `{ variant: "name" }` _oder_ `{ variant: { … } }` |
 
-Alle drei lassen sich mit dem Locale-Argument kombinieren und unterstützen selektives / Lazy Loading via `importMode`.
+Beide lassen sich mit dem locale-Argument kombinieren und unterstützen selektives / verzögertes Laden über `importMode`.
 
-<h2>Wann was zu verwenden ist</h2>
+## Wann was verwenden
 
 - **Sammlungen** — geordnete Liste von Elementen, die in separaten Dateien verwaltet werden (FAQ-Einträge, Blogbeiträge, Produkte).
-- **Varianten** — benannte Inhaltsalternativen für A/B-Tests, saisonale Banner oder Feature-Flags.
-- **Dynamische Einträge** — Inhalte, die zur Laufzeit über eine opake ID abgerufen werden (CMS-Einträge, benutzerspezifische Texte).
+- **Varianten** — benannte oder strukturierte Inhaltsalternativen:
+  - eine **String**-Variante für A/B-Tests, saisonale Banner oder Funktion-Flags;
+  - eine **Objekt**-Variante für CMS-Datensätze, benutzerspezifische Inhalte oder beliebige Inhalte, die über eine Reihe von Feldern adressiert werden (die früheren „dynamischen Datensätze").
 
-## Wann man welches verwendet
+> Frühere Versionen boten ein separates `meta`-Feld für datensatzbasierte Inhalte. Es wurde in `variant` zusammengeführt: Übergeben Sie ein **Objekt** an `variant`, anstatt `meta` zu verwenden.
 
-- **Collections** — geordnete Liste von Elementen, die in separaten Dateien verwaltet werden (FAQ-Einträge, Blogbeiträge, Produkte).
-- **Variants** — benannte Inhaltsvarianten für A/B-Tests, saisonale Banner oder Feature Flags.
-- **Dynamic records** — Inhalte, die zur Laufzeit über eine undurchsichtige ID abgerufen werden (CMS-Datensätze, benutzerspezifische Texte).
+## Selektor-Disambiguierung
 
-## Selektor-Eindeutigkeit
-
-Wenn mehrere Selektoren für ein Wörterbuch vorhanden sind, ist die Reihenfolge der Auflösung:
+Ein Schlüssel kann beide Dimensionen gleichzeitig deklarieren (z. B. eine Sammlung, deren Elemente jeweils eine Variante haben). Sie werden in dieser Reihenfolge aufgelöst:
 
 ```
-variant → meta → item
+variant → item
 ```
+
+So gibt `{ variant: "promo" }` bei einem Variant-×-Item-Schlüssel alle Promo-Elemente als Array zurück, und das Hinzufügen von `{ item: 2 }` grenzt es auf einen einzelnen Eintrag ein.

package/docs/de/dynamic_dictionaries/variants.md

@@ -1,13 +1,15 @@
 ---
 createdAt: 2026-06-12
-updatedAt: 2026-06-12
+updatedAt: 2026-06-26
 title: Varianten
-description: Verwenden Sie das Metadatenfeld variant in Inhaltsdateien von Intlayer, um benannte Inhaltsalternativen zu deklarieren (A/B-Tests, saisonale Banner, durch Feature-Flags gesteuerte Texte) und wechseln Sie zur Laufzeit ohne Codeänderungen zwischen ihnen.
+description: Verwenden Sie das variant-Metadatenfeld in Intlayer-Inhaltsdateien, um benannte oder strukturierte Inhaltsalternativen zu deklarieren — A/B-Tests, saisonale Banner, Feature-Flag-Texte, CMS-Datensätze, benutzerspezifische Inhalte — und zur Laufzeit ohne Codeänderungen zwischen ihnen zu wechseln.
 keywords:
   - Varianten
   - A/B-Tests
   - Feature-Flags
   - Dynamischer Inhalt
+  - Dynamische Datensätze
+  - CMS
   - Intlayer
   - Internationalisierung
 slugs:
@@ -18,16 +20,26 @@ history:
   - version: 9.0.0
     date: 2026-06-12
     changes: "Veröffentlichung der Varianten-Funktion"
+  - version: 9.1.0
+    date: 2026-06-26
+    changes: "`variant` akzeptiert jetzt einen String oder ein Objekt — die früheren `meta` / dynamischen Datensätze werden als Objekt-Varianten deklariert"
 author: aymericzip
 ---
 
 # Varianten
 
-Eine **Variante** (Variant) ist ein Satz von Inhaltsdateien, die denselben Wörterbuchschlüssel (`key`) teilen, aber jeweils einen anderen `variant`-Namen tragen. Intlayer liefert die entsprechende Datei basierend auf dem an `useIntlayer` übergebenen Selektor aus.
+Eine **Variante** ist eine Gruppe von Inhaltsdateien, die denselben Wörterbuch-`key` teilen, aber jeweils einen anderen `variant`-Wert tragen. Intlayer liefert die passende Datei basierend auf dem an `useIntlayer` übergebenen Selektor.
 
-## Deklarieren von Varianten
+Der `variant`-Wert kann **zwei Formen** annehmen:
 
-Jede Datei repräsentiert eine benannte Alternative. Wenn `variant` weggelassen wird (oder auf `"default"` gesetzt wird), gilt dies als Standardvariante (Fallback).
+- **Ein String** — eine einzelne benannte Alternative (A/B-Tests, saisonale Banner, Feature-Flags).
+- **Ein Objekt** — ein strukturierter Diskriminator, der über eine Reihe von Feldern adressiert wird (CMS-Datensätze, benutzerspezifische Inhalte, beliebige Inhalte mit einer opaken ID als Schlüssel). Das gesamte Objekt ist die Identität: Der Selektor muss ein **gleiches** Objekt liefern, um den Eintrag aufzulösen.
+
+> Die Objektform ersetzt das frühere `meta`-Feld. Überall, wo Sie zuvor `meta: { id, … }` geschrieben haben, schreiben Sie `variant: { id, … }` und wählen es mit `{ variant: { id, … } }` aus.
+
+## Benannte (String-)Varianten
+
+Jede Datei stellt eine benannte Alternative dar. Das Weglassen von `variant` (oder das Setzen auf `"default"`) markiert sie als Fallback.
 
 ```ts fileName="hero-banner.content.ts" contentDeclarationFormat={["typescript", "esm", "commonjs"]}
 import { t, type Dictionary } from "intlayer";
@@ -65,9 +77,9 @@ const dictionary = {
 export default dictionary;
 ```
 
-## Nutzen von Varianten
+### Benannte Varianten verwenden
 
-### Standardvariante
+#### Standardvariante
 
 <Tabs group="framework">
   <Tab label="React" value="react">
@@ -209,7 +221,7 @@ export default dictionary;
   </Tab>
 </Tabs>
 
-### Benannte Variante
+#### Benannte Variante
 
 ```tsx
 const { headline, cta } = useIntlayer("hero-banner", {
@@ -217,18 +229,264 @@ const { headline, cta } = useIntlayer("hero-banner", {
 });
 ```
 
-### Benannte Variante mit explizitem Locale
+#### Benannte Variante mit explizitem Locale
 
 ```tsx
 const content = useIntlayer("hero-banner", {
   variant: "black_friday",
-  locale: "de",
+  locale: "fr",
 });
 ```
 
+## Objekt-Varianten (strukturiert)
+
+Eine Objekt-Variante adressiert Inhalte über eine beliebige Menge von Schlüssel-Wert-Paaren, die im `variant`-Feld deklariert sind — wodurch sich CMS-Datensätze, benutzerspezifische Inhalte oder beliebige Inhalte mit einer opaken ID als Schlüssel modellieren lassen. Das **gesamte Objekt** ist die Identität: Der Selektor muss ein gleiches Objekt liefern, damit der Eintrag aufgelöst wird.
+
+```ts fileName="product.abc.content.ts" contentDeclarationFormat={["typescript", "esm", "commonjs"]}
+import { t, type Dictionary } from "intlayer";
+
+const dictionary = {
+  key: "product",
+  variant: { id: "prod_abc", userId: "user_123" },
+  content: {
+    name: t({ en: "Widget Pro", fr: "Widget Pro" }),
+    description: t({ en: "The best widget.", fr: "Le meilleur widget." }),
+  },
+} satisfies Dictionary;
+
+export default dictionary;
+```
+
+```ts fileName="product.abcd.content.ts" contentDeclarationFormat={["typescript", "esm", "commonjs"]}
+import { t, type Dictionary } from "intlayer";
+
+const dictionary = {
+  key: "product",
+  variant: { id: "prod_abcd", userId: "user_123" },
+  content: {
+    name: t({ en: "Widget Lite", fr: "Widget Lite" }),
+    description: t({ en: "A lighter option.", fr: "Une option plus légère." }),
+  },
+} satisfies Dictionary;
+
+export default dictionary;
+```
+
+### Objekt-Varianten verwenden
+
+Übergeben Sie das passende Objekt an `variant`. Jedes im Wörterbuch deklarierte Feld muss angegeben und gleich sein; andernfalls ist das Ergebnis `null`. Die Reihenfolge der Felder spielt keine Rolle.
+
+<Tabs group="framework">
+  <Tab label="React" value="react">
+    ```tsx fileName="Product.tsx" contentDeclarationFormat={["typescript", "esm", "commonjs"]}
+    import { useIntlayer } from "react-intlayer";
+
+    export const Product = ({
+      productId,
+      userId,
+    }: {
+      productId: string;
+      userId: string;
+    }) => {
+      const content = useIntlayer("product", {
+        variant: { id: productId, userId },
+      });
+
+      if (!content) return null;
+
+      return <p>{content.description}</p>;
+    };
+    ```
+
+  </Tab>
+  <Tab label="Next.js" value="nextjs">
+    ```tsx fileName="Product.tsx" contentDeclarationFormat={["typescript", "esm", "commonjs"]}
+    import { useIntlayer } from "next-intlayer";
+
+    export const Product = ({
+      productId,
+      userId,
+    }: {
+      productId: string;
+      userId: string;
+    }) => {
+      const content = useIntlayer("product", {
+        variant: { id: productId, userId },
+      });
+
+      if (!content) return null;
+
+      return <p>{content.description}</p>;
+    };
+    ```
+
+  </Tab>
+  <Tab label="Vue" value="vue">
+    ```vue fileName="Product.vue" contentDeclarationFormat={["typescript", "esm", "commonjs"]}
+    <script setup>
+    import { useIntlayer } from "vue-intlayer";
+
+    const props = defineProps({
+      productId: String,
+      userId: String,
+    });
+
+    const content = useIntlayer("product", {
+      variant: { id: props.productId, userId: props.userId },
+    });
+    </script>
+
+    <template>
+      <p v-if="content">{{ content.description }}</p>
+    </template>
+    ```
+
+  </Tab>
+  <Tab label="Svelte" value="svelte">
+    ```svelte fileName="Product.svelte" contentDeclarationFormat={["typescript", "esm", "commonjs"]}
+    <script lang="ts">
+    import { useIntlayer } from "svelte-intlayer";
+
+    export let productId: string;
+    export let userId: string;
+
+    const content = useIntlayer("product", {
+      variant: { id: productId, userId },
+    });
+    </script>
+
+    {#if $content}
+      <p>{$content.description}</p>
+    {/if}
+    ```
+
+  </Tab>
+  <Tab label="Preact" value="preact">
+    ```tsx fileName="Product.tsx" contentDeclarationFormat={["typescript", "esm", "commonjs"]}
+    import { useIntlayer } from "preact-intlayer";
+
+    export const Product = ({
+      productId,
+      userId,
+    }: {
+      productId: string;
+      userId: string;
+    }) => {
+      const content = useIntlayer("product", {
+        variant: { id: productId, userId },
+      });
+
+      if (!content) return null;
+
+      return <p>{content.description}</p>;
+    };
+    ```
+
+  </Tab>
+  <Tab label="Solid" value="solid">
+    ```tsx fileName="Product.tsx" contentDeclarationFormat={["typescript", "esm", "commonjs"]}
+    import { useIntlayer } from "solid-intlayer";
+
+    export const Product = (props: {
+      productId: string;
+      userId: string;
+    }) => {
+      const content = useIntlayer("product", {
+        variant: { id: props.productId, userId: props.userId },
+      });
+
+      return (
+        <>
+          {content() && <p>{content().description}</p>}
+        </>
+      );
+    };
+    ```
+
+  </Tab>
+  <Tab label="Angular" value="angular">
+    ```typescript fileName="product.component.ts" contentDeclarationFormat={["typescript", "esm", "commonjs"]}
+    import { Component, Input, OnInit } from "@angular/core";
+    import { useIntlayer } from "angular-intlayer";
+
+    @Component({
+      selector: "app-product",
+      template: `
+        @if (content()) {
+          <p>{{ content().description }}</p>
+        }
+      `,
+    })
+    export class ProductComponent implements OnInit {
+      @Input() productId!: string;
+      @Input() userId!: string;
+
+      content: any;
+
+      ngOnInit() {
+        this.content = useIntlayer("product", {
+          variant: { id: this.productId, userId: this.userId },
+        });
+      }
+    }
+    ```
+
+  </Tab>
+  <Tab label="Vanilla JS" value="vanilla">
+    ```javascript fileName="product.js"
+    import { useIntlayer } from "vanilla-intlayer";
+
+    const content = useIntlayer("product", {
+      variant: { id: "prod_abcd", userId: "user_123" },
+    });
+
+    if (content) {
+      document.body.innerHTML = `<p>${content.description}</p>`;
+    }
+    ```
+
+  </Tab>
+</Tabs>
+
+#### Mit explizitem Locale
+
+```tsx
+const content = useIntlayer("product", {
+  variant: { id: "prod_abc", userId: "user_123" },
+  locale: "fr",
+});
+```
+
+#### Fehlendes Feld — keine Übereinstimmung
+
+```ts
+// Gibt null zurück: `userId` fehlt, daher passt das Objekt nicht zur deklarierten Variante
+const content = useIntlayer("product", { variant: { id: "prod_abc" } });
+```
+
+## Lademodus
+
+Objekt-Varianten werden oft verzögert geladen. Setzen Sie `importMode` im Wörterbuch, um dies zu steuern:
+
+```ts contentDeclarationFormat={["typescript", "esm", "commonjs"]}
+const dictionary = {
+  key: "product",
+  importMode: "fetch", // or "dynamic"
+  variant: { id: "prod_abc", userId: "user_123" },
+  content: { … },
+} satisfies Dictionary;
+
+export default dictionary;
+```
+
+Siehe [Bundle-Optimierung](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/bundle_optimization.md) für Details zu den Modi `static`, `dynamic` und `fetch`.
+
 ## Typische Anwendungsfälle
 
-- A/B-Kopiertests, die durch einen Experiment-Schlüssel gesteuert werden
-- Saisonale oder Werbe-Banner
-- Über Feature-Flags gesteuerte Nachrichten
-- Lokalspezifische Marketingkampagnen
+- A/B-Texttests, gesteuert durch einen Experiment-Schlüssel
+- Saisonale oder Werbebanner
+- Feature-Flag-gesteuerte Nachrichten
+- Locale-spezifische Marketingkampagnen
+- Produktspezifische Marketingtexte, die in einem CMS verwaltet werden
+- Benutzer- oder kontospezifische Inhalte
+- Beliebige Inhalte, die durch eine opake Laufzeit-ID adressiert werden

package/docs/de/plugins/sync-json.md

@@ -108,7 +108,6 @@ const config: IntlayerConfig = {
      * Lädt die Ausgabe und Übersetzungen und schreibt sie zurück in die JSON-Dateien im locales-Verzeichnis
      */
     syncJSON({
-      format: "i18next",
       source: ({ key, locale }) => `./locales/${locale}/${key}.json`,
       priority: 0,
       format: "i18next",

package/docs/de/releases/v9.md

@@ -1,15 +1,14 @@
 ---
 createdAt: 2026-06-14
-updatedAt: 2026-06-25
+updatedAt: 2026-06-26
 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.
+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 und Variants.
 keywords:
   - Intlayer
   - Compatibility
   - Migration
   - Collections
   - Variants
-  - Dynamic Records
   - i18next
   - next-intl
   - vue-i18n
@@ -22,7 +21,7 @@ author: aymericzip
 
 # Neues Intlayer v9 – Was ist neu?
 
-Willkommen bei Intlayer v9! Dieses Major Release markiert einen riesigen Meilenstein bei der Vereinfachung des Migrationspfads zu Intlayer mit **Compat Adapter Packages** für wichtige i18n-Bibliotheken (`react-i18next`, `next-intl`, `vue-i18n`, etc.) und fügt Unterstützung für reichhaltige Inhaltsstrukturen hinzu: **Collections**, **Variants** und **Dynamic Records**.
+Willkommen bei Intlayer v9! Dieses Major Release markiert einen riesigen Meilenstein bei der Vereinfachung des Migrationspfads zu Intlayer mit **Compat Adapter Packages** für wichtige i18n-Bibliotheken (`react-i18next`, `next-intl`, `vue-i18n`, etc.) und fügt Unterstützung für reichhaltige Inhaltsstrukturen hinzu: **Collections** und **Variants**.
 
 ## Inhaltsverzeichnis
 
@@ -41,8 +40,10 @@ Durch das Ersetzen von Imports erhalten Sie alle Vorteile von Intlayer (einschli
 - `@intlayer/i18next`
 - `@intlayer/react-i18next`
 - `@intlayer/next-intl`
+- `@intlayer/react-intl`
 - `@intlayer/next-i18next`
 - `@intlayer/vue-i18n`
+- `@intlayer/lingui`
 
 Ändern Sie zum Beispiel einfach:
 
@@ -100,7 +101,7 @@ Alle Kompatibilitätsadapter leiten die Übersetzungsauflösung nun über einen
 
 ---
 
-## Feature Spec: Collections, Variants & Dynamic Records
+## Feature Spec: Collections & Variants
 
 Intlayer v9 geht über statische Schlüssel-Wert-Objekte hinaus und ermöglicht es Dictionaries, dynamische Layout-Strukturen zu deklarieren, die End-to-End vollständig typisiert sind.
 
@@ -144,6 +145,8 @@ const faq = useIntlayer("faq", { item: 1 }); // -> { question: string, answer: s
 
 Liefern Sie A/B-Tests, saisonale Header, Feature Flags oder benutzerdefinierte Landing Pages:
 
+#### String-Varianten (z. B. A/B-Tests)
+
 ```ts fileName="hero.content.ts"
 import { t, type Dictionary } from "intlayer";
 
@@ -167,16 +170,14 @@ export default {
 const banner = useIntlayer("hero-banner", { variant: "black_friday" });
 ```
 
-### 3. Dynamic Records
-
-Definieren Sie Dictionaries, deren Einträge zur Laufzeit dynamisch über Query-IDs geladen werden:
+#### Objekt-Varianten (z. B. Dynamic Records)
 
 ```ts fileName="product.content.ts"
 import { t, type Dictionary } from "intlayer";
 
 export default {
   key: "product-copy",
-  meta: {
+  variant: {
     id: "prod_123",
     category: "books",
   },
@@ -229,7 +230,7 @@ export default defineConfig({
 });
 ```
 
-- **Compiler**: Aktiviert sich automatisch, wenn `compiler.enabled` gesetzt ist und ein `compiler.output` Pfad konfiguriert ist. Sie müssen `intlayerCompiler()` nicht mehr separat registrieren.
+- **Compiler**: Aktiviert sich automatisch, wenn `compiler.enabled` auf `true` 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
@@ -252,6 +253,27 @@ Die eigenständigen `intlayerCompiler()` und `intlayerProxy()` Plugins bleiben f
 
 ---
 
+## Compiler standardmäßig deaktiviert
+
+Ab Intlayer v9 ist der **Compiler standardmäßig deaktiviert** (`compiler.enabled` ist jetzt standardmäßig `false`). Um die Extraktion Ihrer `.content.ts`-Dateien zur Build-Zeit zu aktivieren, setzen Sie `compiler.enabled: true` in Ihrer Konfiguration:
+
+```ts fileName="intlayer.config.ts"
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  compiler: {
+    enabled: true, // Standard: false — seit v9 erforderlich, um den Compiler zu aktivieren
+    output: ({ fileName }) => `./${fileName}.content.ts`,
+  },
+};
+
+export default config;
+```
+
+Wenn der Compiler deaktiviert ist, überspringt Intlayer den Extraktionsschritt zur Build-Zeit und verlässt sich auf Ihre bereits deklarierten Dictionaries. Aktivieren Sie ihn nur, wenn das Bundler-Plugin (`@intlayer/swc`, `@intlayer/babel` oder das `intlayer()` Vite-Plugin) den Inhalt automatisch extrahieren soll.
+
+---
+
 ## React Native: Importe aus einem einzigen Paket
 
 In einer React Native- oder Expo-App müssen Sie nicht mehr beide Pakete `react-intlayer` und `react-native-intlayer` jonglieren. Das Paket `react-native-intlayer` **re-exportiert nun die vollständige `react-intlayer` API** (Hooks, Utilities sowie die Subpfade `/format`, `/html` und `/markdown`), und sein `IntlayerProvider` wendet automatisch die React Native Polyfills an.
@@ -278,13 +300,14 @@ npm install intlayer react-native-intlayer
 
 Wenn Sie von v8 upgraden, beachten Sie, dass v9 keine Breaking Changes enthält. Hier sind jedoch die wichtigsten Änderungen:
 
+- **Compiler standardmäßig deaktiviert**: `compiler.enabled` ist jetzt standardmäßig `false`. Wenn Sie auf die Extraktion Ihrer `.content.ts`-Dateien zur Build-Zeit angewiesen sind, setzen Sie `compiler.enabled: true` in Ihrer `intlayer.config.ts`.
 - **Locales & Dialects**: Wenn Sie externe i18n-Abhängigkeiten verwenden, fügen Sie deren entsprechende Kompatibilitätsadapter-Plugins in Ihrer Konfiguration oder Ihrem Bundler-Setup hinzu, um Imports automatisch umzuschreiben.
-- **Custom Selectors**: Beim Aufruf von `useIntlayer` ist der zweite Parameter nun für ein Options-Objekt reserviert, das `{ locale, item, variant, id }` enthält. Wenn Sie zuvor direkt einen Locale-String übergeben haben, können Sie dies weiterhin tun, aber die Verwendung des Options-Objekts wird für erweiterte Auswahlen empfohlen.
+- **Custom Selectors**: Beim Aufruf von `useIntlayer` ist der zweite Parameter nun für ein Options-Objekt reserviert, das `{ locale, item, variant }` enthält. Wenn Sie zuvor direkt einen Locale-String übergeben haben, können Sie dies weiterhin tun, aber die Verwendung des Options-Objekts wird für erweiterte Auswahlen empfohlen.
 
 ---
 
 ## Nützliche Links
 
 - [Leitfaden für Compat Adapter Packages](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/compat/index.md)
-- [Dynamische Dictionaries – Collections, Variants & Dynamic Records](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/dynamic_dictionaries/index.md)
+- [Dynamische Dictionaries – Collections & Variants](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/dynamic_dictionaries/index.md)
 - [Konfigurationsreferenz](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/configuration.md)

package/docs/en/dynamic_dictionaries/index.md

@@ -1,13 +1,12 @@
 ---
 createdAt: 2026-06-12
-updatedAt: 2026-06-12
+updatedAt: 2026-06-26
 title: Dynamic Dictionaries
-description: Overview of Intlayer's three dynamic dictionary features — collections, variants, and dynamic records — for building flexible, runtime-driven i18n content.
+description: Overview of Intlayer's dynamic dictionary features — collections and variants — for building flexible, runtime-driven i18n content.
 keywords:
   - Dynamic Dictionaries
   - Collections
   - Variants
-  - Dynamic Records
   - Intlayer
   - Internationalization
 slugs:
@@ -18,31 +17,38 @@ history:
   - version: 9.0.0
     date: 2026-06-12
     changes: "Release of the dynamic dictionaries feature"
+  - version: 9.1.0
+    date: 2026-06-26
+    changes: "Merged dynamic records into variants — `variant` now accepts a string or an object"
 author: aymericzip
 ---
 
 # Dynamic Dictionaries
 
-Intlayer supports three mechanisms for expressing content that goes beyond a single static dictionary per key. Each is declared through a **top-level metadata field** in the content file; no wrapper function is needed.
+Intlayer supports two mechanisms for expressing content that goes beyond a single static dictionary per key. Each is declared through a **top-level metadata field** in the content file; no wrapper function is needed.
 
-| Feature                                                                                                                  | Metadata field    | Selector in `useIntlayer` |
-| ------------------------------------------------------------------------------------------------------------------------ | ----------------- | ------------------------- |
-| [Collections](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/dynamic_dictionaries/collections.md)         | `item: N`         | `{ item: N }`             |
-| [Variants](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/dynamic_dictionaries/variants.md)               | `variant: "name"` | `{ variant: "name" }`     |
-| [Dynamic Records](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/dynamic_dictionaries/dynamic_content.md) | `meta: { id, … }` | `{ id, … }`               |
+| Feature                                                                                                          | Metadata field                          | Selector in `useIntlayer`                       |
+| ---------------------------------------------------------------------------------------------------------------- | --------------------------------------- | ----------------------------------------------- |
+| [Collections](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/dynamic_dictionaries/collections.md) | `item: N`                               | `{ item: N }`                                   |
+| [Variants](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/dynamic_dictionaries/variants.md)       | `variant: "name"` _or_ `variant: { … }` | `{ variant: "name" }` _or_ `{ variant: { … } }` |
 
-All three compose with the locale argument and support selective / lazy loading via `importMode`.
+Both compose with the locale argument and support selective / lazy loading via `importMode`.
 
 ## When to use which
 
 - **Collections** — ordered list of items managed in separate files (FAQ entries, blog posts, products).
-- **Variants** — named content alternatives for A/B tests, seasonal banners, or feature flags.
-- **Dynamic records** — content fetched at runtime by an opaque ID (CMS records, user-specific copy).
+- **Variants** — named or structured content alternatives:
+  - a **string** variant for A/B tests, seasonal banners, or feature flags;
+  - an **object** variant for CMS records, user-specific copy, or any content addressed by a set of fields (the former "dynamic records").
+
+> Earlier versions exposed a separate `meta` field for record-keyed content. It has been merged into `variant`: pass an **object** to `variant` instead of using `meta`.
 
 ## Selector disambiguation
 
-When multiple selectors are present on a dictionary, the resolution order is:
+A key may declare both dimensions at once (e.g. a collection whose items each have a variant). They are resolved in the order:
 
 ```
-variant → meta → item
+variant → item
 ```
+
+So `{ variant: "promo" }` on a variant × item key returns every promo item as an array, and adding `{ item: 2 }` narrows it to a single entry.