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

package/docs/hi/dynamic_dictionaries/variants.md

@@ -1,13 +1,15 @@
 ---
 createdAt: 2026-06-12
-updatedAt: 2026-06-12
-title: वेरिएंट
-description: कोड परिवर्तनों के बिना रनटाइम पर उनके बीच स्विच करने के लिए नामित सामग्री विकल्पों (A/B परीक्षण, मौसमी बैनर, फीचर-फ़्लैग्ड प्रतिलिपि) को घोषित करने के लिए Intlayer सामग्री फ़ाइलों में variant मेटाडेटा फ़ील्ड का उपयोग करें।
+updatedAt: 2026-06-26
+title: वैरिएंट
+description: नामित या संरचित सामग्री विकल्प — A/B परीक्षण, मौसमी बैनर, फ़ीचर-फ़्लैग टेक्स्ट, CMS रिकॉर्ड, उपयोगकर्ता-विशिष्ट सामग्री — घोषित करने और कोड बदले बिना रनटाइम पर उनके बीच स्विच करने के लिए Intlayer सामग्री फ़ाइलों में variant मेटाडेटा फ़ील्ड का उपयोग करें।
 keywords:
-  - वेरिएंट
+  - वैरिएंट
   - A/B परीक्षण
-  - फीचर फ़्लैग
+  - फ़ीचर फ़्लैग
   - डायनेमिक सामग्री
+  - डायनेमिक रिकॉर्ड
+  - 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
 ---
 
-# वेरिएंट (Variants)
+# वैरिएंट
 
-एक **वेरिएंट** (variant) सामग्री फ़ाइलों का एक सेट है जो एक ही डिक्शनरी कुंजी (`key`) साझा करते हैं लेकिन प्रत्येक में एक अलग `variant` नाम होता है। Intlayer `useIntlayer` को दिए गए चयनकर्ता के आधार पर उपयुक्त फ़ाइल प्रस्तुत करता है।
+एक **वैरिएंट** सामग्री फ़ाइलों का एक समूह है जो समान डिक्शनरी `key` साझा करती हैं लेकिन प्रत्येक का एक अलग `variant` मान होता है। Intlayer `useIntlayer` को पास किए गए सेलेक्टर के आधार पर उपयुक्त फ़ाइल परोसता है।
 
-## वेरिएंट घोषित करना
+`variant` मान **दो रूप** ले सकता है:
 
