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

package/docs/ru/dynamic_dictionaries/variants.md

@@ -1,13 +1,15 @@
 ---
 createdAt: 2026-06-12
-updatedAt: 2026-06-12
+updatedAt: 2026-06-26
 title: Варианты
-description: Используйте поле метаданных variant в файлах контента Intlayer для объявления именованных альтернатив контента (A/B-тесты, сезонные баннеры, тексты с флагами функций) и переключения между ними во время выполнения без изменения кода.
+description: Используйте поле метаданных variant в файлах контента Intlayer, чтобы объявлять именованные или структурированные альтернативы контента — A/B-тесты, сезонные баннеры, тексты под feature-флагами, записи CMS, контент конкретного пользователя — и переключаться между ними во время выполнения без изменений кода.
 keywords:
   - Варианты
-  - A/B Тестирование
-  - Флаги Функций
-  - Динамический Контент
+  - A/B-тестирование
+  - Feature-флаги
+  - Динамический контент
+  - Динамические записи
+  - CMS
   - Intlayer
   - Интернационализация
 slugs:
@@ -17,17 +19,27 @@ slugs:
 history:
   - version: 9.0.0
     date: 2026-06-12
-    changes: "Выпуск функции вариантов словарей"
+    changes: "Выпуск функции вариантов"
+  - version: 9.1.0
+    date: 2026-06-26
+    changes: "`variant` теперь принимает строку или объект — прежние `meta` / динамические записи объявляются как объектные варианты"
 author: aymericzip
 ---
 
 # Варианты
 
-**Вариант** (Variant) — это набор файлов контента, которые используют один и тот же ключ словаря (`key`), но каждый имеет свое название варианта (`variant`). Intlayer предоставляет соответствующий файл на основе селектора, переданного в `useIntlayer`.
+**Вариант** — это набор файлов контента, которые имеют общий ключ словаря (`key`), но каждый несёт своё значение `variant`. Intlayer отдаёт нужный файл на основе селектора, переданного в `useIntlayer`.
 
-## Объявление вариантов
+Значение `variant` может принимать **две формы**:
 
-Каждый файл представляет собой одну именованную альтернативу. Опущение `variant` (или установка значения `"default"`) помечает его как вариант по умолчанию (fallback).
+- **Строка** — одна именованная альтернатива (A/B-тесты, сезонные баннеры, feature-флаги).
+- **Объект** — структурированный дискриминатор, адресуемый набором полей (записи CMS, контент конкретного пользователя, любой контент с непрозрачным ID в качестве ключа). Идентичностью является весь объект: селектор должен предоставить **равный** объект, чтобы разрешить запись.
+
+> Объектная форма заменяет прежнее поле `meta`. Везде, где раньше вы писали `meta: { id, … }`, пишите `variant: { id, … }` и выбирайте её через `{ variant: { id, … } }`.
+
+## Именованные (строковые) варианты
+
+Каждый файл представляет одну именованную альтернативу. Пропуск `variant` (или значение `"default"`) помечает его как запасной вариант.
 
 ```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;
 ```
 
-## Использование вариантов
+### Использование именованных вариантов
 
-### Вариант по умолчанию
+#### Вариант по умолчанию
 
 <Tabs group="framework">
   <Tab label="React" value="react">
@@ -209,7 +221,7 @@ export default dictionary;
   </Tab>
 </Tabs>
 
-### Именованный вариант
+#### Именованный вариант
 
 ```tsx
 const { headline, cta } = useIntlayer("hero-banner", {
@@ -217,18 +229,264 @@ const { headline, cta } = useIntlayer("hero-banner", {
 });
 ```
 
-### Именованный вариант с явным указанием локали
+#### Именованный вариант с явной локалью
 
 ```tsx
 const content = useIntlayer("hero-banner", {
   variant: "black_friday",
-  locale: "ru",
+  locale: "fr",
 });
 ```
 
-## Типичные варианты использования
+## Объектные (структурированные) варианты
+
+Объектный вариант адресует контент произвольным набором пар ключ-значение, объявленных в поле `variant`, — что позволяет моделировать записи CMS, контент конкретного пользователя или любой контент с непрозрачным ID в качестве ключа. Идентичностью является **весь объект**: селектор должен предоставить равный объект, чтобы запись была разрешена.
+
+```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;
+```
+
+### Использование объектных вариантов
+
+Передайте соответствующий объект в `variant`. Каждое поле, объявленное в словаре, должно быть предоставлено и равно; иначе результат — `null`. Порядок полей не имеет значения.
+
+<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>
+
+#### С явной локалью
+
+```tsx
+const content = useIntlayer("product", {
+  variant: { id: "prod_abc", userId: "user_123" },
+  locale: "fr",
+});
+```
+
+#### Отсутствует поле — нет совпадения
+
+```ts
+// Возвращает null: отсутствует `userId`, поэтому объект не совпадает с объявленным вариантом
+const content = useIntlayer("product", { variant: { id: "prod_abc" } });
+```
+
+## Режим загрузки
+
+Объектные варианты часто загружаются лениво. Задайте `importMode` в словаре, чтобы управлять этим:
+
+```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;
+```
+
+См. [оптимизацию бандла](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/bundle_optimization.md) для подробностей о режимах `static`, `dynamic` и `fetch`.
+
+## Типичные сценарии использования
 
