@intlayer/docs 9.1.0 → 9.1.1

package/docs/ar/dynamic_dictionaries/variants.md

@@ -22,7 +22,10 @@ history:
     changes: "إصدار ميزة المتغيرات"
   - version: 9.1.0
     date: 2026-06-26
-    changes: "أصبح `variant` يقبل سلسلة نصية أو كائنًا — تُعلَن `meta` / السجلات الديناميكية السابقة كمتغيرات كائنية"
+    changes: "تقبل `variant` الآن سلسلة أو كائنًا — تُعلن السجلات الديناميكية أو `meta` السابقة كمتغيرات كائنات"
+  - version: 9.1.1
+    date: 2026-07-31
+    changes: "تُعرّف المتغيرة فقط المفاتيح التي تتجاوزها؛ بينما تتراجع المتغيرات غير المُعرّفة إلى الإدخال الافتراضي"
 author: aymericzip
 ---
 
@@ -37,9 +40,40 @@ author: aymericzip
 
 > يحلّ الشكل الكائني محل حقل `meta` السابق. في كل مكان كنت تكتب فيه سابقًا `meta: { id, … }`، اكتب `variant: { id, … }`، وحدّدها بـ `{ variant: { id, … } }`.
 
-## المتغيرات المُسمّاة (النصية)
+### المتغيرات الجزئية
 
-يمثّل كل ملف بديلًا مُسمّى واحدًا. حذف `variant` (أو ضبطه على `"default"`) يجعله البديل الاحتياطي.
+تُعرّف المتغيرة **فقط المفاتيح التي تتجاوزها**؛ ويتم وراثة الباقي من الإدخال الافتراضي.
+
+```ts fileName="hero-banner.summer.content.ts" contentDeclarationFormat={["typescript", "esm", "commonjs"]}
+import { t, type Dictionary } from "intlayer";
+
+const dictionary = {
+  key: "hero-banner",
+  variant: "summer",
+  content: {
+    headline: t({
+      en: "Build faster all summer",
+      fr: "Développez plus vite tout l'été",
+    }),
+  },
+} satisfies Dictionary;
+
+export default dictionary;
+```
+
+```tsx
+useIntlayer("hero-banner", { variant: "summer" });
+// → { headline: "Développez plus vite tout l'été", cta: "Commencer" } — تم وراثة `cta`
+
+useIntlayer("hero-banner", { variant: "never-declared" });
+// → الإدخال الافتراضي
+```
+
+لذلك لا تضيف ملف متغيرة إلا عندما تختلف الصياغة بالفعل. يتحول المفتاح إلى `null` فقط عندما يُعرّف متغيرات ولكن دون إدخال افتراضي.
+
+### استخدام المتغيرات المسماة
+
+#### المتغير الافتراضي
 
 ```ts fileName="hero-banner.content.ts" contentDeclarationFormat={["typescript", "esm", "commonjs"]}
 import { t, type Dictionary } from "intlayer";
@@ -77,10 +111,6 @@ const dictionary = {
 export default dictionary;
 ```
 
-### استهلاك المتغيرات المُسمّاة
-
-#### المتغير الافتراضي
-
 <Tabs group="framework">
   <Tab label="React" value="react">
     ```tsx fileName="Hero.tsx" contentDeclarationFormat={["typescript", "esm", "commonjs"]}

package/docs/de/dynamic_dictionaries/variants.md

@@ -23,6 +23,9 @@ history:
   - version: 9.1.0
     date: 2026-06-26
     changes: "`variant` akzeptiert jetzt einen String oder ein Objekt — die früheren `meta` / dynamischen Datensätze werden als Objekt-Varianten deklariert"
+  - version: 9.1.1
+    date: 2026-07-31
+    changes: "Eine Variante deklariert nur die Schlüssel, die sie überschreibt; nicht deklarierte Varianten fallen auf den Standardeintrag zurück"
 author: aymericzip
 ---
 
@@ -77,6 +80,37 @@ const dictionary = {
 export default dictionary;
 ```
 
+### Teilvarianten
+
+Eine Variante deklariert **nur die Schlüssel, die sie überschreibt**; der Rest wird vom Standardeintrag geerbt.
+
+```ts fileName="hero-banner.summer.content.ts" contentDeclarationFormat={["typescript", "esm", "commonjs"]}
+import { t, type Dictionary } from "intlayer";
+
+const dictionary = {
+  key: "hero-banner",
+  variant: "summer",
+  content: {
+    headline: t({
+      en: "Build faster all summer",
+      fr: "Développez plus vite tout l'été",
+    }),
+  },
+} satisfies Dictionary;
+
+export default dictionary;
+```
+
+```tsx
+useIntlayer("hero-banner", { variant: "summer" });
+// → { headline: "Développez plus vite tout l'été", cta: "Commencer" } — `cta` geerbt
+
+useIntlayer("hero-banner", { variant: "never-declared" });
+// → der Standardeintrag
+```
+
+Fügen Sie also nur dort eine Varianten-Datei hinzu, wo der Wortlaut tatsächlich abweicht. Ein Schlüssel wird nur dann in `null` aufgelöst, wenn er Varianten deklariert, aber keinen Standardeintrag.
+
 ### Benannte Varianten verwenden
 
 #### Standardvariante

