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

package/docs/pt/dynamic_dictionaries/variants.md

@@ -1,13 +1,15 @@
 ---
 createdAt: 2026-06-12
-updatedAt: 2026-06-12
+updatedAt: 2026-06-26
 title: Variantes
-description: Use o campo de metadados variant nos arquivos de conteúdo do Intlayer para declarar alternativas de conteúdo nomeadas (testes A/B, banners sazonais, textos baseados em sinalizadores de recursos) e alternar entre elas em tempo de execução sem alterações de código.
+description: Use o campo de metadados variant nos arquivos de conteúdo do Intlayer para declarar alternativas de conteúdo nomeadas ou estruturadas — testes A/B, banners sazonais, texto com feature flag, registros de CMS, conteúdo específico do usuário — e alternar entre elas em tempo de execução sem mudanças de código.
 keywords:
   - Variantes
   - Testes A/B
-  - Sinalizadores de Recursos
-  - Conteúdo Dinâmico
+  - Feature Flags
+  - Conteúdo dinâmico
+  - Registros dinâmicos
+  - CMS
   - Intlayer
   - Internacionalização
 slugs:
@@ -17,17 +19,27 @@ slugs:
 history:
   - version: 9.0.0
     date: 2026-06-12
-    changes: "Lançamento do recurso de variantes de dicionários"
+    changes: "Lançamento do recurso de variantes"
+  - version: 9.1.0
+    date: 2026-06-26
+    changes: "`variant` agora aceita uma string ou um objeto — os antigos `meta` / registros dinâmicos são declarados como variantes de objeto"
 author: aymericzip
 ---
 
 # Variantes
 
-Uma **variante** (Variant) é um conjunto de arquivos de conteúdo que compartilham a mesma chave de dicionário (`key`), mas cada um carrega um nome de variante (`variant`) diferente. O Intlayer serve o arquivo apropriado com base no seletor passado para `useIntlayer`.
+Uma **variante** é um conjunto de arquivos de conteúdo que compartilham a mesma chave de dicionário (`key`), mas cada um carrega um valor `variant` diferente. O Intlayer serve o arquivo apropriado com base no seletor passado para `useIntlayer`.
 
-## Declarando variantes
+O valor de `variant` pode assumir **duas formas**:
 
-Cada arquivo representa uma alternativa nomeada. Omitir `variant` (ou defini-lo como `"default"`) o marca como a variante padrão (fallback).
+- **Uma string** — uma única alternativa nomeada (testes A/B, banners sazonais, feature flags).
+- **Um objeto** — um discriminador estruturado endereçado por um conjunto de campos (registros de CMS, conteúdo específico do usuário, qualquer conteúdo cuja chave é um ID opaco). O objeto inteiro é a identidade: o seletor deve fornecer um objeto **igual** para resolver a entrada.
+
+> A forma de objeto substitui o antigo campo `meta`. Onde você antes escrevia `meta: { id, … }`, escreva `variant: { id, … }` e selecione-a com `{ variant: { id, … } }`.
+
+## Variantes nomeadas (string)
+
+Cada arquivo representa uma alternativa nomeada. Omitir `variant` (ou defini-lo como `"default"`) o marca como fallback.
 
 ```ts fileName="hero-banner.content.ts" contentDeclarationFormat={["typescript", "esm", "commonjs"]}
 import { t, type Dictionary } from "intlayer";
@@ -58,16 +70,16 @@ const dictionary = {
       en: "50 % off — today only",
       fr: "−50 % — aujourd'hui seulement",
     }),
-    cta: t({ en: "Shop now", fr: "Acheter agora" }),
+    cta: t({ en: "Shop now", fr: "Acheter maintenant" }),
   },
 } satisfies Dictionary;
 
 export default dictionary;
 ```
 
-## Consumindo variantes
+### Consumir variantes nomeadas
 
-### Variante padrão
+#### Variante padrão
 
 <Tabs group="framework">
   <Tab label="React" value="react">
@@ -209,7 +221,7 @@ export default dictionary;
   </Tab>
 </Tabs>
 
-### Variante nomeada
+#### Variante nomeada
 
 ```tsx
 const { headline, cta } = useIntlayer("hero-banner", {
@@ -217,18 +229,264 @@ const { headline, cta } = useIntlayer("hero-banner", {
 });
 ```
 
-### Variante nomeada com localidade explícita
+#### Variante nomeada com locale explícito
 
 ```tsx
 const content = useIntlayer("hero-banner", {
   variant: "black_friday",
-  locale: "pt",
+  locale: "fr",
 });
 ```
 