-- A/B-тестирование текстов, управляемое ключом эксперимента
-- Сезонные или промо-баннеры
-- Сообщения, управляемые флагами функций (feature flags)
-- Маркетинговые кампании для конкретных регионов
+- A/B-тесты текста, управляемые ключом эксперимента
+- Сезонные или рекламные баннеры
+- Сообщения под feature-флагами
+- Маркетинговые кампании для конкретной локали
+- Маркетинговый текст по товарам, управляемый в CMS
+- Контент конкретного пользователя или аккаунта
+- Любой контент, адресуемый непрозрачным ID во время выполнения

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

@@ -109,7 +109,6 @@ const config: IntlayerConfig = {
      * Загрузит, а также запишет результат и переводы обратно в JSON-файлы в директории locales
      */
     syncJSON({
-      format: "i18next",
       source: ({ key, locale }) => `./locales/${locale}/${key}.json`,
       priority: 0,
       format: "i18next",

package/docs/ru/releases/v9.md

@@ -1,15 +1,14 @@
 ---
 createdAt: 2026-06-14
-updatedAt: 2026-06-25
+updatedAt: 2026-06-26
 title: Новый Intlayer v9 — Что нового?
-description: Узнайте, что нового в Intlayer v9. Представляем пакеты совместимости drop-in для популярных библиотек i18n, а также поддержку Collections, Variants и Dynamic Records.
+description: Узнайте, что нового в Intlayer v9. Представляем пакеты совместимости drop-in для популярных библиотек i18n, а также поддержку Collections и Variants.
 keywords:
   - Intlayer
   - Совместимость
   - Миграция
   - Collections
   - Variants
-  - Dynamic Records
   - i18next
   - next-intl
   - vue-i18n
@@ -22,7 +21,7 @@ author: aymericzip
 
 # Новый Intlayer v9 — Что нового?
 
-Добро пожаловать в Intlayer v9! Этот мажорный релиз знаменует собой важную веху в упрощении миграции на Intlayer благодаря **пакетам адаптеров совместимости (Compat Adapter Packages)** для популярных библиотек i18n (`react-i18next`, `next-intl`, `vue-i18n` и др.), а также добавляет поддержку сложных структур контента: **Collections** (Коллекции), **Variants** (Варианты) и **Dynamic Records** (Динамические записи).
+Добро пожаловать в Intlayer v9! Этот мажорный релиз знаменует собой важную веху в упрощении миграции на Intlayer благодаря **пакетам адаптеров совместимости (Compat Adapter Packages)** для популярных библиотек i18n (`react-i18next`, `next-intl`, `vue-i18n` и др.), а также добавляет поддержку сложных структур контента: **Collections** (Коллекции) и **Variants** (Варианты).
 
 ## Содержание
 
@@ -41,8 +40,10 @@ author: aymericzip
 - `@intlayer/i18next`
 - `@intlayer/react-i18next`
 - `@intlayer/next-intl`
+- `@intlayer/react-intl`
 - `@intlayer/next-i18next`
 - `@intlayer/vue-i18n`
+- `@intlayer/lingui`
 
 Например, просто замените:
 
@@ -100,7 +101,7 @@ export default defineConfig({
 
 ---
 
-## Спецификация функций: Collections, Variants и Dynamic Records
+## Спецификация функций: Collections и Variants
 
 Intlayer v9 выходит за рамки статических объектов типа ключ-значение, позволяя словарям объявлять динамические структуры макетов со сквозной типизацией.
 
@@ -144,6 +145,8 @@ const faq = useIntlayer("faq", { item: 1 }); // -> { question: string, answer: s
 
 Используйте для A/B-тестирования, сезонных заголовков, фича-флагов или кастомных целевых страниц:
 
+#### Строковые варианты (например, 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)
-
-Определяйте словари, записи которых загружаются динамически во время выполнения по идентификаторам запросов:
+#### Объектные варианты (например, динамические записи)
 
 ```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**: Активируется автоматически, когда задан параметр `compiler.enabled` и настроена путь `compiler.output`. Вам больше не нужно регистрировать `intlayerCompiler()` отдельно.
+- **Compiler**: Активируется автоматически, когда параметр `compiler.enabled` установлен в `true` и настроен путь `compiler.output`. Вам больше не нужно регистрировать `intlayerCompiler()` отдельно.
 - **Proxy**: Активируется автоматически на основе нового параметра `routing.enableProxy` (`true` по умолчанию). Он подключает middleware обнаружения локалей / перенаправления / переписи в разработке, preview и production SSR. Вам больше не нужно регистрировать `intlayerProxy()` отдельно.
 
 ### Опция `routing.enableProxy`
@@ -252,6 +253,27 @@ export default config;
 
 ---
 
+## Компилятор отключён по умолчанию
+
+Начиная с Intlayer v9, **компилятор отключён по умолчанию** (значение `compiler.enabled` теперь по умолчанию равно `false`). Чтобы включить извлечение ваших файлов `.content.ts` во время сборки, установите `compiler.enabled: true` в своей конфигурации:
+
+```ts fileName="intlayer.config.ts"
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  compiler: {
+    enabled: true, // По умолчанию: false — требуется для включения компилятора начиная с v9
+    output: ({ fileName }) => `./${fileName}.content.ts`,
+  },
+};
+
+export default config;
+```
+
+Когда компилятор отключён, Intlayer пропускает этап извлечения во время сборки и полагается на уже объявленные вами словари. Включайте его только тогда, когда хотите, чтобы плагин сборщика (`@intlayer/swc`, `@intlayer/babel` или Vite-плагин `intlayer()`) извлекал содержимое автоматически.
+
+---
+
 ## React Native: импорт из одного пакета
 
 В приложении React Native или Expo вам больше не нужно жонглировать `react-intlayer` и `react-native-intlayer`. Пакет `react-native-intlayer` теперь **реэкспортирует весь API `react-intlayer`** (хуки, утилиты и подпути `/format`, `/html` и `/markdown`), а его `IntlayerProvider` автоматически применяет полифиллы React Native.
@@ -278,13 +300,14 @@ npm install intlayer react-native-intlayer
 
 Если вы обновляетесь с v8, обратите внимание, что v9 не содержит ломающих изменений (breaking changes). Однако вот ключевые изменения:
 
+- **Компилятор отключён по умолчанию**: значение `compiler.enabled` теперь по умолчанию равно `false`. Если вы полагаетесь на извлечение ваших файлов `.content.ts` во время сборки, установите `compiler.enabled: true` в своём `intlayer.config.ts`.
 - **Локали и диалекты (Locales & Dialects)**: Если вы используете внешние зависимости i18n, добавьте соответствующие плагины адаптеров совместимости в вашу конфигурацию или настройки сборщика для автоматической перезаписи импортов.
-- **Кастомные селекторы (Custom Selectors)**: При вызове `useIntlayer` второй параметр теперь зарезервирован для объекта опций, содержащего `{ locale, item, variant, id }`. Если ранее вы передавали строку локали напрямую, вы все еще можете это делать, но для расширенного выбора рекомендуется использовать объект опций.
+- **Кастомные селекторы (Custom Selectors)**: При вызове `useIntlayer` второй параметр теперь зарезервирован для объекта опций, содержащего `{ locale, item, variant }`. Если ранее вы передавали строку локали напрямую, вы все еще можете это делать, но для расширенного выбора рекомендуется использовать объект опций.
 
 ---
 
 ## Полезные ссылки
 
 - [Руководство по пакетам адаптеров совместимости](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/compat/index.md)
-- [Динамические словари — Collections, Variants и Dynamic Records](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dynamic_dictionaries/index.md)
+- [Динамические словари — Collections и Variants](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dynamic_dictionaries/index.md)
 - [Справочник по конфигурации](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/configuration.md)

package/docs/tr/dynamic_dictionaries/index.md

@@ -1,13 +1,12 @@
 ---
 createdAt: 2026-06-12
-updatedAt: 2026-06-12
-title: Dinamik Sözlükler
-description: Esnek, çalışma zamanı odaklı i18n içeriği oluşturmak için Intlayer'ın üç dinamik sözlük özelliğine — koleksiyonlar, varyantlar ve dinamik kayıtlar — genel bakış.
+updatedAt: 2026-06-26
+title: Dinamik sözlükler
+description: Intlayer'in dinamik sözlük özelliklerine — koleksiyonlar ve varyantlar — genel bakış; esnek, çalışma zamanında yönlendirilen i18n içeriği oluşturmak için.
 keywords:
-  - Dinamik Sözlükler
+  - Dinamik sözlükler
   - Koleksiyonlar
   - Varyantlar
-  - Dinamik Kayıtlar
   - Intlayer
   - Uluslararasılaştırma
 slugs:
@@ -17,32 +16,39 @@ slugs:
 history:
   - version: 9.0.0
     date: 2026-06-12
-    changes: "Dinamik sözlükler özelliğinin sürümü"
+    changes: "Dinamik sözlükler özelliğinin yayımlanması"
+  - version: 9.1.0
+    date: 2026-06-26
+    changes: "Dinamik kayıtlar varyantlara birleştirildi — `variant` artık bir dize veya nesne kabul ediyor"
 author: aymericzip
 ---
 
-# Dinamik Sözlükler
+# Dinamik sözlükler
 
-Intlayer, anahtar başına tek bir statik sözlüğün ötesine geçen içeriği ifade etmek için üç mekanizmayı destekler. Her biri içerik dosyasındaki bir **üst düzey meta veri alanı** aracılığıyla bildirilir; herhangi bir sarıcı (wrapper) fonksiyona ihtiyaç duyulmaz.
+Intlayer, anahtar başına tek bir statik sözlüğün ötesine geçen içeriği ifade etmek için iki mekanizmayı destekler. Her biri içerik dosyasında bir **üst düzey meta veri alanı** aracılığıyla bildirilir; sarmalayıcı bir fonksiyona gerek yoktur.
 
-| Özellik                                                                                                                   | Meta veri alanı   | `useIntlayer` seçici  |
-| ------------------------------------------------------------------------------------------------------------------------- | ----------------- | --------------------- |
-| [Koleksiyonlar](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/dynamic_dictionaries/collections.md)        | `item: N`         | `{ item: N }`         |
-| [Varyantlar](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/dynamic_dictionaries/variants.md)              | `variant: "name"` | `{ variant: "name" }` |
-| [Dinamik Kayıtlar](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/dynamic_dictionaries/dynamic_content.md) | `meta: { id, … }` | `{ id, … }`           |
+| Özellik                                                                                                            | Meta veri alanı                           | `useIntlayer` içindeki seçici                     |
+| ------------------------------------------------------------------------------------------------------------------ | ----------------------------------------- | ------------------------------------------------- |
+| [Koleksiyonlar](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/dynamic_dictionaries/collections.md) | `item: N`                                 | `{ item: N }`                                     |
+| [Varyantlar](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/dynamic_dictionaries/variants.md)       | `variant: "name"` _veya_ `variant: { … }` | `{ variant: "name" }` _veya_ `{ variant: { … } }` |
 
-Her üçü de dil (locale) bağımsız değişkeni ile birleşir ve `importMode` aracılığıyla seçici / tembel (lazy) yüklemeyi destekler.
+Her ikisi de locale argümanıyla birlikte çalışır ve `importMode` aracılığıyla seçici / tembel yüklemeyi destekler.
 
-## Hangisi ne zaman kullanılmalı
+## Hangisini ne zaman kullanmalı
 
-- **Koleksiyonlar** — ayrı dosyalarda yönetilen sıralı öğe listesi (SSS girişleri, blog yazıları, ürünler).
-- **Varyantlar** — A/B testleri, dönemsel afişler veya özellik bayrakları (feature flags) için adlandırılmış içerik alternatifleri.
-- **Dinamik kayıtlar** — çalışma zamanında opak bir kimlik (ID) ile getirilen içerik (CMS kayıtları, kullanıcıya özel metinler).
+- **Koleksiyonlar** — ayrı dosyalarda yönetilen sıralı öğe listesi (SSS girdileri, blog gönderileri, ürünler).
+- **Varyantlar** — adlandırılmış veya yapılandırılmış içerik alternatifleri:
+  - A/B testleri, sezonluk afişler veya özellik bayrakları için bir **dize** varyantı;
+  - CMS kayıtları, kullanıcıya özel metin veya bir alan kümesiyle adreslenen herhangi bir içerik için bir **nesne** varyantı (eski "dinamik kayıtlar").
 
-## Seçici Çözümleme Önceliği
+> Önceki sürümler kayda dayalı içerik için ayrı bir `meta` alanı sunuyordu. Bu, `variant` içine birleştirildi: `meta` kullanmak yerine `variant`'a bir **nesne** geçirin.
 
-Bir sözlükte birden fazla seçici mevcut olduğunda, çözümleme sırası şöyledir:
+## Seçici belirsizlik giderme
+
+Bir anahtar her iki boyutu da aynı anda bildirebilir (ör. her öğesinin bir varyantı olan bir koleksiyon). Bunlar şu sırayla çözümlenir:
 
 ```
-variant → meta → item
+variant → item
 ```
+
+Böylece variant × item anahtarında `{ variant: "promo" }`, tüm promo öğelerini bir dizi olarak döndürür ve `{ item: 2 }` eklemek bunu tek bir girdiye daraltır.