-प्रत्येक फ़ाइल एक नामित विकल्प का प्रतिनिधित्व करती है। `variant` फ़ील्ड को छोड़ने (या इसे `"default"` पर सेट करने) से यह डिफ़ॉल्ट (fallback) वेरिएंट के रूप में चिह्नित हो जाता है।
+- **एक स्ट्रिंग** — एकल नामित विकल्प (A/B परीक्षण, मौसमी बैनर, फ़ीचर फ़्लैग)।
+- **एक ऑब्जेक्ट** — फ़ील्ड के सेट द्वारा संबोधित एक संरचित विभेदक (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">
@@ -76,7 +88,7 @@ export default dictionary;
 
     export const Hero = () => {
       const { headline, cta } = useIntlayer("hero-banner");
-      // → डिफ़ॉल्ट वेरिएंट
+      // → डिफ़ॉल्ट वैरिएंट
 
       return (
         <section>
@@ -94,7 +106,7 @@ export default dictionary;
 
     export const Hero = () => {
       const { headline, cta } = useIntlayer("hero-banner");
-      // → डिफ़ॉल्ट वेरिएंट
+      // → डिफ़ॉल्ट वैरिएंट
 
       return (
         <section>
@@ -142,7 +154,7 @@ export default dictionary;
 
     export const Hero = () => {
       const { headline, cta } = useIntlayer("hero-banner");
-      // → डिफ़ॉल्ट वेरिएंट
+      // → डिफ़ॉल्ट वैरिएंट
 
       return (
         <section>
@@ -160,7 +172,7 @@ export default dictionary;
 
     export const Hero = () => {
       const content = useIntlayer("hero-banner");
-      // → डिफ़ॉल्ट वेरिएंट
+      // → डिफ़ॉल्ट वैरिएंट
 
       return (
         <section>
@@ -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", {
 });
 ```
 
-### स्पष्ट भाषा विकल्प के साथ नामित वेरिएंट
+#### स्पष्ट locale के साथ नामित वैरिएंट
 
 ```tsx
 const content = useIntlayer("hero-banner", {
   variant: "black_friday",
-  locale: "hi",
+  locale: "fr",
 });
 ```
 
-## विशिष्ट उपयोग के मामले
+## ऑब्जेक्ट (संरचित) वैरिएंट
+
+एक ऑब्जेक्ट वैरिएंट `variant` फ़ील्ड में घोषित मनमाने key-value युग्मों के सेट द्वारा सामग्री को संबोधित करता है — जिससे 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>
+
+#### स्पष्ट locale के साथ
+
+```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;
+```
+
+`static`, `dynamic` और `fetch` मोड के विवरण के लिए [बंडल ऑप्टिमाइज़ेशन](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/bundle_optimization.md) देखें।
+
+## विशिष्ट उपयोग-मामले
 
-- एक परीक्षण कुंजी द्वारा संचालित A/B प्रतिलिपि परीक्षण
-- मौसमी या प्रचार बैनर
-- फीचर-फ़्लैग्ड मैसेजिंग
-- स्थानीय बाजार के विशिष्ट अभियान
+- प्रयोग key द्वारा संचालित A/B टेक्स्ट परीक्षण
+- मौसमी या प्रचारात्मक बैनर
+- फ़ीचर-फ़्लैग संदेश
+- locale-विशिष्ट मार्केटिंग अभियान
+- CMS में प्रबंधित प्रति-उत्पाद मार्केटिंग टेक्स्ट
+- उपयोगकर्ता-विशिष्ट या खाता-विशिष्ट सामग्री
+- रनटाइम पर अपारदर्शी ID द्वारा कुंजीबद्ध कोई भी सामग्री

package/docs/hi/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/hi/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 में क्या नया है। लोकप्रिय i18n लाइब्रेरीज़ के लिए ड्रॉप-इन कम्पैटिबिलिटी पैकेजेस और Collections, Variants, और Dynamic Records के लिए सपोर्ट का परिचय।
+description: जानें कि Intlayer v9 में क्या नया है। लोकप्रिय i18n लाइब्रेरीज़ के लिए ड्रॉप-इन कम्पैटिबिलिटी पैकेजेस और Collections और Variants के लिए सपोर्ट का परिचय।
 keywords:
   - Intlayer
   - Compatibility
   - Migration
   - Collections
   - Variants
-  - Dynamic Records
   - i18next
   - next-intl
   - vue-i18n
@@ -22,7 +21,7 @@ author: aymericzip
 
 # नया Intlayer v9 - क्या नया है?
 
-Intlayer v9 में आपका स्वागत है! यह मेजर रिलीज़ प्रमुख i18n लाइब्रेरीज़ (`react-i18next`, `next-intl`, `vue-i18n`, आदि) के लिए **Compat Adapter Packages** के साथ Intlayer पर माइग्रेशन की राह को आसान बनाने में एक बड़ा मील का पत्थर है, और यह रिच कंटेंट स्ट्रक्चर्स: **Collections**, **Variants**, और **Dynamic Records** के लिए सपोर्ट जोड़ता है।
+Intlayer v9 में आपका स्वागत है! यह मेजर रिलीज़ प्रमुख i18n लाइब्रेरीज़ (`react-i18next`, `next-intl`, `vue-i18n`, आदि) के लिए **Compat Adapter Packages** के साथ Intlayer पर माइग्रेशन की राह को आसान बनाने में एक बड़ा मील का पत्थर है, और यह रिच कंटेंट स्ट्रक्चर्स: **Collections** और **Variants** के लिए सपोर्ट जोड़ता है।
 
 ## विषय-सूची
 
@@ -41,8 +40,10 @@ Intlayer v9 में आपका स्वागत है! यह मेज
 - `@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({
 
 ---
 
-## Feature Spec: Collections, Variants & Dynamic Records
+## Feature Spec: Collections & Variants
 
 Intlayer v9 स्टैटिक की-वैल्यू ऑब्जेक्ट्स से आगे बढ़कर डिक्शनरीज़ को डायनेमिक लेआउट स्ट्रक्चर्स घोषित करने की अनुमति देता है जो एंड-टू-एंड पूरी तरह से टाइप्ड (typed) होते हैं।
 
@@ -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
-
-ऐसे डिक्शनरीज़ को परिभाषित करें जिनकी एंट्रीज़ रनटाइम पर क्वेरी IDs के माध्यम से डायनेमिक रूप से लोड होती हैं:
+#### ऑब्जेक्ट वेरिएंट (उदा. डायनेमिक रिकॉर्ड्स)
 
 ```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` path कॉन्फ़िगर की जाती है तो स्वचालित रूप से सक्रिय हो जाता है। आपको अब `intlayerCompiler()` को अलग से रजिस्टर करने की आवश्यकता नहीं है।
+- **Compiler**: जब `compiler.enabled` को `true` पर सेट किया जाता है और `compiler.output` path कॉन्फ़िगर की जाती है तो स्वचालित रूप से सक्रिय हो जाता है। आपको अब `intlayerCompiler()` को अलग से रजिस्टर करने की आवश्यकता नहीं है।
 - **Proxy**: नए `routing.enableProxy` option (`true` डिफ़ॉल्ट रूप से) के आधार पर स्वचालित रूप से सक्रिय हो जाता है। यह development, preview, और production SSR में locale detection / redirect / rewrite middleware को wire करता है। आपको अब `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`, या `intlayer()` Vite प्लगइन) सामग्री को स्वचालित रूप से एक्सट्रैक्ट करे।
+
+---
+
 ## React Native: सिंगल-पैकेज इम्पोर्ट
 
 React Native या Expo ऐप में, अब आपको `react-intlayer` और `react-native-intlayer` दोनों के बीच तालमेल बिठाने की ज़रूरत नहीं है। `react-native-intlayer` पैकेज अब **पूर्ण `react-intlayer` API को फिर से निर्यात करता है** (हुक्स, यूटिलिटीज, और `/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` फ़ाइलों के बिल्ड-टाइम एक्सट्रैक्शन पर निर्भर हैं, तो अपने `intlayer.config.ts` में `compiler.enabled: true` सेट करें।
 - **Locales & Dialects**: यदि बाहरी i18n डिपेंडेंसीज़ का उपयोग कर रहे हैं, तो इंपोर्ट्स को स्वचालित रूप से रीराइट करने के लिए अपने कॉन्फ़िगरेशन या बंडलर सेटअप में उनके संबंधित compat एडाप्टर प्लगइन्स जोड़ें।
-- **Custom Selectors**: `useIntlayer` को कॉल करते समय, दूसरा पैरामीटर अब एक ऑप्शन ऑब्जेक्ट के लिए आरक्षित है जिसमें `{ locale, item, variant, id }` शामिल हैं। यदि आपने पहले सीधे लोकेल स्ट्रिंग पास की थी, तो आप अभी भी ऐसा कर सकते हैं, लेकिन उन्नत चयनों (advanced selections) के लिए ऑप्शंस ऑब्जेक्ट का उपयोग करने की अनुशंसा की जाती है।
+- **Custom Selectors**: `useIntlayer` को कॉल करते समय, दूसरा पैरामीटर अब एक ऑप्शन ऑब्जेक्ट के लिए आरक्षित है जिसमें `{ locale, item, variant }` शामिल हैं। यदि आपने पहले सीधे लोकेल स्ट्रिंग पास की थी, तो आप अभी भी ऐसा कर सकते हैं, लेकिन उन्नत चयनों (advanced selections) के लिए ऑप्शंस ऑब्जेक्ट का उपयोग करने की अनुशंसा की जाती है।
 
 ---
 
 ## उपयोगी लिंक्स
 
 - [Compat Adapter Packages Guide](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/compat/index.md)
-- [Dynamic Dictionaries - Collections, Variants & Dynamic Records](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/dynamic_dictionaries/index.md)
+- [Dynamic Dictionaries - Collections & Variants](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/dynamic_dictionaries/index.md)
 - [Configuration Reference](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/configuration.md)

package/docs/id/dynamic_dictionaries/index.md

@@ -1,13 +1,12 @@
 ---
 createdAt: 2026-06-12
-updatedAt: 2026-06-12
-title: Kamus Dinamis
-description: Gambaran umum tentang tiga fitur kamus dinamis Intlayer — koleksi, varian, dan catatan dinamis — untuk membangun konten i18n yang fleksibel dan didorong oleh runtime.
+updatedAt: 2026-06-26
+title: Kamus dinamis
+description: Ikhtisar fitur kamus dinamis Intlayer — koleksi dan varian — untuk membangun konten i18n yang fleksibel dan digerakkan saat runtime.
 keywords:
-  - Kamus Dinamis
+  - Kamus dinamis
   - Koleksi
   - Varian
-  - Catatan Dinamis
   - Intlayer
   - Internasionalisasi
 slugs:
@@ -18,31 +17,38 @@ history:
   - version: 9.0.0
     date: 2026-06-12
     changes: "Rilis fitur kamus dinamis"
+  - version: 9.1.0
+    date: 2026-06-26
+    changes: "Menggabungkan record dinamis ke dalam varian — `variant` kini menerima string atau objek"
 author: aymericzip
 ---
 
-# Kamus Dinamis
+# Kamus dinamis
 
-Intlayer mendukung tiga mekanisme untuk mengekspresikan konten yang melampaui satu kamus statis per kunci. Masing-masing dideklarasikan melalui **bidang metadata tingkat atas** dalam file konten; tidak ada fungsi pembungkus (wrapper) yang diperlukan.
+Intlayer mendukung dua mekanisme untuk mengekspresikan konten yang melampaui satu kamus statis per kunci. Masing-masing dideklarasikan melalui **field metadata tingkat atas** di file konten; tidak diperlukan fungsi pembungkus.
 
-| Fitur                                                                                                                    | Bidang metadata   | Selektor dalam `useIntlayer` |
-| ------------------------------------------------------------------------------------------------------------------------ | ----------------- | ---------------------------- |
-| [Koleksi](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/dynamic_dictionaries/collections.md)             | `item: N`         | `{ item: N }`                |
-| [Varian](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/dynamic_dictionaries/variants.md)                 | `variant: "name"` | `{ variant: "name" }`        |
-| [Catatan Dinamis](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/dynamic_dictionaries/dynamic_content.md) | `meta: { id, … }` | `{ id, … }`                  |
+| Fitur                                                                                                        | Field metadata                            | Selektor di `useIntlayer`                         |
+| ------------------------------------------------------------------------------------------------------------ | ----------------------------------------- | ------------------------------------------------- |
+| [Koleksi](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/dynamic_dictionaries/collections.md) | `item: N`                                 | `{ item: N }`                                     |
+| [Varian](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/dynamic_dictionaries/variants.md)     | `variant: "name"` _atau_ `variant: { … }` | `{ variant: "name" }` _atau_ `{ variant: { … } }` |
 
-Ketiganya disusun dengan argumen lokalitas dan mendukung pemuatan selektif / malas (lazy loading) melalui `importMode`.
+Keduanya dapat dikombinasikan dengan argumen locale dan mendukung pemuatan selektif / malas melalui `importMode`.
 
 ## Kapan menggunakan yang mana
 
-- **Koleksi** — daftar item terurut yang dikelola dalam file terpisah (entri FAQ, postingan blog, produk).
-- **Varian** — alternatif konten bernama untuk pengujian A/B, spanduk musiman, atau bendera fitur (feature flags).
-- **Catatan dinamis** — konten yang diambil saat runtime menggunakan ID buram (catatan CMS, salinan khusus pengguna).
+- **Koleksi** — daftar item terurut yang dikelola dalam file terpisah (entri FAQ, posting blog, produk).
+- **Varian** — alternatif konten bernama atau terstruktur:
+  - varian **string** untuk pengujian A/B, banner musiman, atau feature flag;
+  - varian **objek** untuk record CMS, konten khusus pengguna, atau konten apa pun yang dialamatkan oleh sekumpulan field ("record dinamis" sebelumnya).
 
-## Resolusi Konflik Selektor
+> Versi sebelumnya menyediakan field `meta` terpisah untuk konten berkunci record. Field ini telah digabungkan ke `variant`: berikan **objek** ke `variant` alih-alih menggunakan `meta`.
 
-Ketika ada beberapa selektor pada satu kamus, urutan resolusinya adalah:
+## Disambiguasi selektor
+
+Sebuah kunci dapat mendeklarasikan kedua dimensi sekaligus (mis. koleksi yang setiap itemnya memiliki varian). Keduanya diselesaikan dengan urutan:
 
 ```
-variant → meta → item
+variant → item
 ```
+
+Jadi `{ variant: "promo" }` pada kunci variant × item mengembalikan semua item promo sebagai array, dan menambahkan `{ item: 2 }` mempersempitnya menjadi satu entri.