+## Variantes de objeto (estruturadas)
+
+Uma variante de objeto endereça o conteúdo por um conjunto arbitrário de pares chave-valor declarados no campo `variant` — possibilitando modelar registros de CMS, conteúdo específico do usuário ou qualquer conteúdo cuja chave seja um ID opaco. O **objeto inteiro** é a identidade: o seletor deve fornecer um objeto igual para que a entrada seja resolvida.
+
+```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;
+```
+
+### Consumir variantes de objeto
+
+Passe o objeto correspondente para `variant`. Cada campo declarado no dicionário deve ser fornecido e igual; caso contrário, o resultado é `null`. A ordem dos campos não importa.
+
+<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>
+
+#### Com locale explícito
+
+```tsx
+const content = useIntlayer("product", {
+  variant: { id: "prod_abc", userId: "user_123" },
+  locale: "fr",
+});
+```
+
+#### Campo ausente — sem correspondência
+
+```ts
+// Retorna null: `userId` está ausente, então o objeto não corresponde à variante declarada
+const content = useIntlayer("product", { variant: { id: "prod_abc" } });
+```
+
+## Modo de carregamento
+
+As variantes de objeto costumam ser carregadas de forma preguiçosa. Defina `importMode` no dicionário para controlar isso:
+
+```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;
+```
+
+Veja [otimização do bundle](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/bundle_optimization.md) para detalhes sobre os modos `static`, `dynamic` e `fetch`.
+
 ## Casos de uso típicos
 
-- Testes A/B de textos controlados por uma chave de experimento
-- Banners promocionais ou sazonais
-- Mensagens baseadas em sinalizadores de recursos (feature flags)
-- Campanhas de marketing específicas de uma região
+- Testes A/B de texto orientados por uma chave de experimento
+- Banners sazonais ou promocionais
+- Mensagens com feature flag
+- Campanhas de marketing específicas por locale
+- Texto de marketing por produto gerenciado em um CMS
+- Conteúdo específico do usuário ou da conta
+- Qualquer conteúdo indexado por um ID opaco em tempo de execução

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

