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

package/docs/id/dynamic_dictionaries/variants.md

@@ -1,13 +1,15 @@
 ---
 createdAt: 2026-06-12
-updatedAt: 2026-06-12
+updatedAt: 2026-06-26
 title: Varian
-description: Gunakan bidang metadata variant dalam file konten Intlayer untuk mendeklarasikan alternatif konten bernama (pengujian A/B, spanduk musiman, salinan berbendera fitur) – dan beralih di antaranya saat runtime tanpa perubahan kode.
+description: Gunakan field metadata variant di file konten Intlayer untuk mendeklarasikan alternatif konten bernama atau terstruktur — pengujian A/B, banner musiman, teks ber-feature flag, record CMS, konten khusus pengguna — dan beralih di antaranya saat runtime tanpa perubahan kode.
 keywords:
   - Varian
   - Pengujian A/B
-  - Bendera Fitur
+  - Feature Flag
   - Konten Dinamis
+  - Record Dinamis
+  - CMS
   - Intlayer
   - Internasionalisasi
 slugs:
@@ -17,17 +19,27 @@ slugs:
 history:
   - version: 9.0.0
     date: 2026-06-12
-    changes: "Rilis fitur varian kamus"
+    changes: "Rilis fitur varian"
+  - version: 9.1.0
+    date: 2026-06-26
+    changes: "`variant` kini menerima string atau objek — `meta` / record dinamis sebelumnya dideklarasikan sebagai varian objek"
 author: aymericzip
 ---
 
 # Varian
 
-Sebuah **varian** (variant) adalah sekumpulan file konten yang memiliki kunci kamus (`key`) yang sama tetapi masing-masing membawa nama `variant` yang berbeda. Intlayer menyajikan file yang sesuai berdasarkan selektor yang diteruskan ke `useIntlayer`.
+Sebuah **varian** adalah sekumpulan file konten yang berbagi `key` kamus yang sama tetapi masing-masing membawa nilai `variant` yang berbeda. Intlayer menyajikan file yang sesuai berdasarkan selektor yang diberikan ke `useIntlayer`.
 
-## Mendeklarasikan varian
+Nilai `variant` dapat berupa **dua bentuk**:
 