package/docs/en/dynamic_dictionaries/variants.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-06-12
-updatedAt: 2026-06-26
+updatedAt: 2026-07-31
 title: Variants
 description: Use the variant metadata field in Intlayer content files to declare named or structured content alternatives — A/B tests, seasonal banners, feature-flagged copy, CMS records, user-specific content — and switch between them at runtime without code changes.
 keywords:
@@ -23,6 +23,9 @@ history:
   - version: 9.1.0
     date: 2026-06-26
     changes: "`variant` now accepts a string or an object — the former `meta` / dynamic records are declared as object variants"
+  - version: 9.1.1
+    date: 2026-07-31
+    changes: "A variant declares only the keys it overrides; undeclared variants fall back to the default entry"
 author: aymericzip
 ---
 
@@ -77,6 +80,37 @@ const dictionary = {
 export default dictionary;
 ```
 
+### Partial variants
+
+A variant declares **only the keys it overrides**; the rest are inherited from the default entry.
+
+```ts fileName="hero-banner.summer.content.ts" contentDeclarationFormat={["typescript", "esm", "commonjs"]}
+import { t, type Dictionary } from "intlayer";
+
+const dictionary = {
+  key: "hero-banner",
+  variant: "summer",
+  content: {
+    headline: t({
+      en: "Build faster all summer",
+      fr: "Développez plus vite tout l'été",
+    }),
+  },
+} satisfies Dictionary;
+
+export default dictionary;
+```
+
+```tsx
+useIntlayer("hero-banner", { variant: "summer" });
+// → { headline: "Build faster all summer", cta: "Get started" } — `cta` inherited
+
+useIntlayer("hero-banner", { variant: "never-declared" });
+// → the default entry
+```
+
+So you only add a variant file where the wording actually differs. A key resolves to `null` only when it declares variants but no default entry.
+
 ### Consuming named variants
 
 #### Default variant

package/docs/en-GB/dynamic_dictionaries/variants.md

@@ -23,6 +23,9 @@ history:
   - version: 9.1.0
     date: 2026-06-26
     changes: "`variant` now accepts a string or an object — the former `meta` / dynamic records are declared as object variants"
+  - version: 9.1.1
+    date: 2026-07-31
+    changes: "A variant declares only the keys it overrides; undeclared variants fall back to the default entry"
 author: aymericzip
 ---
 
@@ -77,6 +80,37 @@ const dictionary = {
 export default dictionary;
 ```
 
+### Partial variants
+
+A variant declares **only the keys it overrides**; the rest are inherited from the default entry.
+
+```ts fileName="hero-banner.summer.content.ts" contentDeclarationFormat={["typescript", "esm", "commonjs"]}
+import { t, type Dictionary } from "intlayer";
+
+const dictionary = {
+  key: "hero-banner",
+  variant: "summer",
+  content: {
+    headline: t({
+      en: "Build faster all summer",
+      fr: "Développez plus vite tout l'été",
+    }),
+  },
+} satisfies Dictionary;
+
+export default dictionary;
+```
+
+```tsx
+useIntlayer("hero-banner", { variant: "summer" });
+// → { headline: "Build faster all summer", cta: "Get started" } — `cta` inherited
+
+useIntlayer("hero-banner", { variant: "never-declared" });
+// → the default entry
+```
+
+So you only add a variant file where the wording actually differs. A key resolves to `null` only when it declares variants but no default entry.
+
 ### Consuming named variants
 
 #### Default variant

package/docs/es/dynamic_dictionaries/variants.md

@@ -23,6 +23,9 @@ history:
   - version: 9.1.0
     date: 2026-06-26
     changes: "`variant` ahora acepta una cadena o un objeto — los antiguos `meta` / registros dinámicos se declaran como variantes de objeto"
+  - version: 9.1.1
+    date: 2026-07-31
+    changes: "Una variante declara solo las claves que anula; las variantes no declaradas recurren a la entrada por defecto"
 author: aymericzip
 ---
 
@@ -77,6 +80,37 @@ const dictionary = {
 export default dictionary;
 ```
 
+### Variantes parciales
+
+Una variante declara **solo las claves que anula**; el resto se hereda de la entrada por defecto.
+
+```ts fileName="hero-banner.summer.content.ts" contentDeclarationFormat={["typescript", "esm", "commonjs"]}
+import { t, type Dictionary } from "intlayer";
+
+const dictionary = {
+  key: "hero-banner",
+  variant: "summer",
+  content: {
+    headline: t({
+      en: "Build faster all summer",
+      fr: "Développez plus vite tout l'été",
+    }),
+  },
+} satisfies Dictionary;
+
+export default dictionary;
+```
+
+```tsx
+useIntlayer("hero-banner", { variant: "summer" });
+// → { headline: "Développez plus vite tout l'été", cta: "Commencer" } — `cta` heredado
+
+useIntlayer("hero-banner", { variant: "never-declared" });
+// → la entrada por defecto
+```
+
+Por lo tanto, solo debe agregar un archivo de variante donde la redacción realmente difiera. Una clave se resuelve en `null` solo cuando declara variantes pero ninguna entrada por defecto.
+
 ### Consumir variantes con nombre
 
 #### Variante por defecto

package/docs/fr/dynamic_dictionaries/variants.md

@@ -23,6 +23,9 @@ history:
   - version: 9.1.0
     date: 2026-06-26
     changes: "`variant` accepte désormais une chaîne ou un objet — les anciens `meta` / enregistrements dynamiques se déclarent comme variantes objet"
+  - version: 9.1.1
+    date: 2026-07-31
+    changes: "Une variante déclare uniquement les clés qu'elle remplace ; les variantes non déclarées se rabattent sur l'entrée par défaut"
 author: aymericzip
 ---
 
@@ -77,6 +80,37 @@ const dictionary = {
 export default dictionary;
 ```
 
+### Variantes partielles
+
+Une variante déclare **uniquement les clés qu'elle remplace** ; le reste est hérité de l'entrée par défaut.
+
+```ts fileName="hero-banner.summer.content.ts" contentDeclarationFormat={["typescript", "esm", "commonjs"]}
+import { t, type Dictionary } from "intlayer";
+
+const dictionary = {
+  key: "hero-banner",
+  variant: "summer",
+  content: {
+    headline: t({
+      en: "Build faster all summer",
+      fr: "Développez plus vite tout l'été",
+    }),
+  },
+} satisfies Dictionary;
+
+export default dictionary;
+```
+
+```tsx
+useIntlayer("hero-banner", { variant: "summer" });
+// → { headline: "Développez plus vite tout l'été", cta: "Commencer" } — `cta` hérité
+
+useIntlayer("hero-banner", { variant: "never-declared" });
+// → l'entrée par défaut
+```
+
+Ainsi, vous n'ajoutez un fichier de variante que là où la formulation diffère réellement. Une clé se résout en `null` uniquement lorsqu'elle déclare des variantes mais aucune entrée par défaut.
+
 ### Consommer des variantes nommées
 
 #### Variante par défaut

package/docs/hi/dynamic_dictionaries/variants.md

@@ -22,7 +22,10 @@ history:
     changes: "वैरिएंट सुविधा का रिलीज़"
   - version: 9.1.0
     date: 2026-06-26
-    changes: "अब `variant` एक स्ट्रिंग या ऑब्जेक्ट स्वीकार करता है — पूर्व `meta` / डायनेमिक रिकॉर्ड ऑब्जेक्ट वैरिएंट के रूप में घोषित किए जाते हैं"
+    changes: "`variant` अब एक स्ट्रिंग या ऑब्जेक्ट स्वीकार करता है — पूर्व `meta` / गतिशील रिकॉर्ड को ऑब्जेक्ट वेरिएंट के रूप में घोषित किया जाता है"
+  - version: 9.1.1
+    date: 2026-07-31
+    changes: "वेरिएंट केवल उन्हीं कुंजियों को घोषित करता है जिन्हें वह ओवरराइड करता है; अघोषित वेरिएंट डिफ़ॉल्ट प्रविष्टि पर वापस आ जाते हैं"
 author: aymericzip
 ---
 
@@ -77,7 +80,38 @@ const dictionary = {
 export default dictionary;
 ```
 
-### नामित वैरिएंट का उपयोग
+### आंशिक वेरिएंट
+
+एक वेरिएंट **केवल उन्हीं कुंजियों को घोषित करता है जिन्हें वह ओवरराइड करता है**; बाकी डिफ़ॉल्ट प्रविष्टि से विरासत में मिलती हैं।
+
+```ts fileName="hero-banner.summer.content.ts" contentDeclarationFormat={["typescript", "esm", "commonjs"]}
+import { t, type Dictionary } from "intlayer";
+
+const dictionary = {
+  key: "hero-banner",
+  variant: "summer",
+  content: {
+    headline: t({
+      en: "Build faster all summer",
+      fr: "Développez plus vite tout l'été",
+    }),
+  },
+} satisfies Dictionary;
+
+export default dictionary;
+```
+
+```tsx
+useIntlayer("hero-banner", { variant: "summer" });
+// → { headline: "Développez plus vite tout l'été", cta: "Commencer" } — `cta` विरासत में मिला
+
+useIntlayer("hero-banner", { variant: "never-declared" });
+// → डिफ़ॉल्ट प्रविष्टि
+```
+
+इसलिए आप केवल वहीं वेरिएंट फ़ाइल जोड़ते हैं जहां शब्द वास्तव में भिन्न होते हैं। एक कुंजी केवल तभी `null` पर हल होती है जब वह वेरिएंट घोषित करती है लेकिन कोई डिफ़ॉल्ट प्रविष्टि नहीं होती है।
+
+### नामित वेरिएंट का उपयोग करना
 
 #### डिफ़ॉल्ट वैरिएंट
 

package/docs/id/dynamic_dictionaries/variants.md

@@ -23,6 +23,9 @@ history:
   - version: 9.1.0
     date: 2026-06-26
     changes: "`variant` kini menerima string atau objek — `meta` / record dinamis sebelumnya dideklarasikan sebagai varian objek"
+  - version: 9.1.1
+    date: 2026-07-31
+    changes: "Varian hanya mendeklarasikan kunci yang ditimpanya; varian yang tidak dideklarasikan akan kembali ke entri default"
 author: aymericzip
 ---
 
@@ -77,6 +80,37 @@ const dictionary = {
 export default dictionary;
 ```
 
+### Varian parsial
+
+Varian **hanya mendeklarasikan kunci yang ditimpanya**; sisanya diwarisi dari entri default.
+
+```ts fileName="hero-banner.summer.content.ts" contentDeclarationFormat={["typescript", "esm", "commonjs"]}
+import { t, type Dictionary } from "intlayer";
+
+const dictionary = {
+  key: "hero-banner",
+  variant: "summer",
+  content: {
+    headline: t({
+      en: "Build faster all summer",
+      fr: "Développez plus vite tout l'été",
+    }),
+  },
+} satisfies Dictionary;
+
+export default dictionary;
+```
+
+```tsx
+useIntlayer("hero-banner", { variant: "summer" });
+// → { headline: "Développez plus vite tout l'été", cta: "Commencer" } — `cta` diwarisi
+
+useIntlayer("hero-banner", { variant: "never-declared" });
+// → entri default
+```
+
+Jadi Anda hanya menambahkan file varian di mana kata-katanya benar-benar berbeda. Sebuah kunci hanya menjadi `null` jika mendeklarasikan varian tetapi tidak ada entri default.
+
 ### Mengonsumsi varian bernama
 
 #### Varian default

package/docs/it/dynamic_dictionaries/variants.md

@@ -22,7 +22,10 @@ history:
     changes: "Rilascio della funzionalità delle varianti"
   - version: 9.1.0
     date: 2026-06-26
-    changes: "`variant` ora accetta una stringa o un oggetto — i precedenti `meta` / record dinamici si dichiarano come varianti oggetto"
+    changes: "`variant` ora accetta una stringa o un oggetto — i precedenti `meta` / record dinamici vengono dichiarati come varianti oggetto"
+  - version: 9.1.1
+    date: 2026-07-31
+    changes: "Una variante dichiara solo le chiavi che sovrascrive; le varianti non dichiarate ricadono sulla voce predefinita"
 author: aymericzip
 ---
 
@@ -77,6 +80,37 @@ const dictionary = {
 export default dictionary;
 ```
 
+### Varianti parziali
+
+Una variante dichiara **solo le chiavi che sovrascrive**; il resto viene ereditato dalla voce predefinita.
+
+```ts fileName="hero-banner.summer.content.ts" contentDeclarationFormat={["typescript", "esm", "commonjs"]}
+import { t, type Dictionary } from "intlayer";
+
+const dictionary = {
+  key: "hero-banner",
+  variant: "summer",
+  content: {
+    headline: t({
+      en: "Build faster all summer",
+      fr: "Développez plus vite tout l'été",
+    }),
+  },
+} satisfies Dictionary;
+
+export default dictionary;
+```
+
+```tsx
+useIntlayer("hero-banner", { variant: "summer" });
+// → { headline: "Développez plus vite tout l'été", cta: "Commencer" } — `cta` ereditato
+
+useIntlayer("hero-banner", { variant: "never-declared" });
+// → la voce predefinita
+```
+
+Quindi aggiungi un file variante solo dove la formulazione differisce effettivamente. Una chiave si risolve in `null` solo quando dichiara varianti ma nessuna voce predefinita.
+
 ### Consumare varianti con nome
 
 #### Variante predefinita

package/docs/ja/dynamic_dictionaries/variants.md

@@ -22,7 +22,10 @@ history:
     changes: "バリアント機能のリリース"
   - version: 9.1.0
     date: 2026-06-26
-    changes: "`variant` が文字列またはオブジェクトを受け取るようになりました — 旧 `meta` / 動的レコードはオブジェクトバリアントとして宣言します"
+    changes: "`variant`は文字列またはオブジェクトを受け付けるようになりました — 以前の `meta` / 動的レコードはオブジェクトバリアントとして宣言されます"
+  - version: 9.1.1
+    date: 2026-07-31
+    changes: "バリアントは上書きするキーのみを宣言します。宣言されていないバリアントはデフォルトのエントリにフォールバックします"
 author: aymericzip
 ---
 
@@ -77,6 +80,37 @@ const dictionary = {
 export default dictionary;
 ```
 
+### 部分的なバリアント
+
+バリアントは**上書きするキーのみを宣言します**。残りはデフォルトのエントリから継承されます。
+
+```ts fileName="hero-banner.summer.content.ts" contentDeclarationFormat={["typescript", "esm", "commonjs"]}
+import { t, type Dictionary } from "intlayer";
+
+const dictionary = {
+  key: "hero-banner",
+  variant: "summer",
+  content: {
+    headline: t({
+      en: "Build faster all summer",
+      fr: "Développez plus vite tout l'été",
+    }),
+  },
+} satisfies Dictionary;
+
+export default dictionary;
+```
+
+```tsx
+useIntlayer("hero-banner", { variant: "summer" });
+// → { headline: "Développez plus vite tout l'été", cta: "Commencer" } — `cta` は継承されます
+
+useIntlayer("hero-banner", { variant: "never-declared" });
+// → デフォルトのエントリ
+```
+
+したがって、実際にテキストが異なる場所にのみバリアントファイルを追加します。バリアントを宣言しているがデフォルトのエントリがない場合にのみ、キーは `null` に解決されます。
+
 ### 名前付きバリアントの利用
 
 #### デフォルトバリアント

package/docs/ko/dynamic_dictionaries/variants.md

@@ -22,7 +22,10 @@ history:
     changes: "변형 기능 출시"
   - version: 9.1.0
     date: 2026-06-26
-    changes: "이제 `variant`는 문자열 또는 객체를 허용합니다 — 이전의 `meta` / 동적 레코드는 객체 변형으로 선언됩니다"
+    changes: "`variant`는 이제 문자열 또는 객체를 허용합니다 — 이전의 `meta` / 동적 레코드는 객체 변형으로 선언됩니다"
+  - version: 9.1.1
+    date: 2026-07-31
+    changes: "변형은 재정의하는 키만 선언합니다. 선언되지 않은 변형은 기본 항목으로 대체됩니다"
 author: aymericzip
 ---
 
@@ -77,6 +80,37 @@ const dictionary = {
 export default dictionary;
 ```
 
+### 부분 변형
+
+변형은 **재정의하는 키만 선언합니다**. 나머지는 기본 항목에서 상속됩니다.
+
+```ts fileName="hero-banner.summer.content.ts" contentDeclarationFormat={["typescript", "esm", "commonjs"]}
+import { t, type Dictionary } from "intlayer";
+
+const dictionary = {
+  key: "hero-banner",
+  variant: "summer",
+  content: {
+    headline: t({
+      en: "Build faster all summer",
+      fr: "Développez plus vite tout l'été",
+    }),
+  },
+} satisfies Dictionary;
+
+export default dictionary;
+```
+
+```tsx
+useIntlayer("hero-banner", { variant: "summer" });
+// → { headline: "Développez plus vite tout l'été", cta: "Commencer" } — `cta`가 상속됨
+
+useIntlayer("hero-banner", { variant: "never-declared" });
+// → 기본 항목
+```
+
+따라서 텍스트가 실제로 다른 곳에만 변형 파일을 추가하면 됩니다. 변형을 선언했지만 기본 항목이 없는 경우에만 키가 `null`로 확인됩니다.
+
 ### 이름 지정 변형 사용
 
 #### 기본 변형

package/docs/pl/dynamic_dictionaries/variants.md

@@ -22,7 +22,10 @@ history:
     changes: "Wydanie funkcji wariantów"
   - version: 9.1.0
     date: 2026-06-26
-    changes: "`variant` przyjmuje teraz ciąg znaków lub obiekt — dawne `meta` / rekordy dynamiczne deklaruje się jako warianty obiektowe"
+    changes: "`variant` akceptuje teraz ciąg znaków lub obiekt — dawne rekordy `meta` / dynamiczne są deklarowane jako warianty obiektowe"
+  - version: 9.1.1
+    date: 2026-07-31
+    changes: "Wariant deklaruje tylko klucze, które nadpisuje; niezadeklarowane warianty powracają do domyślnego wpisu"
 author: aymericzip
 ---
 
@@ -77,6 +80,37 @@ const dictionary = {
 export default dictionary;
 ```
 
+### Warianty częściowe
+
+Wariant deklaruje **tylko klucze, które nadpisuje**; reszta jest dziedziczona z wpisu domyślnego.
+
+```ts fileName="hero-banner.summer.content.ts" contentDeclarationFormat={["typescript", "esm", "commonjs"]}
+import { t, type Dictionary } from "intlayer";
+
+const dictionary = {
+  key: "hero-banner",
+  variant: "summer",
+  content: {
+    headline: t({
+      en: "Build faster all summer",
+      fr: "Développez plus vite tout l'été",
+    }),
+  },
+} satisfies Dictionary;
+
+export default dictionary;
+```
+
+```tsx
+useIntlayer("hero-banner", { variant: "summer" });
+// → { headline: "Développez plus vite tout l'été", cta: "Commencer" } — `cta` odziedziczone
+
+useIntlayer("hero-banner", { variant: "never-declared" });
+// → wpis domyślny
+```
+
+Dlatego dodajesz plik wariantu tylko tam, gdzie brzmienie faktycznie się różni. Klucz jest rozwiązywany na `null` tylko wtedy, gdy deklaruje warianty, ale nie ma domyślnego wpisu.
+
 ### Korzystanie z wariantów nazwanych
 
 #### Wariant domyślny

package/docs/pt/dynamic_dictionaries/variants.md

@@ -23,6 +23,9 @@ history:
   - 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"
+  - version: 9.1.1
+    date: 2026-07-31
+    changes: "Uma variante declara apenas as chaves que sobrescreve; as variantes não declaradas retornam para a entrada padrão"
 author: aymericzip
 ---
 
@@ -77,6 +80,37 @@ const dictionary = {
 export default dictionary;
 ```
 
+### Variantes parciais
+
+Uma variante declara **apenas as chaves que sobrescreve**; o restante é herdado da entrada padrão.
+
+```ts fileName="hero-banner.summer.content.ts" contentDeclarationFormat={["typescript", "esm", "commonjs"]}
+import { t, type Dictionary } from "intlayer";
+
+const dictionary = {
+  key: "hero-banner",
+  variant: "summer",
+  content: {
+    headline: t({
+      en: "Build faster all summer",
+      fr: "Développez plus vite tout l'été",
+    }),
+  },
+} satisfies Dictionary;
+
+export default dictionary;
+```
+
+```tsx
+useIntlayer("hero-banner", { variant: "summer" });
+// → { headline: "Développez plus vite tout l'été", cta: "Commencer" } — `cta` herdado
+
+useIntlayer("hero-banner", { variant: "never-declared" });
+// → a entrada padrão
+```
+
+Portanto, adicione um arquivo de variante apenas onde o texto realmente difere. Uma chave é resolvida como `null` apenas quando declara variantes, mas nenhuma entrada padrão.
+
 ### Consumir variantes nomeadas
 
 #### Variante padrão

package/docs/ru/dynamic_dictionaries/variants.md

@@ -22,7 +22,10 @@ history:
     changes: "Выпуск функции вариантов"
   - version: 9.1.0
     date: 2026-06-26
-    changes: "`variant` теперь принимает строку или объект — прежние `meta` / динамические записи объявляются как объектные варианты"
+    changes: "`variant` теперь принимает строку или объект — прежние `meta` / динамические записи объявляются как вариант объектов"
+  - version: 9.1.1
+    date: 2026-07-31
+    changes: "Вариант объявляет только ключи, которые он переопределяет; необъявленные варианты возвращаются к записи по умолчанию"
 author: aymericzip
 ---
 
@@ -77,6 +80,37 @@ const dictionary = {
 export default dictionary;
 ```
 
+### Частичные варианты
+
+Вариант **объявляет только ключи, которые он переопределяет**; остальные наследуются из записи по умолчанию.
+
+```ts fileName="hero-banner.summer.content.ts" contentDeclarationFormat={["typescript", "esm", "commonjs"]}
+import { t, type Dictionary } from "intlayer";
+
+const dictionary = {
+  key: "hero-banner",
+  variant: "summer",
+  content: {
+    headline: t({
+      en: "Build faster all summer",
+      fr: "Développez plus vite tout l'été",
+    }),
+  },
+} satisfies Dictionary;
+
+export default dictionary;
+```
+
+```tsx
+useIntlayer("hero-banner", { variant: "summer" });
+// → { headline: "Développez plus vite tout l'été", cta: "Commencer" } — `cta` унаследовано
+
+useIntlayer("hero-banner", { variant: "never-declared" });
+// → запись по умолчанию
+```
+
+Поэтому вы добавляете файл варианта только там, где текст действительно отличается. Ключ разрешается в `null` только в том случае, если он объявляет варианты, но не имеет записи по умолчанию.
+
 ### Использование именованных вариантов
 
 #### Вариант по умолчанию

package/docs/tr/dynamic_dictionaries/variants.md

@@ -22,7 +22,10 @@ history:
     changes: "Varyantlar özelliğinin yayımlanması"
   - version: 9.1.0
     date: 2026-06-26
-    changes: "`variant` artık bir dize veya nesne kabul ediyor — eski `meta` / dinamik kayıtlar nesne varyantı olarak bildirilir"
+    changes: "`variant` artık bir dize veya bir nesne kabul ediyor — önceki `meta` / dinamik kayıtlar nesne varyantları olarak bildiriliyor"
+  - version: 9.1.1
+    date: 2026-07-31
+    changes: "Bir varyant yalnızca geçersiz kıldığı anahtarları bildirir; bildirilmemiş varyantlar varsayılan girdiye geri döner"
 author: aymericzip
 ---
 
@@ -77,6 +80,37 @@ const dictionary = {
 export default dictionary;
 ```
 
+### Kısmi varyantlar
+
+Bir varyant **yalnızca geçersiz kıldığı anahtarları bildirir**; geri kalanı varsayılan girdiden miras alınır.
+
+```ts fileName="hero-banner.summer.content.ts" contentDeclarationFormat={["typescript", "esm", "commonjs"]}
+import { t, type Dictionary } from "intlayer";
+
+const dictionary = {
+  key: "hero-banner",
+  variant: "summer",
+  content: {
+    headline: t({
+      en: "Build faster all summer",
+      fr: "Développez plus vite tout l'été",
+    }),
+  },
+} satisfies Dictionary;
+
+export default dictionary;
+```
+
+```tsx
+useIntlayer("hero-banner", { variant: "summer" });
+// → { headline: "Développez plus vite tout l'été", cta: "Commencer" } — `cta` miras alındı
+
+useIntlayer("hero-banner", { variant: "never-declared" });
+// → varsayılan girdi
+```
+
+Böylece yalnızca ifadelerin gerçekten farklı olduğu durumlarda bir varyant dosyası eklersiniz. Bir anahtar, yalnızca varyantları bildirip varsayılan girdisi olmadığında `null` olarak çözülür.
+
 ### Adlandırılmış varyantları kullanma
 
 #### Varsayılan varyant

package/docs/uk/dynamic_dictionaries/variants.md

@@ -23,6 +23,9 @@ history:
   - version: 9.1.0
     date: 2026-06-26
     changes: "`variant` тепер приймає рядок або об'єкт — колишні `meta` / динамічні записи оголошуються як об'єктні варіанти"
+  - version: 9.1.1
+    date: 2026-07-31
+    changes: "Варіант оголошує лише ключі, які він перевизначає; неоголошені варіанти повертаються до запису за замовчуванням"
 author: aymericzip
 ---
 
@@ -77,6 +80,37 @@ const dictionary = {
 export default dictionary;
 ```
 
+### Часткові варіанти
+
+Варіант **оголошує лише ключі, які він перевизначає**; решта успадковується з запису за замовчуванням.
+
+```ts fileName="hero-banner.summer.content.ts" contentDeclarationFormat={["typescript", "esm", "commonjs"]}
+import { t, type Dictionary } from "intlayer";
+
+const dictionary = {
+  key: "hero-banner",
+  variant: "summer",
+  content: {
+    headline: t({
+      en: "Build faster all summer",
+      fr: "Développez plus vite tout l'été",
+    }),
+  },
+} satisfies Dictionary;
+
+export default dictionary;
+```
+
+```tsx
+useIntlayer("hero-banner", { variant: "summer" });
+// → { headline: "Développez plus vite tout l'été", cta: "Commencer" } — `cta` успадковано
+
+useIntlayer("hero-banner", { variant: "never-declared" });
+// → запис за замовчуванням
+```
+
+Тому ви додаєте файл варіанту лише там, де текст дійсно відрізняється. Ключ дозволяється в `null` тільки в тому випадку, якщо він оголошує варіанти, але не має запису за замовчуванням.
+
 ### Використання іменованих варіантів
 
 #### Варіант за замовчуванням

package/docs/vi/dynamic_dictionaries/variants.md

@@ -22,7 +22,10 @@ history:
     changes: "Phát hành tính năng biến thể"
   - version: 9.1.0
     date: 2026-06-26
-    changes: "`variant` giờ chấp nhận một chuỗi hoặc một đối tượng — `meta` / bản ghi động trước đây được khai báo dưới dạng biến thể đối tượng"
+    changes: "`variant` hiện chấp nhận một chuỗi hoặc một đối tượng — trước đây `meta` / bản ghi động được khai báo là biến thể đối tượng"
+  - version: 9.1.1
+    date: 2026-07-31
+    changes: "Biến thể chỉ khai báo các khóa mà nó ghi đè; các biến thể không được khai báo sẽ quay lại mục mặc định"
 author: aymericzip
 ---
 
@@ -77,7 +80,38 @@ const dictionary = {
 export default dictionary;
 ```
 
-### Sử dụng biến thể được đặt tên
+### Biến thể một phần
+
+Một biến thể **chỉ khai báo các khóa mà nó ghi đè**; phần còn lại được kế thừa từ mục mặc định.
+
+```ts fileName="hero-banner.summer.content.ts" contentDeclarationFormat={["typescript", "esm", "commonjs"]}
+import { t, type Dictionary } from "intlayer";
+
+const dictionary = {
+  key: "hero-banner",
+  variant: "summer",
+  content: {
+    headline: t({
+      en: "Build faster all summer",
+      fr: "Développez plus vite tout l'été",
+    }),
+  },
+} satisfies Dictionary;
+
+export default dictionary;
+```
+
+```tsx
+useIntlayer("hero-banner", { variant: "summer" });
+// → { headline: "Développez plus vite tout l'été", cta: "Commencer" } — `cta` được kế thừa
+
+useIntlayer("hero-banner", { variant: "never-declared" });
+// → mục mặc định
+```
+
+Vì vậy, bạn chỉ thêm một tệp biến thể ở nơi văn bản thực sự khác biệt. Một khóa chỉ giải quyết thành `null` khi nó khai báo các biến thể nhưng không có mục mặc định.
+
+### Tiêu thụ các biến thể được đặt tên
 
 #### Biến thể mặc định
 

package/docs/zh/dynamic_dictionaries/variants.md

@@ -22,7 +22,10 @@ history:
     changes: "变体功能发布"
   - version: 9.1.0
     date: 2026-06-26
-    changes: "`variant` 现在接受字符串或对象——以前的 `meta` / 动态记录现声明为对象变体"
+    changes: "`variant` 现在接受字符串或对象 — 以前的 `meta` / 动态记录现在声明为对象变体"
+  - version: 9.1.1
+    date: 2026-07-31
+    changes: "变体仅声明它覆盖的键；未声明的变体将回退到默认条目"
 author: aymericzip
 ---
 
@@ -77,6 +80,37 @@ const dictionary = {
 export default dictionary;
 ```
 
+### 部分变体
+
+变体**仅声明它覆盖的键**；其余部分从默认条目继承。
+
+```ts fileName="hero-banner.summer.content.ts" contentDeclarationFormat={["typescript", "esm", "commonjs"]}
+import { t, type Dictionary } from "intlayer";
+
+const dictionary = {
+  key: "hero-banner",
+  variant: "summer",
+  content: {
+    headline: t({
+      en: "Build faster all summer",
+      fr: "Développez plus vite tout l'été",
+    }),
+  },
+} satisfies Dictionary;
+
+export default dictionary;
+```
+
+```tsx
+useIntlayer("hero-banner", { variant: "summer" });
+// → { headline: "Développez plus vite tout l'été", cta: "Commencer" } — 继承了 `cta`
+
+useIntlayer("hero-banner", { variant: "never-declared" });
+// → 默认条目
+```
+
+因此，您只需在文本确实不同的地方添加变体文件。只有在声明了变体但没有默认条目的情况下，键才会解析为 `null`。
+
 ### 使用具名变体
 
 #### 默认变体

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intlayer/docs",
-  "version": "9.1.0",
+  "version": "9.1.1",
   "private": false,
   "description": "Intlayer documentation",
   "keywords": [
@@ -73,13 +73,13 @@
     "watch": "webpack --config ./webpack.config.ts --watch"
   },
   "dependencies": {
-    "@intlayer/config": "9.1.0",
-    "@intlayer/core": "9.1.0",
-    "@intlayer/types": "9.1.0"
+    "@intlayer/config": "9.1.1",
+    "@intlayer/core": "9.1.1",
+    "@intlayer/types": "9.1.1"
   },
   "devDependencies": {
-    "@intlayer/api": "9.1.0",
-    "@intlayer/cli": "9.1.0",
+    "@intlayer/api": "9.1.1",
+    "@intlayer/cli": "9.1.1",
     "@types/node": "26.1.2",
     "@utils/ts-config": "1.0.4",
     "@utils/ts-config-types": "1.0.4",