@@ -108,7 +108,6 @@ const config: IntlayerConfig = {
      * Irá carregar e escrever a saída e as traduções de volta para os arquivos JSON no diretório de localidades
      */
     syncJSON({
-      format: "i18next",
       source: ({ key, locale }) => `./locales/${locale}/${key}.json`,
       priority: 0,
       format: "i18next",

package/docs/pt/releases/v9.md

@@ -1,15 +1,14 @@
 ---
 createdAt: 2026-06-14
-updatedAt: 2026-06-25
+updatedAt: 2026-06-26
 title: Novo Intlayer v9 - O que há de novo?
-description: Descubra o que há de novo no Intlayer v9. Apresentando pacotes de compatibilidade drop-in para bibliotecas i18n populares e suporte para Collections, Variants e Dynamic Records.
+description: Descubra o que há de novo no Intlayer v9. Apresentando pacotes de compatibilidade drop-in para bibliotecas i18n populares e suporte para Collections e Variants.
 keywords:
   - Intlayer
   - Compatibility
   - Migration
   - Collections
   - Variants
-  - Dynamic Records
   - i18next
   - next-intl
   - vue-i18n
@@ -22,7 +21,7 @@ author: aymericzip
 
 # Novo Intlayer v9 - O que há de novo?
 
-Bem-vindo ao Intlayer v9! Este grande lançamento marca um marco enorme na simplificação do caminho de migração para o Intlayer com **Compat Adapter Packages** para as principais bibliotecas de i18n (`react-i18next`, `next-intl`, `vue-i18n`, etc.) e adiciona suporte para estruturas de conteúdo ricas: **Collections**, **Variants** e **Dynamic Records**.
+Bem-vindo ao Intlayer v9! Este grande lançamento marca um marco enorme na simplificação do caminho de migração para o Intlayer com **Compat Adapter Packages** para as principais bibliotecas de i18n (`react-i18next`, `next-intl`, `vue-i18n`, etc.) e adiciona suporte para estruturas de conteúdo ricas: **Collections** e **Variants**.
 
 ## Tabela de conteúdos
 
@@ -41,8 +40,10 @@ Ao substituir os imports, você obtém todos os benefícios do Intlayer (incluin
 - `@intlayer/i18next`
 - `@intlayer/react-i18next`
 - `@intlayer/next-intl`
+- `@intlayer/react-intl`
 - `@intlayer/next-i18next`
 - `@intlayer/vue-i18n`
+- `@intlayer/lingui`
 
 Por exemplo, basta alterar:
 
@@ -100,7 +101,7 @@ Todos os adaptadores de compatibilidade agora roteiam a resolução de traduçã
 
 ---
 
-## Especificação de Recursos: Collections, Variants & Dynamic Records
+## Especificação de Recursos: Collections & Variants
 
 O Intlayer v9 vai além de objetos estáticos de chave-valor, permitindo que os dicionários declarem estruturas de layout dinâmicas que são totalmente tipadas de ponta a ponta.
 
@@ -144,6 +145,8 @@ const faq = useIntlayer("faq", { item: 1 }); // -> { question: string, answer: s
 
 Entregue testes A/B, cabeçalhos sazonais, feature flags ou landing pages personalizadas:
 
+#### Variantes de string (ex. testes 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
-
-Defina dicionários cujas entradas são carregadas dinamicamente em runtime via IDs de consulta:
+#### Variantes de objeto (ex. 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({
 });
 ```
 
-- **Compilador**: Ativa automaticamente quando `compiler.enabled` é definido e um caminho `compiler.output` é configurado. Você não precisa mais registrar `intlayerCompiler()` separadamente.
+- **Compilador**: Ativa automaticamente quando `compiler.enabled` é definido como `true` e um caminho `compiler.output` é configurado. Você não precisa mais registrar `intlayerCompiler()` separadamente.
 - **Proxy**: Ativa automaticamente com base na nova opção `routing.enableProxy` (`true` por padrão). Ele conecta o middleware de detecção de localidade / redirecionamento / reescrita em desenvolvimento, visualização e SSR de produção. Você não precisa mais registrar `intlayerProxy()` separadamente.
 
 ### Opção `routing.enableProxy`
@@ -252,6 +253,27 @@ Os plugins standalone `intlayerCompiler()` e `intlayerProxy()` permanecem export
 
 ---
 
+## Compilador desativado por padrão
+
+A partir do Intlayer v9, o **compilador está desativado por padrão** (`compiler.enabled` agora tem o valor padrão `false`). Para ativar a extração dos seus arquivos `.content.ts` em tempo de build, defina `compiler.enabled: true` na sua configuração:
+
+```ts fileName="intlayer.config.ts"
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  compiler: {
+    enabled: true, // Padrão: false — necessário para ativar o compilador desde a v9
+    output: ({ fileName }) => `./${fileName}.content.ts`,
+  },
+};
+
+export default config;
+```
+
+Quando o compilador está desativado, o Intlayer pula a etapa de extração em tempo de build e depende dos dicionários que você já declarou. Ative-o apenas quando quiser que o plugin do bundler (`@intlayer/swc`, `@intlayer/babel` ou o plugin Vite `intlayer()`) extraia o conteúdo automaticamente.
+
+---
+
 ## React Native: importações de um único pacote
 
 Em um aplicativo React Native ou Expo, você não precisa mais alternar entre `react-intlayer` e `react-native-intlayer`. O pacote `react-native-intlayer` agora **reexporta toda a API do `react-intlayer`** (hooks, utilitários e os subcaminhos `/format`, `/html` e `/markdown`), e seu `IntlayerProvider` aplica automaticamente os polyfills do React Native.
@@ -278,13 +300,14 @@ npm install intlayer react-native-intlayer
 
 Se você estiver atualizando da v8, observe que a v9 não inclui breaking changes. Mas aqui estão as principais mudanças:
 
+- **Compilador desativado por padrão**: `compiler.enabled` agora tem o valor padrão `false`. Se você depende da extração dos seus arquivos `.content.ts` em tempo de build, defina `compiler.enabled: true` no seu `intlayer.config.ts`.
 - **Locales & Dialects**: Se estiver usando dependências externas de i18n, adicione seus respectivos plugins de compatibilidade na sua configuração ou setup do bundler para reescrever os imports automaticamente.
-- **Custom Selectors**: Ao chamar `useIntlayer`, o segundo parâmetro agora é reservado para um objeto de opções contendo `{ locale, item, variant, id }`. Se você passava anteriormente uma string de locale diretamente, ainda pode fazer isso, mas o uso do objeto de opções é recomendado para seleções avançadas.
+- **Custom Selectors**: Ao chamar `useIntlayer`, o segundo parâmetro agora é reservado para um objeto de opções contendo `{ locale, item, variant }`. Se você passava anteriormente uma string de locale diretamente, ainda pode fazer isso, mas o uso do objeto de opções é recomendado para seleções avançadas.
 
 ---
 
 ## Links úteis
 
 - [Guia de Compat Adapter Packages](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/compat/index.md)
-- [Dicionários Dinâmicos - Collections, Variants & Dynamic Records](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/dynamic_dictionaries/index.md)
+- [Dicionários Dinâmicos - Collections & Variants](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/dynamic_dictionaries/index.md)
 - [Referência de Configuração](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/configuration.md)

package/docs/ru/dynamic_dictionaries/index.md

@@ -1,13 +1,12 @@
 ---
 createdAt: 2026-06-12
-updatedAt: 2026-06-12
-title: Динамические Словари
-description: Обзор трех функций динамических словарей Intlayer — коллекций, вариантов и динамических записей — для создания гибкого контента i18n, управляемого во время выполнения.
+updatedAt: 2026-06-26
+title: Динамические словари
+description: Обзор возможностей динамических словарей Intlayer — коллекций и вариантов — для создания гибкого, управляемого во время выполнения i18n-контента.
 keywords:
-  - Динамические Словари
+  - Динамические словари
   - Коллекции
   - Варианты
-  - Динамические Записи
   - Intlayer
   - Интернационализация
 slugs:
@@ -18,31 +17,38 @@ history:
   - version: 9.0.0
     date: 2026-06-12
     changes: "Выпуск функции динамических словарей"
+  - version: 9.1.0
+    date: 2026-06-26
+    changes: "Динамические записи объединены с вариантами — `variant` теперь принимает строку или объект"
 author: aymericzip
 ---
 
-# Динамические Словари
+# Динамические словари
 
-Intlayer поддерживает три механизма для представления контента, выходящего за рамки одного статического словаря на ключ. Каждый из них объявляется через **поле метаданных верхнего уровня** в файле контента; функция-обертка (wrapper) не требуется.
+Intlayer поддерживает два механизма для выражения контента, выходящего за рамки единственного статического словаря на ключ. Каждый объявляется через **поле метаданных верхнего уровня** в файле контента; функция-обёртка не нужна.
 
-| Функция                                                                                                                      | Поле метаданных   | Селектор в `useIntlayer` |
-| ---------------------------------------------------------------------------------------------------------------------------- | ----------------- | ------------------------ |
-| [Коллекции](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dynamic_dictionaries/collections.md)               | `item: N`         | `{ item: N }`            |
-| [Варианты](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dynamic_dictionaries/variants.md)                   | `variant: "name"` | `{ variant: "name" }`    |
-| [Динамические Записи](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dynamic_dictionaries/dynamic_content.md) | `meta: { id, … }` | `{ id, … }`              |
+| Возможность                                                                                                    | Поле метаданных                          | Селектор в `useIntlayer`                         |
+| -------------------------------------------------------------------------------------------------------------- | ---------------------------------------- | ------------------------------------------------ |
+| [Коллекции](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dynamic_dictionaries/collections.md) | `item: N`                                | `{ item: N }`                                    |
+| [Варианты](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dynamic_dictionaries/variants.md)     | `variant: "name"` _или_ `variant: { … }` | `{ variant: "name" }` _или_ `{ variant: { … } }` |
 
-Все три механизма сочетаются с аргументом локали и поддерживают выборочную / ленивую загрузку (lazy loading) с помощью `importMode`.
+Оба сочетаются с аргументом locale и поддерживают выборочную / отложенную загрузку через `importMode`.
 
 ## Когда что использовать
 
-- **Коллекции** — упорядоченный список элементов, управляемых в отдельных файлах (элементы FAQ, сообщения в блогах, продукты).
-- **Варианты** — именованные альтернативы контента для A/B-тестов, сезонных баннеров или флагов функций (feature flags).
-- **Динамические записи** — контент, получаемый во время выполнения по непрозрачному идентификатору ID (записи CMS, контент конкретного пользователя).
+- **Коллекции** — упорядоченный список элементов, управляемых в отдельных файлах (записи FAQ, посты блога, товары).
+- **Варианты** — именованные или структурированные альтернативы контента:
+  - **строковый** вариант для A/B-тестов, сезонных баннеров или feature-флагов;
+  - **объектный** вариант для записей CMS, контента конкретного пользователя или любого контента, адресуемого набором полей (прежние «динамические записи»).
 
-## Разрешение конфликтов селекторов
+> В предыдущих версиях для контента по записям было отдельное поле `meta`. Оно объединено с `variant`: передавайте `variant` **объект** вместо использования `meta`.
 
-Когда в словаре присутствует несколько селекторов, порядок разрешения следующий:
+## Разрешение неоднозначности селектора
+
+Ключ может объявлять оба измерения одновременно (например, коллекция, у каждого элемента которой есть вариант). Они разрешаются в порядке:
 
 ```
-variant → meta → item
+variant → item
 ```
+
+Так, `{ variant: "promo" }` для ключа variant × item возвращает все promo-элементы в виде массива, а добавление `{ item: 2 }` сужает результат до одной записи.