-Setiap file mewakili satu alternatif bernama. Mengabaikan `variant` (atau menyetelnya ke `"default"`) menandainya sebagai fallback default.
+- **String** — satu alternatif bernama (pengujian A/B, banner musiman, feature flag).
+- **Objek** — diskriminator terstruktur yang dialamatkan oleh sekumpulan field (record CMS, konten khusus pengguna, konten apa pun yang dikunci oleh ID buram). Seluruh objek adalah identitasnya: selektor harus memberikan objek yang **sama** untuk menyelesaikan entri.
+
+> Bentuk objek menggantikan field `meta` sebelumnya. Di mana pun Anda dulu menulis `meta: { id, … }`, tulis `variant: { id, … }`, dan pilih dengan `{ variant: { id, … } }`.
+
+## Varian bernama (string)
+
+Setiap file mewakili satu alternatif bernama. Menghilangkan `variant` (atau mengaturnya ke `"default"`) menandainya sebagai 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;
 ```
 
-## Mengonsumsi varian
+### Mengonsumsi varian bernama
 
-### Varian default
+#### Varian default
 
 <Tabs group="framework">
   <Tab label="React" value="react">
@@ -209,7 +221,7 @@ export default dictionary;
   </Tab>
 </Tabs>
 
-### Varian bernama
+#### Varian bernama
 
 ```tsx
 const { headline, cta } = useIntlayer("hero-banner", {
@@ -217,18 +229,264 @@ const { headline, cta } = useIntlayer("hero-banner", {
 });
 ```
 
-### Varian bernama dengan lokalitas eksplisit
+#### Varian bernama dengan locale eksplisit
 
 ```tsx
 const content = useIntlayer("hero-banner", {
   variant: "black_friday",
-  locale: "id",
+  locale: "fr",
 });
 ```
 
+## Varian objek (terstruktur)
+
+Varian objek mengalamatkan konten dengan sekumpulan pasangan key-value sewenang-wenang yang dideklarasikan di field `variant` — memungkinkan pemodelan record CMS, konten khusus pengguna, atau konten apa pun yang kuncinya berupa ID buram. **Seluruh objek** adalah identitasnya: selektor harus memberikan objek yang sama agar entri diselesaikan.
+
+```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;
+```
+
+### Mengonsumsi varian objek
+
+Berikan objek yang cocok ke `variant`. Setiap field yang dideklarasikan pada kamus harus disediakan dan sama; jika tidak, hasilnya `null`. Urutan field tidak penting.
+
+<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>
+
+#### Dengan locale eksplisit
+
+```tsx
+const content = useIntlayer("product", {
+  variant: { id: "prod_abc", userId: "user_123" },
+  locale: "fr",
+});
+```
+
+#### Field hilang — tidak cocok
+
+```ts
+// Mengembalikan null: `userId` hilang, sehingga objek tidak cocok dengan varian yang dideklarasikan
+const content = useIntlayer("product", { variant: { id: "prod_abc" } });
+```
+
+## Mode pemuatan
+
+Varian objek sering dimuat secara malas. Atur `importMode` pada kamus untuk mengendalikannya:
+
+```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;
+```
+
+Lihat [optimasi bundle](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/bundle_optimization.md) untuk detail tentang mode `static`, `dynamic`, dan `fetch`.
+
 ## Kasus penggunaan umum
 
-- Pengujian salinan A/B yang didorong oleh kunci eksperimen
-- Spanduk musiman atau promosi
-- Pesan yang menggunakan bendera fitur (feature flags)
-- Kampanye pemasaran khusus wilayah
+- Pengujian A/B teks yang digerakkan oleh kunci eksperimen
+- Banner musiman atau promosi
+- Pesan ber-feature flag
+- Kampanye pemasaran spesifik locale
+- Teks pemasaran per-produk yang dikelola di CMS
+- Konten khusus pengguna atau akun
+- Konten apa pun yang dikunci oleh ID buram saat runtime

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

@@ -108,7 +108,6 @@ const config: IntlayerConfig = {
      * Will load, and write the output and translations back to the JSON files in the locales directory
      */
     syncJSON({
-      format: "i18next",
       source: ({ key, locale }) => `./locales/${locale}/${key}.json`,
       priority: 0,
       format: "i18next",

package/docs/id/releases/v9.md

@@ -1,15 +1,14 @@
 ---
 createdAt: 2026-06-14
-updatedAt: 2026-06-25
+updatedAt: 2026-06-26
 title: Intlayer v9 Baru - Apa yang baru?
-description: Temukan apa yang baru di Intlayer v9. Memperkenalkan paket kompatibilitas drop-in untuk pustaka i18n populer dan dukungan untuk Collections, Variants, dan Dynamic Records.
+description: Temukan apa yang baru di Intlayer v9. Memperkenalkan paket kompatibilitas drop-in untuk pustaka i18n populer dan dukungan untuk Collections dan Variants.
 keywords:
   - Intlayer
   - Kompatibilitas
   - Migrasi
   - Collections
   - Variants
-  - Dynamic Records
   - i18next
   - next-intl
   - vue-i18n
@@ -22,7 +21,7 @@ author: aymericzip
 
 # Intlayer v9 Baru - Apa yang baru?
 
-Selamat datang di Intlayer v9! Rilis besar ini menandai tonggak sejarah besar dalam menyederhanakan jalur migrasi ke Intlayer dengan **Compat Adapter Packages** untuk pustaka i18n utama (`react-i18next`, `next-intl`, `vue-i18n`, dll.) dan menambahkan dukungan untuk struktur konten yang kaya: **Collections**, **Variants**, dan **Dynamic Records**.
+Selamat datang di Intlayer v9! Rilis besar ini menandai tonggak sejarah besar dalam menyederhanakan jalur migrasi ke Intlayer dengan **Compat Adapter Packages** untuk pustaka i18n utama (`react-i18next`, `next-intl`, `vue-i18n`, dll.) dan menambahkan dukungan untuk struktur konten yang kaya: **Collections** dan **Variants**.
 
 ## Daftar Isi
 
@@ -41,8 +40,10 @@ Dengan mengganti impor, Anda mendapatkan semua manfaat Intlayer (termasuk type s
 - `@intlayer/i18next`
 - `@intlayer/react-i18next`
 - `@intlayer/next-intl`
+- `@intlayer/react-intl`
 - `@intlayer/next-i18next`
 - `@intlayer/vue-i18n`
+- `@intlayer/lingui`
 
 Sebagai contoh, cukup ubah:
 
@@ -100,7 +101,7 @@ Semua compat adapter sekarang merutekan resolusi terjemahan melalui satu parser
 
 ---
 
-## Spesifikasi Fitur: Collections, Variants & Dynamic Records
+## Spesifikasi Fitur: Collections & Variants
 
 Intlayer v9 berkembang melampaui objek key-value statis, memungkinkan dictionary untuk mendeklarasikan struktur tata letak dinamis yang sepenuhnya bertipe (fully typed) dari ujung ke ujung (end-to-end).
 
@@ -144,6 +145,8 @@ const faq = useIntlayer("faq", { item: 1 }); // -> { question: string, answer: s
 
 Sajikan pengujian A/B (A/B tests), header musiman, feature flags, atau landing page kustom:
 
+#### Varian string (misal, pengujian A/B)
+
 ```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
-
-Definisikan dictionary yang entrinya dimuat secara dinamis pada saat runtime melalui ID kueri:
+#### Varian objek (misal, 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**: Diaktifkan secara otomatis ketika `compiler.enabled` diatur dan jalur `compiler.output` dikonfigurasi. Anda tidak lagi perlu mendaftarkan `intlayerCompiler()` secara terpisah.
+- **Compiler**: Diaktifkan secara otomatis ketika `compiler.enabled` diatur ke `true` dan jalur `compiler.output` dikonfigurasi. Anda tidak lagi perlu mendaftarkan `intlayerCompiler()` secara terpisah.
 - **Proxy**: Diaktifkan secara otomatis berdasarkan opsi `routing.enableProxy` yang baru (`true` secara default). Ini menghubungkan middleware deteksi locale / redirect / rewrite dalam pengembangan, preview, dan SSR produksi. Anda tidak lagi perlu mendaftarkan `intlayerProxy()` secara terpisah.
 
 ### Opsi `routing.enableProxy`
@@ -252,6 +253,27 @@ Plugin standalone `intlayerCompiler()` dan `intlayerProxy()` tetap diekspor untu
 
 ---
 
+## Compiler dinonaktifkan secara default
+
+Mulai dari Intlayer v9, **compiler dinonaktifkan secara default** (`compiler.enabled` sekarang default-nya `false`). Untuk mengaktifkan ekstraksi file `.content.ts` Anda pada saat build, atur `compiler.enabled: true` di konfigurasi Anda:
+
+```ts fileName="intlayer.config.ts"
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  compiler: {
+    enabled: true, // Default: false — diperlukan untuk mengaktifkan compiler sejak v9
+    output: ({ fileName }) => `./${fileName}.content.ts`,
+  },
+};
+
+export default config;
+```
+
+Ketika compiler dinonaktifkan, Intlayer melewati langkah ekstraksi saat build dan mengandalkan dictionary yang sudah Anda deklarasikan. Aktifkan hanya ketika Anda ingin plugin bundler (`@intlayer/swc`, `@intlayer/babel`, atau plugin Vite `intlayer()`) mengekstrak konten secara otomatis.
+
+---
+
 ## React Native: impor paket tunggal
 
 Dalam aplikasi React Native atau Expo, Anda tidak perlu lagi beralih antara `react-intlayer` dan `react-native-intlayer`. Paket `react-native-intlayer` sekarang **mengekspor ulang seluruh API `react-intlayer`** (hooks, utilitas, dan subjalur `/format`, `/html`, dan `/markdown`), dan `IntlayerProvider`-nya secara otomatis menerapkan polyfill React Native.
@@ -278,13 +300,14 @@ npm install intlayer react-native-intlayer
 
 Jika Anda memperbarui dari v8, perhatikan bahwa v9 tidak menyertakan breaking changes (perubahan yang merusak). Namun berikut adalah perubahan utamanya:
 
+- **Compiler dinonaktifkan secara default**: `compiler.enabled` sekarang default-nya `false`. Jika Anda mengandalkan ekstraksi file `.content.ts` saat build, atur `compiler.enabled: true` di `intlayer.config.ts` Anda.
 - **Locales & Dialects**: Jika menggunakan dependensi i18n eksternal, tambahkan plugin compat adapter masing-masing dalam konfigurasi atau pengaturan bundler Anda untuk menulis ulang impor secara otomatis.
-- **Custom Selectors**: Saat memanggil `useIntlayer`, parameter kedua sekarang dicadangkan untuk objek opsi yang berisi `{ locale, item, variant, id }`. Jika sebelumnya Anda meneruskan string locale secara langsung, Anda masih dapat melakukannya, tetapi menggunakan objek opsi sangat direkomendasikan untuk pemilihan tingkat lanjut.
+- **Custom Selectors**: Saat memanggil `useIntlayer`, parameter kedua sekarang dicadangkan untuk objek opsi yang berisi `{ locale, item, variant }`. Jika sebelumnya Anda meneruskan string locale secara langsung, Anda masih dapat melakukannya, tetapi menggunakan objek opsi sangat direkomendasikan untuk pemilihan tingkat lanjut.
 
 ---
 
 ## Tautan berguna
 
 - [Panduan Compat Adapter Packages](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/compat/index.md)
-- [Dynamic Dictionaries - Collections, Variants & Dynamic Records](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/dynamic_dictionaries/index.md)
+- [Dynamic Dictionaries - Collections & Variants](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/dynamic_dictionaries/index.md)
 - [Referensi Konfigurasi](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/configuration.md)

package/docs/it/dynamic_dictionaries/index.md

@@ -1,13 +1,12 @@
 ---
 createdAt: 2026-06-12
-updatedAt: 2026-06-12
-title: Dizionari Dinamici
-description: Panoramica delle tre funzionalità di dizionario dinamico di Intlayer — collezioni, varianti e record dinamici — per la creazione di contenuti i18n flessibili e guidati dal runtime.
+updatedAt: 2026-06-26
+title: Dizionari dinamici
+description: Panoramica delle funzionalità dei dizionari dinamici di Intlayer — collezioni e varianti — per creare contenuti i18n flessibili e guidati a runtime.
 keywords:
-  - Dizionari Dinamici
+  - Dizionari dinamici
   - Collezioni
   - Varianti
-  - Record Dinamici
   - Intlayer
   - Internazionalizzazione
 slugs:
@@ -18,31 +17,38 @@ history:
   - version: 9.0.0
     date: 2026-06-12
     changes: "Rilascio della funzionalità dei dizionari dinamici"
+  - version: 9.1.0
+    date: 2026-06-26
+    changes: "Unione dei record dinamici nelle varianti — `variant` ora accetta una stringa o un oggetto"
 author: aymericzip
 ---
 
-# Dizionari Dinamici
+# Dizionari dinamici
 
-Intlayer supporta tre meccanismi per esprimere contenuti che vanno oltre un singolo dizionario statico per chiave. Ognuno viene dichiarato tramite un **campo di metadati di livello superiore** nel file di contenuto; non è necessaria alcuna funzione wrapper.
+Intlayer supporta due meccanismi per esprimere contenuti che vanno oltre un singolo dizionario statico per chiave. Ciascuno è dichiarato tramite un **campo di metadati di primo livello** nel file di contenuto; non è necessaria alcuna funzione wrapper.
 
-| Funzionalità                                                                                                             | Campo metadati    | Selettore in `useIntlayer` |
-| ------------------------------------------------------------------------------------------------------------------------ | ----------------- | -------------------------- |
-| [Collezioni](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dynamic_dictionaries/collections.md)          | `item: N`         | `{ item: N }`              |
-| [Varianti](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dynamic_dictionaries/variants.md)               | `variant: "name"` | `{ variant: "name" }`      |
-| [Record Dinamici](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dynamic_dictionaries/dynamic_content.md) | `meta: { id, … }` | `{ id, … }`                |
+| Funzionalità                                                                                                    | Campo di metadati                      | Selettore in `useIntlayer`                     |
+| --------------------------------------------------------------------------------------------------------------- | -------------------------------------- | ---------------------------------------------- |
+| [Collezioni](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dynamic_dictionaries/collections.md) | `item: N`                              | `{ item: N }`                                  |
+| [Varianti](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dynamic_dictionaries/variants.md)      | `variant: "name"` _o_ `variant: { … }` | `{ variant: "name" }` _o_ `{ variant: { … } }` |
 
-Tutti e tre si compongono con l'argomento della locale e supportano il caricamento selettivo o lazy tramite `importMode`.
+Entrambi si combinano con l'argomento locale e supportano il caricamento selettivo / differito tramite `importMode`.
 
-## Quando usare quale
+## Quando usare cosa
 
-- **Collezioni** — elenco ordinato di elementi gestiti in file separati (domande frequenti, post di blog, prodotti).
-- **Variantes** — alternative di contenuto denominate per test A/B, banner stagionali o feature flag.
-- **Record dinamici** — contenuto recuperato a runtime tramite un ID opaco (record del CMS, testi specifici dell'utente).
+- **Collezioni** — elenco ordinato di elementi gestiti in file separati (voci di FAQ, articoli di blog, prodotti).
+- **Varianti** — alternative di contenuto con nome o strutturate:
+  - una variante **stringa** per test A/B, banner stagionali o feature flag;
+  - una variante **oggetto** per record di CMS, contenuti specifici per utente o qualsiasi contenuto indirizzato da un insieme di campi (i precedenti «record dinamici»).
 
-## Risoluzione dei conflitti del selettore
+> Le versioni precedenti esponevano un campo `meta` separato per i contenuti indicizzati per record. È stato unito in `variant`: passa un **oggetto** a `variant` invece di usare `meta`.
 
-Quando sono presenti più selettori in un dizionario, l'ordine di risoluzione è:
+## Disambiguazione del selettore
+
+Una chiave può dichiarare entrambe le dimensioni contemporaneamente (ad es. una collezione i cui elementi hanno ciascuno una variante). Vengono risolte nell'ordine:
 
 ```
-variant → meta → item
+variant → item
 ```
+
+Quindi `{ variant: "promo" }` su una chiave variante × item restituisce tutti gli elementi promo come array, e aggiungere `{ item: 2 }` lo restringe a una singola voce.