@intlayer/docs 8.12.5-canary.0 → 9.0.0-canary.10

package/docs/hi/releases/v8.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-09-22
-updatedAt: 2026-01-26
+updatedAt: 2026-06-14
 title: "नया Intlayer v8 - क्या नया है?"
 description: "जानें Intlayer v8 में क्या नया है। डेवलपर अनुभव, सामग्री सत्यापन, और शब्दकोश प्रबंधन में प्रमुख सुधार।"
 keywords:
@@ -409,6 +409,16 @@ v7 में, यदि कोई प्रदाता परिभाषित
 
 ---
 
+## YAML और Markdown सामग्री फ़ाइलें (v8.10.0)
+
+अब आप सीधे `.content.md` और `.content.yaml` फ़ाइल एक्सटेंशन का उपयोग करके सामग्री घोषित कर सकते हैं। यह लंबी सामग्री, ब्लॉग, दस्तावेज़ और गोपनीयता नीतियों के लिए बिल्कुल सही है।
+
+ये फ़ाइलें विज़ुअल एडिटर (Visual Editor) से पूरी तरह से संपादन योग्य हैं, जो गैर-तकनीकी टीम के सदस्यों के लिए एक सुव्यवस्थित वर्कफ़्लो प्रदान करती हैं।
+
+अधिक जानकारी के लिए, [YAML सामग्री फ़ाइल दस्तावेज़](https://intlayer.org/doc/concept/content#yaml-content-file) और [Markdown सामग्री फ़ाइल दस्तावेज़](https://intlayer.org/doc/concept/content/markdown) देखें।
+
+---
+
 ## कस्टम URL पुनर्लेखन
 
 Intlayer v8 **कस्टम URL पुनर्लेखन (Custom URL Rewrites)** के लिए समर्थन पेश करता है, जिससे आप ऐसी भाषा-विशिष्ट पथ परिभाषित कर सकते हैं जो मानक `/locale/path` संरचना से भिन्न होते हैं। यह स्थानीय SEO को बेहतर बनाने और गैर-अंग्रेजी बोलने वालों के लिए अधिक प्राकृतिक उपयोगकर्ता अनुभव प्रदान करने के लिए एक शक्तिशाली विशेषता है।
@@ -753,6 +763,58 @@ export default {
   </Tab>
 </Tabs>
 
+## Unicode CLDR बहुवचन नियम (v8.8.0)
+
+Unicode CLDR प्रोजेक्ट द्वारा परिभाषित बहुवचन नियमों के आधार पर एक नया `plural` नोड हेल्पर पेश किया गया है, जो जटिल भाषाओं के लिए समर्थन में सुधार करता है।
+
+```typescript fileName="src/openings.content.ts"
+import { plural, t, type Dictionary } from "intlayer";
+
+const openingsContent = {
+  key: "total_openings",
+  content: {
+    totalOpenings: t({
+      en: plural({
+        one: "{{count}} opening",
+        other: "{{count}} openings",
+      }),
+      fr: plural({
+        one: "{{count}} offre",
+        other: "{{count}} offres",
+      }),
+    }),
+  },
+} satisfies Dictionary;
+
+export default openingsContent;
+```
+
+इसके बाद आप अपने फ्रेमवर्क घटक में गतिशील रूप से (dynamically) काउंट पास कर सकते हैं:
+
+```tsx
+import type { FC } from "react";
+import { useIntlayer } from "react-intlayer";
+
+const OpeningsComponent: FC<{ count: number }> = ({ count }) => {
+  const { totalOpenings } = useIntlayer("total_openings");
+
+  return (
+    <div>
+      {/* अंग्रेजी में:                                  */}
+      {/*  count=0  → "0 openings"   (other)           */}
+      {/*  count=1  → "1 opening"    (one)             */}
+      {/*  count=2  → "2 openings"   (other)           */}
+      {/*  count=21 → "21 openings"  (other)           */}
+      <p>{totalOpenings(count)}</p>
+    </div>
+  );
+};
+```
+
+अधिक जानकारी के लिए, [बहुवचनीकरण दस्तावेज़ (Pluralization Documentation)](https://intlayer.org/doc/concept/content/plural) देखें।
+
+---
+
 ## सामग्री स्कीमा सत्यापन
 
 Intlayer v8 शब्दकोशों (dictionaries) के लिए स्कीमा सत्यापन पेश करता है। अब आप Zod का उपयोग करके अपने कॉन्फ़िगरेशन में पुन: प्रयोज्य सत्यापन स्कीमा परिभाषित कर सकते हैं और उन्हें अपनी सामग्री फ़ाइलों पर लागू कर सकते हैं। यह सुनिश्चित करता है कि आपकी सामग्री हमेशा अपेक्षित संरचना का पालन करे, बिल्ड समय पर त्रुटियों को पकड़ ले।
@@ -797,6 +859,34 @@ export default aboutPageMetaContent;
 
 ---
 
+## TypeScript: IntlayerNode प्रिमिटिव एक्सेसर्स (Primitive Accessors)
+
+सामग्री नोड्स पर सीधे प्रिमिटिव जावास्क्रिप्ट विधियों (primitive JavaScript methods) को कॉल करने की अनुमति देने के लिए `IntlayerNode` प्रकार को अपडेट किया गया है। यह आपकी स्थानीयकृत सामग्री के साथ सीधे बातचीत करना संभव बनाता है जैसे कि यह एक मानक स्ट्रिंग, नंबर, बूलियन या एरे प्रिमिटिव हो।
+
+React, Preact, Solid, Svelte, Vue, और Angular में समर्थित।
+
+### स्ट्रिंग उदाहरण (String Example)
+
+```typescript
+content.placeholder; // IntlayerNode<string> लौटाता है
+content.placeholder.value; // string लौटाता है
+content.placeholder.toString(); // string लौटाता है
+content.placeholder.toLowerCase(); // string लौटाता है
+String(content.placeholder); // string लौटाता है
+content.placeholder.toUpperCase(); // अपरकेस स्ट्रिंग लौटाता है
+content.placeholder.replace("a", "b"); // संशोधित स्ट्रिंग लौटाता है
+```
+
+### एरे उदाहरण (Array Example)
+
+```typescript
+content.myArrayOfString             // IntlayerNode<Array<string>> लौटाता है
+content.myArrayOfString.find(...)   // तत्व (element) लौटाता है
+content.myArrayOfString.join(', ')  // संयुक्त स्ट्रिंग लौटाता है
+```
+
+---
+
 ### उन्नत स्वचालित सामग्री पहचान
 
 v8 में, Intlayer आपकी सामग्री स्ट्रिंग्स में मार्कडाउन सिंटैक्स, HTML टैग और वेरिएबल इनसर्शन को बुद्धिमानी से पहचानता है। इसका मतलब है कि आप अक्सर `md()`, `html()`, या `insert()` जैसे सहायक कार्यों को छोड़ सकते हैं।
@@ -1002,6 +1092,17 @@ Intlayer VSCode एक्सटेंशन को आपके अंतर्
 
 ---
 
+## टूलिंग: C++ वॉचर और OXC-आधारित LSP (v8.12.0)
+
+Intlayer v8.12.0 डेवलपर अनुभव में बड़े सुधार लाता है:
+
+- **Parcel Watcher**: सामग्री वॉचर (content watcher) को `chokidar` से `@parcel/watcher` पर माइग्रेट कर दिया गया है, जो तेज़ अपडेट और काफी कम मेमोरी खपत प्रदान करने के लिए मूल C++ फ़ाइल वॉचिंग का लाभ उठाता है।
+- **नया लैंग्वेज सर्वर प्रोटोकॉल (LSP)**: एक बिल्कुल नया LSP अब उपलब्ध है। OXC-आधारित पार्सिंग के साथ निर्मित, यह आपके IDE और AI एजेंटों को `useIntlayer('my-key')` कॉल को उनकी संबंधित `.content` फ़ाइलों के साथ सहजता से जोड़ने में मदद करता है, और इसके विपरीत भी।
+
+अधिक जानकारी के लिए, [LSP दस्तावेज़](https://intlayer.org/doc/lsp) देखें।
+
+---
+
 ## कंपाइलर अनुकूलन
 
 Intlayer v8 में मार्कडाउन और HTML कंपाइलर के लिए एक नई कैशिंग लेयर शामिल है। यह सुनिश्चित करता है कि एक ही कॉन्फ़िगरेशन के साथ समान सामग्री स्ट्रिंग्स केवल एक बार पार्स की जाती हैं, जिससे री-रेंडर के दौरान या कई स्थानों पर समान सामग्री का उपयोग करते समय ओवरहेड काफी कम हो जाता है।
@@ -1057,6 +1158,48 @@ Intlayer v8 में मार्कडाउन और HTML कंपाइल
 
 ---
 
+## प्रायोगिक बिल्ड अनुकूलन: Minify और Purge (v8.7.0)
+
+Intlayer v8.7.0 आपके प्रोडक्शन बंडल को अनुकूलित करने के लिए डिज़ाइन की गई आपकी `intlayer.config.ts` में नई प्रायोगिक बिल्ड सुविधाएँ पेश करता है:
+
+- **डिक्शनरी मिनिफिकेशन (Dictionary Minification)**: आकार घटाने के लिए डिक्शनरी फ़ाइलों को छोटा (minify) करता है।
+- **अनुपयोगी कुंजी पर्जिंग (Unused Key Purging)**: डिक्शनरी से अनुपयोगी अनुवाद कुंजियों को स्कैन और हटाता है, सक्रिय कुंजियों का नाम बदलकर छोटे वर्णों में कर देता है (उदा. `"products" -> "a"`, `"pricing" -> "b"`)। यह बंडल के आकार को 5% तक कम कर देता है।
+- **TypeScript जांच अक्षम करें**: संकलन (compilation) चरण के दौरान TypeScript टाइपचेकिंग को अक्षम करके बिल्ड को तेज़ करें।
+
+```typescript fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH],
+    defaultLocale: Locales.ENGLISH,
+  },
+  dictionary: {
+    importMode: "dynamic",
+  },
+  build: {
+    /**
+     * बंडल के आकार को कम करने के लिए डिक्शनरी को छोटा (minify) करें।
+     */
+    minify: true,
+
+    /**
+     * डिक्शनरी में अनुपयोगी कुंजियों को हटाएँ (purge करें)
+     */
+    purge: true,
+
+    /**
+     * इंगित करता है कि क्या बिल्ड को TypeScript प्रकारों की जांच करनी चाहिए
+     */
+    checkTypes: false,
+  },
+};
+
+export default config;
+```
+
+---
+
 ## लचीलापन: एकीकृत आयात मोड (Unified Import Mode)
 
 `live` बूलियन प्रॉपर्टी को अधिक व्यापक `importMode` प्रॉपर्टी के पक्ष में हटा दिया गया है। यह शब्दकोशों को लोड करने के तरीके की स्पष्ट परिभाषा की अनुमति देता है: स्थिर रूप से, गतिशील रूप से, या लाइव सिंक के माध्यम से।
@@ -1164,7 +1307,7 @@ export default {
 
 ## सामग्री और कोड निर्देशिका पृथक्करण
 
-Intlayer v8 सामग्री परिभाषा फ़ाइलों के कॉन्फ़िगरेशन को कोड परिवर्तन के कॉन्फ़िगरेशन से अलग करता है। यह अधिक सटीक निगरानी और स्कैनिंग की अनुमति देता है, जिससे बिल्ड प्रदर्शन में सुधार होता है।
+Intlayer v8 सामग्री परिभाषा फ़ाइलों के कॉन्फ़िगरेशन को कोड परिवर्तन के कॉन्फ़िगरेशन से अलग करता है। यह अधिक सटीक निगरानी और स्कैनिंग की अनुमति देता, जिससे बिल्ड प्रदर्शन में सुधार होता है।
 
 पहले, `contentDir` का उपयोग `.content.*` फ़ाइलों को देखने और `useIntlayer` कॉल्स के लिए कोड स्कैन करने दोनों के लिए किया जाता था। अब:
 
@@ -1204,6 +1347,49 @@ Svelte में मार्कडाउन और HTML सामग्री
 
 ---
 
+## Angular समर्थन: Vite बंडलर (v8.11.0)
+
+Angular उपयोगकर्ताओं के लिए, Intlayer अब एक नए कस्टम esbuild प्लगइन के माध्यम से मूल रूप से Vite बंडलर का समर्थन करता, जिससे विकास और बिल्ड समय तेज़ हो जाता है।
+
+कॉन्फ़िगरेशन के विवरण के लिए, [Angular पर्यावरण दस्तावेज़ (Angular Environment Documentation)](https://intlayer.org/doc/environment/angular) देखें।
+
+---
+
+## साइटमैप जनरेशन (v8.6.0)
+
+Intlayer अब आपके लोकेल्स और राउटिंग मोड के आधार पर स्वचालित रूप से साइटमैप जेनरेट करता है। यह विशेष रूप से TanStack Router जैसे राउटर आर्किटेक्चर में SEO अनुकूलन के लिए उपयोगी है:
+
+```typescript fileName="src/routes/sitemap.xml.ts"
+import { createFileRoute } from "@tanstack/react-router";
+import { generateSitemap } from "intlayer";
+
+const SITE_URL = (
+  import.meta.env.VITE_SITE_URL ?? "http://localhost:3000"
+).replace(/\/$/, "");
+
+export const Route = createFileRoute("/sitemap.xml")({
+  server: {
+    handlers: {
+      GET: async () => {
+        const sitemap = generateSitemap(
+          [
+            { path: "/", changefreq: "daily", priority: 1.0 },
+            { path: "/about", changefreq: "monthly", priority: 0.8 },
+          ],
+          { siteUrl: SITE_URL }
+        );
+
+        return new Response(sitemap, {
+          headers: { "Content-Type": "application/xml" },
+        });
+      },
+    },
+  },
+});
+```
+
+---
+
 ## v7 से माइग्रेशन नोट्स
 
 ### कॉन्फ़िगरेशन परिवर्तन

package/docs/hi/releases/v9.md

@@ -0,0 +1,316 @@
+---
+createdAt: 2026-06-14
+updatedAt: 2026-06-26
+title: नया Intlayer v9 - क्या नया है?
+description: जानें कि Intlayer v9 में क्या नया है। लोकप्रिय i18n लाइब्रेरीज़ के लिए ड्रॉप-इन कम्पैटिबिलिटी पैकेजेस और Collections और Variants के लिए सपोर्ट का परिचय।
+keywords:
+  - Intlayer
+  - Compatibility
+  - Migration
+  - Collections
+  - Variants
+  - i18next
+  - next-intl
+  - vue-i18n
+slugs:
+  - doc
+  - releases
+  - v9
+author: aymericzip
+---
+
+# नया Intlayer v9 - क्या नया है?
+
+Intlayer v9 में आपका स्वागत है! यह मेजर रिलीज़ प्रमुख i18n लाइब्रेरीज़ (`react-i18next`, `next-intl`, `vue-i18n`, आदि) के लिए **Compat Adapter Packages** के साथ Intlayer पर माइग्रेशन की राह को आसान बनाने में एक बड़ा मील का पत्थर है, और यह रिच कंटेंट स्ट्रक्चर्स: **Collections** और **Variants** के लिए सपोर्ट जोड़ता है।
+
+## विषय-सूची
+
+<TOC levels={[2]} maxDepth={1} />
+
+---
+
+## Compat Adapter Packages
+
+लोकप्रिय i18n लाइब्रेरीज़ से Intlayer पर माइग्रेट करना अब पहले से कहीं अधिक आसान है। हमने पांच compat पैकेजेस बनाए हैं जो स्टैंडर्ड i18n लाइब्रेरीज़ के समान **exact same public APIs** को एक्सपोज़ करते हैं, लेकिन रनटाइम (runtime) पर सभी ट्रांसलेशन वर्क को Intlayer को सौंप (delegate) देते हैं।
+
+### Strict Typing के साथ समान Public API एक्सपोज़ करें
+
+इंपोर्ट्स (imports) को बदलकर, आप न्यूनतम कोड परिवर्तनों के साथ Intlayer के सभी लाभ (आपके वास्तविक डिक्शनरीज़ के खिलाफ कंपाइल-टाइम टाइप सेफ्टी सहित) प्राप्त कर सकते हैं:
+
+- `@intlayer/i18next`
+- `@intlayer/react-i18next`
+- `@intlayer/next-intl`
+- `@intlayer/react-intl`
+- `@intlayer/next-i18next`
+- `@intlayer/vue-i18n`
+- `@intlayer/lingui`
+
+उदाहरण के लिए, बस इसे बदलें:
+
+```ts
+import { useTranslation } from "react-i18next";
+```
+
+इसमें:
+
+```ts
+import { useTranslation } from "@intlayer/react-i18next";
+```
+
+आपके कीज़ (keys) अब आपके Intlayer डिक्शनरीज़ के खिलाफ **strictly typed** होंगे, जो आपके IDE में पूर्ण dot-path ऑटो-कम्प्लीशन प्रदान करेंगे!
+
+### Bundler Alias Plugins (Vite, Next.js, Turbopack)
+
+बिना अपने सभी इंपोर्ट स्टेटमेंट्स को मैन्युअल रूप से दोबारा लिखे माइग्रेट करने की अनुमति देने के लिए, प्रत्येक compat एडाप्टर पैकेज में `/plugin` सबपाथ के तहत एक **custom bundler plugin** (Vite या Next.js) शामिल है।
+
+ये प्लगइन्स बिल्ड टाइम (build time) पर मौजूदा इंपोर्ट्स (जैसे `react-i18next` या `next-intl`) को उनके `@intlayer/*` समकक्षों में स्वचालित रूप से रीराइट (rewrite) कर देते हैं।
+
+#### Next.js (Webpack / Turbopack) का उदाहरण
+
+`withIntlayer` के बजाय, अपने Next.js कॉन्फ़िगरेशन को compat प्लगइन के साथ रैप करें:
+
+```ts fileName="next.config.ts"
+import { createNextI18nPlugin } from "@intlayer/next-i18next/plugin";
+import type { NextConfig } from "next";
+
+const withIntlayer = createNextI18nPlugin();
+const nextConfig: NextConfig = {};
+
+export default withIntlayer(nextConfig);
+```
+
+#### Vite (React, Vue, Solid, Svelte) का उदाहरण
+
+```ts fileName="vite.config.ts"
+import vueI18nVitePlugin from "@intlayer/vue-i18n/plugin";
+
+export default defineConfig({
+  plugins: [vueI18nVitePlugin()],
+});
+```
+
+---
+
+## Mutualized Runtime Resolver
+
+सभी compat एडाप्टर्स अब ट्रांसलेशन रिज़ॉल्यूशन को एक सिंगल, अत्यधिक ऑप्टिमाइज़्ड रनटाइम पार्सर के माध्यम से रूट करते हैं: `@intlayer/core/messageFormat`।
+
+- **Interpolate Message**: यह स्टैंडर्ड `{{var}}` (whitespace और dot-paths), ICU फॉर्मेटेड आर्ग्युमेंट्स (`{v, number, percent}` आदि), और बेयर `{var}` टेम्पलेट्स को रिज़ॉल्व करता है।
+- **Message Node Resolver**: यह नेस्टेड नोड्स को रिज़ॉल्व करता है: `insert()`, `plural()` (CLDR plural rules), `enu()` (enumeration), `gender()`, HTML टैग्स, एरेज़ (arrays), और कॉलेबल फ़ंक्शन नोड्स।
+- **Tokenized Tag Parser**: यह आउट-ऑफ-द-बॉक्स रिच-टेक्स्ट रेंडरिंग को सक्षम करने के लिए इनलाइन XML/HTML टैग्स और नम्बर्ड टैग्स (जैसे, `<1>children</1>`) का समर्थन करता है।
+
+---
+
+## Feature Spec: Collections & Variants
+
+Intlayer v9 स्टैटिक की-वैल्यू ऑब्जेक्ट्स से आगे बढ़कर डिक्शनरीज़ को डायनेमिक लेआउट स्ट्रक्चर्स घोषित करने की अनुमति देता है जो एंड-टू-एंड पूरी तरह से टाइप्ड (typed) होते हैं।
+
+### 1. Collections
+
+ऑर्डर किए गए आइटम्स की एक CMS-मैनेज्ड सूची परिभाषित करें (जैसे FAQs, प्रोडक्ट्स, या ब्लॉग लिस्ट्स):
+
+```ts fileName="faq.1.content.ts"
+import { t, type Dictionary } from "intlayer";
+
+export default {
+  key: "faq",
+  item: 1,
+  content: {
+    question: t({ en: "What is Intlayer?", fr: "Qu'est-ce qu'Intlayer ?" }),
+    answer: t({ en: "An i18n toolkit.", fr: "Une boîte à outils i18n." }),
+  },
+} satisfies Dictionary;
+```
+
+```ts fileName="faq.2.content.ts"
+import { t, type Dictionary } from "intlayer";
+
+export default {
+  key: "faq",
+  item: 2,
+  content: {
+    question: t({ en: "Is it free?", fr: "Est-ce gratuit ?" }),
+    answer: t({ en: "Yes, open-source.", fr: "Oui, open-source." }),
+  },
+} satisfies Dictionary;
+```
+
+#### उपयोग:
+
+```ts
+// Fetch all items as an array
+const allFaqs = useIntlayer("faq"); // -> { question: string, answer: string }[]
+
+// Fetch a single item by index
+const faq = useIntlayer("faq", { item: 2 }); // -> { question: string, answer: string }
+```
+
+### 2. Variants
+
+A/B टेस्ट्स, सीज़नल हेडर्स, फ़ीचर फ़्लैग्स, या कस्टम लैंडिंग पेजेस डिलीवर करें:
+
+#### स्ट्रिंग वेरिएंट (उदा. A/B टेस्टिंग)
+
+```ts fileName="hero.content.ts"
+import { t, type Dictionary } from "intlayer";
+
+export default {
+  key: "hero-banner",
+  variant: "default",
+  content: {
+    control: t({ hi: "स्वागत है", en: "Welcome", fr: "Bienvenue" }),
+    black_friday: t({
+      hi: "अभी खरीदें",
+      en: "Shop now",
+      fr: "Acheter maintenant",
+    }),
+  },
+} satisfies Dictionary;
+```
+
+#### उपयोग:
+
+```ts
+const banner = useIntlayer("hero-banner", { variant: "black_friday" });
+```
+
+#### ऑब्जेक्ट वेरिएंट (उदा. डायनेमिक रिकॉर्ड्स)
+
+```ts fileName="product.content.ts"
+import { t, type Dictionary } from "intlayer";
+
+export default {
+  key: "product-copy",
+  variant: {
+    id: "prod_123",
+    category: "books",
+  },
+  content: {
+    title: t({ hi: "क्लीन कोड", en: "Clean Code", fr: "Code Propre" }),
+  },
+} satisfies Dictionary;
+```
+
+#### उपयोग:
+
+```ts
+// केवल अनुरोधित आइटम को डायनेमिक रूप से फ़ेच करता है (Suspense की आवश्यकता है)
+const product = useIntlayer("product-copy", {
+  variant: { id: "prod_123", category: "books" },
+});
+```
+
+---
+
+## Dynamic Loading और Bundle Size Optimizations
+
+बंडल्स को बेहद छोटा रखने के लिए, Intlayer v9 डायनेमिक लेज़ी लोडिंग (dynamic lazy loading) का समर्थन करता है।
+
+अपने कॉन्फ़िगरेशन में, `importMode` को `'dynamic'` या `'fetch'` पर सेट करें:
+
+```ts fileName="intlayer.config.ts"
+export default {
+  dictionary: {
+    importMode: "dynamic", // "static" | "dynamic" | "fetch"
+  },
+};
+```
+
+बिल्ड टाइम पर, `@intlayer/swc` और `@intlayer/babel` आपकी फ़ाइलों को स्कैन करते हैं और `useIntlayer` / `getIntlayer` कॉल्स को ट्री-शेकेबल (tree-shakeable) रैपर्स (`useDictionary` / `useDictionaryDynamic`) से बदल देते हैं। केवल चयनित कलेक्शन आइटम, वेरिएंट, या लोकेल के लिए आवश्यक कंटेंट ही लोड किया जाता है, जिससे आपके प्रोडक्शन बंडल में अप्रयुक्त (unused) ट्रांसलेशंस शामिल होने से बच जाते हैं।
+
+---
+
+## Vite Plugin: बंडल्ड Compiler & Proxy
+
+`intlayer()` Vite plugin अब **compiler** और **locale-routing proxy** को सीधे बंडल करता है, इसलिए अधिकांश projects को `vite.config.ts` में केवल एक ही plugin की आवश्यकता है:
+
+```ts fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import { intlayer } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [intlayer()],
+});
+```
+
+- **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` विकल्प
+
+एक नया `routing.enableProxy` विकल्प नियंत्रित करता है कि locale-routing proxy को plug किया गया है या नहीं। यह डिफ़ॉल्ट रूप से `true` होता है। इसे disable करें जब आप locale routing को स्वयं handle करना चाहते हैं:
+
+```ts fileName="intlayer.config.ts"
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  routing: {
+    enableProxy: false, // डिफ़ॉल्ट: true
+  },
+};
+
+export default config;
+```
+
+स्टैंडअलोन `intlayerCompiler()` और `intlayerProxy()` plugins advanced setups के लिए exported रहते हैं। उन्हें `intlayer()` के साथ register करना सुरक्षित है — प्रत्येक plugin स्वयं को deduplicate करता है और केवल एक बार चलता है।
+
+---
+
+## कंपाइलर डिफ़ॉल्ट रूप से अक्षम
+
+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 पॉलीफ़िल्स लागू करता है।
+
+सभी चीज़ें एकल `react-native-intlayer` पैकेज से इम्पोर्ट करें:
+
+```tsx
+import {
+  IntlayerProvider,
+  useIntlayer,
+  useLocale,
+} from "react-native-intlayer";
+```
+
+```bash
+npm install intlayer react-native-intlayer
+```
+
+> `react-intlayer` से इम्पोर्ट करना काम करता रहेगा, लेकिन `react-native-intlayer` अब React Native के लिए अनुशंसित एकल प्रवेश बिंदु है — इसका प्रदाता वे पॉलीफ़िल्स प्रदान करता है जो वेब-उन्मुख `react-intlayer` प्रदाता नहीं करता है।
+
+---
+
+## v8 से माइग्रेशन नोट्स
+
+यदि आप 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 }` शामिल हैं। यदि आपने पहले सीधे लोकेल स्ट्रिंग पास की थी, तो आप अभी भी ऐसा कर सकते हैं, लेकिन उन्नत चयनों (advanced selections) के लिए ऑप्शंस ऑब्जेक्ट का उपयोग करने की अनुशंसा की जाती है।
+
+---
+
+## उपयोगी लिंक्स
+
+- [Compat Adapter Packages Guide](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/compat/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/hi/roadmap.md

@@ -29,6 +29,12 @@ Intlayer एक सामग्री प्रबंधन और अंतर
 
 ---
 
+## विषय-सूची
+
+<TOC/>
+
+---
+
 ## वर्तमान सुविधाएँ
 
 ### 1. सामग्री घोषणा

package/docs/id/autoFill.md

@@ -35,6 +35,26 @@ author: aymericzip
 
 **File deklarasi isi otomatis** dalam CI Anda adalah cara untuk mempercepat alur kerja pengembangan Anda.
 
+## Memahami perilaku
+
+Perintah `fill` mencakup dua mode:
+
+- **Complete**: Secara otomatis mengisi semua konten yang hilang untuk setiap locale dan mengedit file saat ini, atau file lain jika ditentukan. Artinya, mode complete akan melewatkan penerjemahan konten yang sudah ada, jika sudah diterjemahkan.
+- **Review**: Secara otomatis mengisi **semua** konten untuk setiap locale dan menghasilkan untuk file tertentu, atau file lain jika ditentukan.
+
+Perintah will akan memproses semua file deklarasi konten locale Anda. Artinya, tidak akan memproses konten jarak jauh dari CMS. CMS mencakup manajemen terjemahan sendiri.
+Jika Anda menggunakan plugin seperti `@intlayer/sync-json-plugin`, Intlayer akan mengubah file JSON menjadi file deklarasi konten locale. Artinya, file-file tersebut akan diproses oleh perintah `fill`.
+
+File yang baru dihasilkan mencakup instruksi `filled` sebagai metadata kamus. Instruksi ini akan digunakan oleh Intlayer untuk mengetahui apakah file telah diisi secara otomatis atau tidak, dan melewati file ini dari penerjemahan lagi jika ada.
+
+Intlayer juga akan mempertimbangkan instruksi berikut untuk pengisian otomatis:
+
+- Dari `.content.{ts|js|json}` Anda → instruksi `fill`
+- Dari file konfigurasi `.intlayer.config.ts` Anda → instruksi `dictionary.fill`
+- Akan diatur ke `true` secara default sebaliknya
+
+Untuk file deklarasi konten per-locale, instruksi `true` akan diganti dengan `./{{fileName}}.fill.content.json`. Ini karena file deklarasi konten per-locale tidak dapat menerima konten terlokalisasi tambahan. Jadi akan menghasilkan file baru untuk tidak menimpa file yang ada.
+
 ## Perilaku Default
 
 Secara default, `fill` diatur ke `true` secara global, yang berarti Intlayer akan secara otomatis mengisi semua file konten dan mengedit file itu sendiri. Perilaku ini dapat disesuaikan dengan beberapa cara:

package/docs/id/benchmark/solid.md

@@ -118,6 +118,28 @@ Kami membandingkan **empat strategi pemuatan**:
 - **Scoped static**: Menjaga kode tetap teratur (pemisahan logis) tanpa permintaan jaringan ekstra yang kompleks.
 - **Scoped dynamic**: Pendekatan terbaik untuk _code splitting_ dan performa. Meminimalkan memori dengan hanya memuat apa yang dibutuhkan oleh tampilan saat ini dan bahasa yang aktif.
 
+### Apa yang saya ukur:
+
+Saya menjalankan aplikasi multibahasa yang sama di browser nyata untuk setiap stack, kemudian mencatat apa yang benar-benar muncul di wire dan berapa lama waktu yang dibutuhkan. Ukuran dilaporkan **setelah kompresi web normal**, karena itu lebih dekat dengan apa yang orang-orang unduh daripada penghitungan sumber mentah.
+
+- **Ukuran library internationalization**: Setelah bundling, tree-shaking dan minification, ukuran library i18n adalah ukuran providers + hooks/primitives code dalam komponen kosong. Ini tidak termasuk loading file terjemahan. Ini menjawab betapa mahalnya library sebelum konten Anda memasuki gambar.
+
+- **JavaScript per halaman**: Untuk setiap rute benchmark, berapa banyak script yang browser tarik untuk kunjungan itu, rata-rata di seluruh halaman dalam suite (dan di seluruh locale di mana laporan menggabungkannya). Halaman berat adalah halaman lambat.
+
+- **Leakage dari locale lain**: Ini adalah konten halaman yang sama tetapi dalam bahasa lain yang akan dimuat secara tidak disengaja di halaman yang diaudit. Konten ini tidak perlu dan harus dihindari. (mis. konten halaman `/fr/about` dalam bundle halaman `/en/about`)
+
+- **Leakage dari rute lain**: Ide yang sama untuk **layar lain** dalam aplikasi: apakah salinannya berjalan bersama saat Anda hanya membuka satu halaman. (mis. konten halaman `/en/about` dalam bundle halaman `/en/contact`). Skor tinggi menunjukkan splitting yang lemah atau bundle yang terlalu luas.
+
+- **Ukuran bundle komponen rata-rata**: Piece UI umum diukur **satu per satu** alih-alih menyembunyikan dalam satu angka aplikasi raksasa. Ini menunjukkan apakah internationalization diam-diam mengobarkan komponen sehari-hari. Misalnya, jika komponen Anda di-rerender, itu akan memuat semua data itu dari memori. Melampirkan JSON besar ke komponen apa pun seperti menghubungkan toko besar data yang tidak digunakan yang akan memperlambat kinerja komponen Anda.
+
+- **Responsivitas pengalihan bahasa**: Saya membalik bahasa menggunakan kontrol aplikasi sendiri dan mencatat berapa lama waktu yang dibutuhkan sampai halaman jelas beralih, apa yang akan diperhatikan pengunjung, bukan langkah mikro lab.
+
+- **Rendering work setelah perubahan bahasa**: Tindak lanjut yang lebih sempit: berapa banyak upaya yang diambil interface untuk repaint untuk bahasa baru setelah switch dalam penerbangan. Berguna ketika waktu "terasa" dan biaya framework berbeda.
+
+- **Waktu loading halaman awal**: Dari navigasi ke browser mempertimbangkan halaman sepenuhnya dimuat untuk skenario yang saya uji. Baik untuk membandingkan cold start.
+
+- **Waktu hydration**: Ketika aplikasi mengeksposnya, berapa lama client menghabiskan waktu mengubah server HTML menjadi sesuatu yang benar-benar dapat Anda klik. Dash dalam tabel berarti implementasi itu tidak memberikan angka hydration yang andal dalam benchmark ini.
+
 ## Bintang GitHub
 
 Bintang GitHub adalah indikator kuat dari popularitas proyek, kepercayaan komunitas, dan relevansi jangka panjang. Meskipun bukan ukuran langsung dari kualitas teknis, bintang-bintang tersebut mencerminkan berapa banyak pengembang yang menganggap proyek tersebut berguna, mengikuti kemajuannya, dan kemungkinan akan mengadopsinya. Untuk memperkirakan nilai suatu proyek, bintang membantu membandingkan daya tarik di berbagai alternatif dan memberikan wawasan tentang pertumbuhan ekosistem.