@intlayer/docs 9.1.3 → 9.2.0

package/docs/hi/analytics.md

@@ -0,0 +1,222 @@
+---
+createdAt: 2026-07-08
+updatedAt: 2026-07-08
+title: Intlayer Analytics | सामग्री के प्रदर्शन को ट्रैक करें और A/B परीक्षण चलाएं
+description: जानें कि @intlayer/analytics कैसे पेज/लोकेल व्यू और सामग्री के प्रदर्शन को ट्रैक करता है, और अपने Intlayer सामग्री पर A/B परीक्षण चलाने के लिए इसका उपयोग कैसे करें।
+keywords:
+  - Analytics (एनालिटिक्स)
+  - A/B Testing (A/B परीक्षण)
+  - Audience (दर्शक)
+  - Internationalization (अंतर्राष्ट्रीयकरण)
+  - Documentation (दस्तावेज़ीकरण)
+  - Intlayer
+  - Next.js
+  - JavaScript
+  - React
+slugs:
+  - doc
+  - concept
+  - analytics
+history:
+  - version: 9.0.0
+    date: 2026-07-08
+    changes: "Init doc — @intlayer/analytics पैकेज, प्रोवाइडर/नोड-लेवल ट्रैकिंग, A/B परीक्षण, डैशबोर्ड"
+author: aymericzip
+---
+
+# Intlayer Analytics दस्तावेज़ीकरण
+
+`@intlayer/analytics` एक वैकल्पिक सहयोगी पैकेज है जो आपको बताता है कि आपके आगंतुकों को **वास्तव में कौन सी सामग्री दिखाई जा रही है** — कौन सा पृष्ठ, किस लोकेल में, और अनुवादित सामग्री का कौन सा विशिष्ट हिस्सा — ताकि आप अपने दर्शकों को समझ सकें और **सामग्री पर A/B परीक्षण चला सकें**।
+
+## विषय-सूची (Table of Contents)
+
+<TOC/>
+
+---
+
+## यह क्या ट्रैक करता है
+
+`@intlayer/analytics` तीन प्रकार की अनाम घटनाओं को बैच में एकत्रित करता है:
+
+| घटना (Event)       | कहाँ कैप्चर होता है                            | यह आपको क्या बताता है                                                                                                                                       |
+| ------------------ | ---------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `page_view`        | प्रोवाइडर स्तर (`IntlayerProvider`)            | प्रारंभिक लोड, मार्ग (route) परिवर्तन, या लोकेल स्विच पर एक सत्र (session) ने कौन सा पृष्ठ और लोकेल देखा।                                                   |
+| `content_exposure` | नोड स्तर (`useIntlayer` / इंटरप्रेटर प्लगइन्स) | कौन सी डिक्शनरी कुंजी (dictionary key) / कुंजी पथ वास्तव में हल (resolved) और प्रदर्शित किया गया था — और यदि एक प्रयोग का हिस्सा है, तो कौन सा **वेरिएंट**। |
+| `conversion`       | जहाँ भी आप `useConversion()` कॉल करते हैं      | एक लक्ष्य पूरा हुआ (साइनअप, क्लिक, खरीदारी...) जो उस A/B वेरिएंट को जिम्मेदार ठहराया गया है जिसके संपर्क में सत्र आया था।                                   |
+
+घटनाएँ मेमोरी में एकत्रित की जाती हैं और **लगभग हर 20 सेकंड में एक एकल बैच अनुरोध** के रूप में भेजी जाती हैं — प्रत्येक कीस्ट्रोक या रेंडर पर कभी नहीं — इसलिए एनालिटिक्स कभी भी पहले रेंडर के समय को प्रभावित नहीं करता है या प्रति इंटरैक्शन एक अनुरोध नहीं जोड़ता है।
+
+## यह सामग्री पर A/B परीक्षण को कैसे सशक्त बनाता है
+
+Intlayer आपको पहले से ही सामग्री [वेरिएंट (Variants)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/dynamic_dictionaries/index.md) घोषित करने की अनुमति देता है (उदाहरण के लिए `control` और `black_friday` वेरिएंट के साथ एक `hero-banner` डिक्शनरी)। `@intlayer/analytics` इस प्रक्रिया को पूरा करता है:
+
+1. `getVariant(experimentKey, variants)` प्रत्येक अनाम सत्र को निश्चित रूप से एक वेरिएंट सौंपता है — यह सत्र आईडी और प्रयोग कुंजी का एक शुद्ध फ़ंक्शन (pure function) है, इसलिए यह असाइनमेंट **सत्र भर में स्थिर** रहता है और पहले रेंडर से पहले **सर्वर राउंड-ट्रिप** की आवश्यकता नहीं होती है (कोई झिलमिलाहट (flicker) नहीं, कोई लेआउट शिफ्ट नहीं)।
+2. प्रत्येक `content_exposure` घटना उस `variant` को वहन करती है जो दिखाया गया था।
+3. `useConversion()` आपको उस वेरिएंट में एक लक्ष्य (जैसे `"cta_click"`) को जिम्मेदार ठहराने (attribute) की अनुमति देता है।
+4. डैशबोर्ड का प्रयोग परिणाम एंडपॉइंट सांख्यिकीय महत्व (ज़ेड-टेस्ट) सहित प्रति वेरिएंट रूपांतरण दरों (conversion rates) की तुलना करता है।
+
+## इंस्टालेशन (Installation)
+
+`@intlayer/analytics` एक **पीयर (peer), वैकल्पिक** निर्भरता है — यह कभी भी फ्रेमवर्क पैकेज द्वारा स्वचालित रूप से स्थापित नहीं होता है। इसे `intlayer` के साथ जोड़ें:
+
+```bash packageManager="npm"
+npm install @intlayer/analytics
+```
+
+```bash packageManager="yarn"
+yarn add @intlayer/analytics
+```
+
+```bash packageManager="pnpm"
+pnpm add @intlayer/analytics
+```
+
+```bash packageManager="bun"
+bun add @intlayer/analytics
+```
+
+यदि आप इसे स्थापित नहीं करते हैं, तो प्रत्येक एकीकरण बिंदु (integration point) एक नो-ऑप (no-op) के रूप में हल हो जाता है — नीचे [स्थापित न होने पर शून्य लागत](#स्थापित-न-होने-पर-शून्य-लागत) देखें।
+
+## कॉन्फ़िगरेशन (Configuration)
+
+एनालिटिक्स **मौजूदा `editor` कॉन्फ़िगरेशन ब्लॉक का पुन: उपयोग करता है** — भरने के लिए कोई अलग `analytics` कॉन्फ़िगरेशन स्कीमा नहीं है:
+
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  editor: {
+    backendURL: "https://back.intlayer.org", // एनालिटिक्स घटनाओं के लिए अंतर्ग्रहण (ingestion) एंडपॉइंट के रूप में भी उपयोग किया जाता है
+    clientId: "your-client-id", // एनालिटिक्स प्रोजेक्ट कुंजी के रूप में भी उपयोग किया जाता है
+    clientSecret: "your-client-secret",
+  },
+};
+
+export default config;
+```
+
+- `editor.backendURL` — वह बेस URL जहाँ एनालिटिक्स घटनाएँ भेजी जाती हैं (`POST {backendURL}/api/analytics/events`)।
+- `editor.clientId` — प्रत्येक अंतर्ग्रहण घटना के लिए जिम्मेदार सार्वजनिक प्रोजेक्ट कुंजी। यह **सक्षम स्विच (enable switch)** के रूप में भी कार्य करता है: जब तक `clientId` कॉन्फ़िगर नहीं किया जाता है, तब तक एनालिटिक्स पूरी तरह से अक्षम (और ट्री-शेक (tree-shaken), नीचे देखें) रहता है।
+
+यदि आप Intlayer को सेल्फ-होस्ट करते हैं, तो एनालिटिक्स स्वचालित रूप से आपके स्वयं के इंस्टेंस को इंगित करता है क्योंकि यह `editor.backendURL` साझा करता है।
+
+## फ्रेमवर्क सपोर्ट (Framework support)
+
+एनालिटिक्स `react-intlayer` के साझा `IntlayerProvider` में वायर्ड है, इसलिए यह आज हर उस जगह उपलब्ध है जहाँ उस प्रदाता (provider) का उपयोग किया जाता है:
+
+| फ्रेमवर्क                                                | स्थिति (Status)                                                                                                                    |
+| -------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
+| React                                                    | ✅ उपलब्ध                                                                                                                          |
+| Next.js (`next-intlayer`)                                | ✅ उपलब्ध (`react-intlayer` के माध्यम से)                                                                                          |
+| React Native / Expo (`react-native-intlayer`)            | ✅ उपलब्ध (`react-intlayer` के माध्यम से)                                                                                          |
+| Vue, Svelte, Angular, Solid, Preact, Lit, Astro, Vanilla | 🚧 योजनाबद्ध (Planned) — समान क्लाइंट, प्रदाता-स्तर (provider-level) बाइंडिंग `@intlayer/editor` के रिलीज़ पैटर्न का पालन करते हुए |
+
+## उपयोग (Usage)
+
+### स्वचालित प्रोवाइडर-स्तर ट्रैकिंग (Automatic provider-level tracking)
+
+कोड में कोई परिवर्तन आवश्यक नहीं है। एक बार जब `@intlayer/analytics` स्थापित हो जाता है और `editor.clientId` कॉन्फ़िगर हो जाता है, तो `IntlayerProvider` स्वचालित रूप से:
+
+- माउंट होने पर एनालिटिक्स क्लाइंट को इनिशियलाइज़ करता है,
+- प्रारंभिक लोड पर एक `page_view` रिकॉर्ड करता है,
+- हर लोकेल परिवर्तन पर एक `page_view` रिकॉर्ड करता है,
+- ~20 सेकंड का फ्लश लूप शुरू करता है और अनमाउंट/टैब बंद होने पर किसी भी शेष घटनाओं को फ्लश करता है (`navigator.sendBeacon` के माध्यम से, `fetch(..., { keepalive: true })` पर फ़ॉलबैक करते हुए)।
+
+### स्वचालित नोड-स्तर ट्रैकिंग (Automatic node-level tracking)
+
+हर बार जब `useIntlayer` प्रदर्शन के लिए सामग्री के एक टुकड़े को हल करता है, तो इंटरप्रेटर उस सटीक `dictionaryKey` + कुंजी पथ + लोकेल के लिए एक `content_exposure` घटना की रिपोर्ट करता है — फिर से, कोई कोड परिवर्तन आवश्यक नहीं है। फ्लश विंडो (लगभग 20 सेकंड) के भीतर एक ही नोड के दोहराए गए एक्सपोज़र को `count` के साथ एक ही घटना में मिला दिया जाता है (coalesced), इसलिए 50 बार फिर से रेंडर होने वाली सूची 50 घटनाएँ नहीं भेजती है।
+
+### A/B परीक्षण के लिए रूपांतरण ट्रैक करना (Tracking conversions for A/B tests)
+
+उस वेरिएंट को लक्ष्य (goal) सौंपने के लिए `useConversion()` का उपयोग करें जिसे एक सत्र (session) ने देखा था:
+
+```tsx fileName="CTAButton.tsx" codeFormat="tsx"
+import { useConversion } from "react-intlayer";
+
+const CTAButton = () => {
+  const trackConversion = useConversion();
+
+  return (
+    <button
+      onClick={() =>
+        trackConversion({
+          experimentKey: "homepage-hero",
+          variant: "black_friday",
+          goal: "cta_click",
+        })
+      }
+    >
+      शुरू करें (Get started)
+    </button>
+  );
+};
+```
+
+### क्लाइंट-साइड वेरिएंट को हल करना (Resolving a variant client-side)
+
+```tsx fileName="useHeroVariant.ts" codeFormat="tsx"
+import { getGlobalAnalyticsClient } from "@intlayer/analytics/client";
+
+const client = getGlobalAnalyticsClient();
+const variant = client?.getVariant("homepage-hero", [
+  "control",
+  "black_friday",
+]);
+```
+
+## गोपनीयता और प्रदर्शन (Privacy & performance)
+
+- **डिज़ाइन द्वारा अनाम (Anonymous by design)**: सत्र (sessions) एक घूर्णन आईडी (rotating id) द्वारा पहचाने जाते हैं; बैकएंड कभी भी केवल उस आईडी का **SHA-256 हैश** संग्रहीत करता है — कच्चा आईडी (raw id) कभी नहीं, और आईपी (IP) पता कभी नहीं।
+- **स्थान अनुमानित है (Location is coarse)**: केवल एक देश कोड, जिसे CDN जियोलोकेशन हेडर (`cf-ipcountry`, `x-vercel-ip-country`, ...) से प्राप्त किया जाता है — कोई IP पढ़ा या संग्रहीत नहीं किया जाता है।
+- **URL खोज मापदंडों (search params) को बाहर करते हैं** डिफ़ॉल्ट रूप से, इसलिए क्वेरी स्ट्रिंग कभी भी कैप्चर नहीं की जाती हैं।
+- **सैंपलिंग (Sampling)**: `sampleRate` आपको उच्च-ट्रैफ़िक ऐप्स पर सामग्री-एक्सपोज़र घटनाओं का केवल एक अंश (fraction) रखने की अनुमति देता है।
+- **बैचिंग (Batched)**: लगभग हर 20 सेकंड में एक अनुरोध (`flushInterval`), या यदि बफ़र भर जाता है तो पहले (`maxBufferSize`) — प्रति घटना कभी भी एक अनुरोध नहीं।
+
+### स्थापित न होने पर शून्य लागत (Zero-cost when not installed)
+
+`@intlayer/analytics` पूरी तरह से उसी वैकल्पिक-निर्भरता पैटर्न का पालन करता है जैसा कि `@intlayer/editor`:
+
+- प्रत्येक एकीकरण बिंदु पैकेज को **`try/catch` में लिपटे गतिशील (dynamic) `import()`** के माध्यम से लोड करता है — एक ऐप जो कभी भी `@intlayer/analytics` स्थापित नहीं करता है वह बंडल-आकार या रनटाइम लागत का भुगतान नहीं करता है, और कभी कोई त्रुटि नहीं देखता है;
+- एक संकलन-समय (compile-time) पर्यावरण चर (`INTLAYER_ANALYTICS_ENABLED`), जिसे `@intlayer/config` द्वारा स्वचालित रूप से `'false'` पर सेट किया जाता है जब `editor.clientId` कॉन्फ़िगर नहीं किया जाता है, जिससे बंडलर्स पूरे एकीकरण को **मृत-कोड-समाप्त (dead-code-eliminate)** कर सकते हैं;
+- एनालिटिक्स Intlayer संपादक/CMS पूर्वावलोकन (preview) iframe के अंदर अक्षम है, इसलिए संपादक सत्रों को कभी भी वास्तविक ट्रैफ़िक के रूप में नहीं गिना जाता है।
+
+## डैशबोर्ड: एनालिटिक्स पृष्ठ (Dashboard: Analytics page)
+
+एक बार जब आपका प्रोजेक्ट घटनाओं को एकत्र कर लेता है, तो [Intlayer डैशबोर्ड](https://app.intlayer.org/analytics) में **Analytics** पृष्ठ (प्रोजेक्ट का चयन करने के बाद साइडबार में दिखाई देता है) दिखाता है:
+
+- **सक्रिय उपयोगकर्ता (Active users)** — चयनित रोलिंग विंडो (7 / 30 / 90 दिन) में विशिष्ट आगंतुक (distinct visitors)।
+- **आज के उपयोगकर्ता** और **पिछले 7 दिनों में उपयोगकर्ता**।
+- चयनित विंडो के दौरान **पेज व्यू (Page views)**।
+- दैनिक विशिष्ट आगंतुकों का **विकास ग्राफ (Evolution graph)**।
+- **लोकेल्स (Locales)** और **स्थान (Location)** ब्रेकडाउन टैब, जो आपके दर्शकों को लोकेल और देश के अनुसार रैंक करते हैं।
+
+## बैकएंड API संदर्भ (Backend API reference)
+
+सभी रीड एंडपॉइंट्स (read endpoints) के लिए प्रमाणीकरण की आवश्यकता होती है; अंतर्ग्रहण (ingestion) सार्वजनिक है और बॉडी (body) में `clientId` द्वारा जिम्मेदार ठहराया जाता है।
+
+| विधि (Method) | एंडपॉइंट (Endpoint)                         | विवरण (Description)                                                                 |
+| ------------- | ------------------------------------------- | ----------------------------------------------------------------------------------- |
+| `POST`        | `/api/analytics/events`                     | घटनाओं का एक बैच अंतर्ग्रहण करें (सार्वजनिक, बॉडी में `clientId` द्वारा जिम्मेदार)। |
+| `GET`         | `/api/analytics/overview`                   | प्रमाणित प्रोजेक्ट के लिए पृष्ठ/लोकेल का कुल योग।                                   |
+| `GET`         | `/api/analytics/audience?days=30`           | विशिष्ट आगंतुक, पेज व्यू, दैनिक श्रृंखला, लोकेल + देश ब्रेकडाउन।                    |
+| `GET`         | `/api/analytics/content-stats`              | प्रति-सामग्री एक्सपोज़र का कुल योग, डिक्शनरी कुंजी / पथ / लोकेल द्वारा समूहीकृत।    |
+| `GET`         | `/api/analytics/experiments/:experimentKey` | A/B प्रयोग के लिए प्रति-वेरिएंट रूपांतरण दर और सांख्यिकीय महत्व।                    |
+
+आप इन्हें [CMS SDK](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/intlayer_CMS.md) के साथ प्रोग्रामेटिक रूप से भी कॉल कर सकते हैं:
+
+```ts fileName="analytics.ts"
+import { createIntlayerCMS } from "@intlayer/api";
+import { analyticsEndpoint } from "@intlayer/api/analytics";
+
+const cms = createIntlayerCMS();
+
+const { data: audience } = await analyticsEndpoint(cms).getAudience(30);
+```
+
+## उपयोगी कड़ियाँ (Useful links)
+
+- [डायनामिक डिक्शनरीज़ - कलेक्शंस और वेरिएंट्स (Dynamic Dictionaries)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/dynamic_dictionaries/index.md)
+- [Intlayer CMS - CMS SDK](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/intlayer_CMS.md)
+- [Intlayer विज़ुअल एडिटर (Visual Editor)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/intlayer_visual_editor.md)
+- [कॉन्फ़िगरेशन संदर्भ (Configuration Reference)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/configuration.md)
+- [सेल्फ-होस्टिंग गाइड (Self-Hosting Guide)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/self_hosting.md)

package/docs/hi/autoFill.md

@@ -75,11 +75,30 @@ v7 में, `fill` कमांड का व्यवहार अपडे
 
 जब किसी दूसरी फ़ाइल में लिखने के लिए path विकल्प का उपयोग करते हैं, तो fill तंत्र सामग्री घोषणा फ़ाइलों के बीच एक _master-slave_ संबंध के माध्यम से काम करता है। मुख्य (master) फ़ाइल सत्य का स्रोत है, और जब इसे अपडेट किया जाता है, तो Intlayer स्वचालित रूप से उन परिवर्तनों को path द्वारा निर्दिष्ट व्युत्पन्न (भरी गई) घोषणा फ़ाइलों पर लागू करता है।
 
-# ऑटोफिल सामग्री घोषणा फ़ाइल अनुवाद
+### प्रति-लोकेल कस्टमाइज़ेशन
 
-**ऑटोफिल सामग्री घोषणा फ़ाइलें** आपके विकास कार्यप्रवाह को तेज़ करने का एक तरीका हैं।
+आप एक ऑब्जेक्ट का उपयोग करके प्रत्येक लोकेल के लिए व्यवहार को कस्टमाइज़ कर सकते हैं:
 
-ऑटोफिल तंत्र सामग्री घोषणा फ़ाइलों के बीच एक _मास्टर-स्लेव_ संबंध के माध्यम से काम करता है। जब मुख्य (मास्टर) फ़ाइल अपडेट होती है, तो Intlayer स्वचालित रूप से उन परिवर्तनों को व्युत्पन्न (ऑटोफिल की गई) घोषणा फ़ाइलों पर लागू कर देगा।
+```ts fileName="intlayer.config.ts"
+const config: IntlayerConfig = {
+  content: {
+    internationalization: {
+      locales: [Locales.ENGLISH, Locales.FRENCH, Locales.POLISH],
+      defaultLocale: Locales.ENGLISH,
+      requiredLocales: [Locales.ENGLISH], // अनुशंसित है Property 'pl' is missing in type '{ en: string; xxx } on your t function if से बचने के लिए
+    },
+  },
+  dictionary: {
+    fill: {
+      en: true, // अंग्रेजी के लिए वर्तमान फ़ाइल को भरें और संपादित करें
+      fr: "./translations/fr.json", // फ्रेंच के लिए अलग फ़ाइल बनाएं
+      es: false, // स्पैनिश के लिए fill को अक्षम करें
+    },
+  },
+};
+```
+
+यह आपको एक ही प्रोजेक्ट के भीतर विभिन्न लोकेल के लिए विभिन्न fill व्यवहार रखने की अनुमति देता है।
 
 ```ts fileName="src/components/example/example.content.ts"
 import { Locales, type Dictionary } from "intlayer";
@@ -87,18 +106,18 @@ import { Locales, type Dictionary } from "intlayer";
 const exampleContent = {
   key: "example",
   locale: Locales.ENGLISH,
-  autoFill: "./example.content.json",
+  fill: "./example.content.json",
   content: {
-    contentExample: "यह सामग्री का एक उदाहरण है", // सामग्री का उदाहरण
+    contentExample: "यह सामग्री का एक उदाहरण है",
   },
 } satisfies Dictionary;
 
 export default exampleContent;
 ```
 
-यहाँ `autoFill` निर्देश का उपयोग करते हुए एक [प्रति-स्थान सामग्री घोषणा फ़ाइल](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/per_locale_file.md) है।
+यहाँ `fill` instruction का उपयोग करने वाली एक [per-locale content declaration file](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/per_locale_file.md) है।
 
-फिर, जब आप निम्नलिखित कमांड चलाते हैं:
+फिर, जब आप निम्नलिखित आदेश चलाते हैं:
 
 ```bash packageManager="npm"
 npx intlayer fill --file 'src/components/example/example.content.ts'
@@ -116,7 +135,7 @@ pnpm intlayer fill --file 'src/components/example/example.content.ts'
 bun x intlayer fill --file 'src/components/example/example.content.ts'
 ```
 
-Intlayer स्वचालित रूप से व्युत्पन्न घोषणा फ़ाइल `src/components/example/example.content.json` बनाएगा, जिसमें मुख्य फ़ाइल में पहले से घोषित नहीं किए गए सभी स्थानों को भरा जाएगा।
+Intlayer स्वचालित रूप से `src/components/example/example.content.json` पर derived declaration file जेनरेट करेगा, मुख्य फ़ाइल में पहले से घोषित नहीं किए गए सभी लोकेल को भरते हुए।
 
 ```json5 fileName="src/components/example/example.content.json"
 {
@@ -133,7 +152,7 @@ Intlayer स्वचालित रूप से व्युत्पन्
 }
 ```
 
-इसके बाद, दोनों घोषणा फ़ाइलों को एकल शब्दकोश में मर्ज किया जाएगा, जिसे मानक `useIntlayer("example")` हुक (react) / कॉम्पोज़ेबल (vue) का उपयोग करके एक्सेस किया जा सकता है।
+इसके बाद, दोनों declaration files को एक एकल dictionary में मर्ज किया जाएगा, जिसे मानक `useIntlayer("example")` hook (react) / composable (vue) का उपयोग करके एक्सेस किया जा सकता है।
 
 ## Global Configuration
 

package/docs/hi/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-07-11
+updatedAt: 2026-08-06
 title: कॉन्फ़िगरेशन (Configuration)
 description: जानें कि अपने एप्लिकेशन के लिए Intlayer को कैसे कॉन्फ़िगर करें। Intlayer को अपनी आवश्यकताओं के अनुसार अनुकूलित करने के लिए उपलब्ध विभिन्न सेटिंग्स और विकल्पों को समझें।
 keywords:
@@ -14,6 +14,9 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 9.1.3
+    date: 2026-08-06
+    changes: "`routing.enableProxy` को तीन-स्थिति बनाया गया: अनसेट (auto), `true`, `false`"
   - version: 9.0.0
     date: 2026-07-11
     changes: "`analytics` कॉन्फ़िगरेशन जोड़ा गया"
@@ -235,6 +238,19 @@ const config: IntlayerConfig = {
      */
     mode: "prefix-no-default",
 
+    /**
+     * Intlayer लोकेल-रूटिंग प्रॉक्सी (मिडलवेयर) को सक्षम करता है।
+     * dev, preview और SSR में लोकेल पहचान, रीडायरेक्ट और रीराइट संभालता है।
+     * - अनसेट (auto): dev और preview सर्वर कुकीज़ तथा हेडर में संग्रहित लोकेल को
+     *   अनदेखा करके रूटिंग को URL-आधारित रखते हैं। प्रीफ़िक्स अब भी हल होते हैं,
+     *   लोकेल अब भी सहेजा जाता है, और Accept-Language पहचान अब भी लागू होती है।
+     *   प्रोडक्शन में यह `true` जैसा व्यवहार करता है।
+     * - true: हर वातावरण में पूर्ण व्यवहार।
+     * - false: कोई लोकेल रूटिंग नहीं।
+     * डिफ़ॉल्ट: undefined (auto)
+     */
+    enableProxy: undefined,
+
     /**
      * उपयोगकर्ता द्वारा चुने गए लोकेल को कहाँ संग्रहीत करना है।
      * विकल्प: 'cookie', 'localStorage', 'sessionStorage', 'header' या इनका सरणी।
@@ -706,13 +722,14 @@ Intlayer एनालिटिक्स से संबंधित सेट
 
 URL संरचना, लोकेल स्टोरेज और मिडलवेयर प्रबंधन सहित राउटींग व्यवहार को नियंत्रित करने वाली सेटिंग्स।
 
-| फ़ील्ड     | विवरण                                                                                                                                                                                                          | टाइप                                                                                                                                                                                                         | डिफ़ॉल्ट               | उदाहरण                                                                                                                                                                                                   | टिप्पणी                                                                                                                                                                                                                                                                                          |
-| ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `mode`     | लोकेल प्रबंधन के लिए URL राउटींग मोड।                                                                                                                                                                          | `'prefix-no-default'` &#124; <br/> `'prefix-all'` &#124; <br/> `'no-prefix'` &#124; <br/> `'search-params'`                                                                                                  | `'prefix-no-default'`  | `'prefix-no-default'`: `/dashboard` (en) या `/fr/dashboard` (fr)। `'prefix-all'`: `/en/dashboard` । `'no-prefix'`: लोकेल अन्य तरीकों से प्रबंधित किया जाता है। `'search-params'`: `/dashboard?locale=fr` | कुकी प्रबंधन या लोकेल स्टोरेज को प्रभावित नहीं करता है।                                                                                                                                                                                                                                          |
-| `storage`  | क्लाइंट पर लोकेल स्टोरेज का कॉन्फ़िगरेशन।                                                                                                                                                                      | `false` &#124; <br/> `'cookie'` &#124; <br/> `'localStorage'` &#124; <br/> `'sessionStorage'` &#124; <br/> `'header'` &#124; <br/> `CookiesAttributes` &#124; <br/> `StorageAttributes` &#124; <br/> `Array` | `['cookie', 'header']` | `'localStorage'` <br/> `[{ type: 'cookie', name: 'custom-locale', secure: true }]`                                                                                                                       | नीचे स्टोरेज मापदंडों की तालिका देखें।                                                                                                                                                                                                                                                           |
-| `basePath` | एप्लिकेशन URL के लिए बेस पाथ।                                                                                                                                                                                  | `string`                                                                                                                                                                                                     | `''`                   | `'/my-app'`                                                                                                                                                                                              | यदि एप्लिकेशन `https://example.com/my-app` पते पर चलता है, तो basePath `'/my-app'` है और URL `https://example.com/my-app/en` बन जाते हैं।                                                                                                                                                        |
-| `rewrite`  | कस्टम URL पुनर्लेखन नियम जो विशिष्ट पाथ के लिए डिफ़ॉल्ट राउटींग मोड को ओवरराइड करते हैं। गतिशील मापदंडों `[param]` का समर्थन करता है।                                                                          | `Record<string, StrictModeLocaleMap<string>>`                                                                                                                                                                | `undefined`            | नीचे उदाहरण देखें                                                                                                                                                                                        | • पुनर्लेखन नियमों को `mode` पर प्राथमिकता दी जाती है।<br/>• Next.js और Vite के साथ काम करता है।<br/>• `getLocalizedUrl()` स्वचालित रूप से उचित नियमों को लागू करता है।<br/>• [कस्टम URL पुनर्लेखन](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/custom_url_rewrites.md) देखें। |
-| `domains`  | डोमेन-आधारित रूटिंग के लिए लोकेल को डोमेन होस्टनामों से मैप करता है। सेट होने पर, उस लोकेल के लिए URL इस डोमेन को बेस (पूर्ण URL) के रूप में उपयोग करते हैं और पाथ में कोई लोकेल प्रीफिक्स नहीं जोड़ा जाता है। | `Partial<Record<Locale, string>>`                                                                                                                                                                            | `undefined`            | `{ zh: 'intlayer.zh', fr: 'intlayer.org' }`                                                                                                                                                              | • होस्टनाम में शामिल न होने पर डिफ़ॉल्ट प्रोटोकॉल `https://` है।<br/>• डोमेन स्वयं लोकेल की पहचान करता है, इसलिए `/zh/` प्रीफिक्स नहीं जोड़ा जाता है।<br/>• `getLocalizedUrl('/', 'zh')`, `https://intlayer.zh/` लौटाता है।                                                                      |
+| फ़ील्ड        | विवरण                                                                                                                                                                                                          | टाइप                                                                                                                                                                                                         | डिफ़ॉल्ट               | उदाहरण                                                                                                                                                                                                   | टिप्पणी                                                                                                                                                                                                                                                                                                                                                      |
+| ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `mode`        | लोकेल प्रबंधन के लिए URL राउटींग मोड।                                                                                                                                                                          | `'prefix-no-default'` &#124; <br/> `'prefix-all'` &#124; <br/> `'no-prefix'` &#124; <br/> `'search-params'`                                                                                                  | `'prefix-no-default'`  | `'prefix-no-default'`: `/dashboard` (en) या `/fr/dashboard` (fr)। `'prefix-all'`: `/en/dashboard` । `'no-prefix'`: लोकेल अन्य तरीकों से प्रबंधित किया जाता है। `'search-params'`: `/dashboard?locale=fr` | कुकी प्रबंधन या लोकेल स्टोरेज को प्रभावित नहीं करता है।                                                                                                                                                                                                                                                                                                      |
+| `enableProxy` | Intlayer लोकेल-रूटिंग प्रॉक्सी (मिडलवेयर) को सक्षम करता है।                                                                                                                                                    | `boolean` &#124; <br/> `undefined`                                                                                                                                                                           | `undefined` (auto)     | `true`                                                                                                                                                                                                   | • अनसेट (auto): dev और preview सर्वर कुकीज़/हेडर में संग्रहित लोकेल को रीडायरेक्ट स्रोत के रूप में अनदेखा करते हैं; प्रीफ़िक्स, सहेजना और `Accept-Language` पहचान अब भी लागू होती है। प्रोडक्शन में `true` जैसा व्यवहार।<br/>• `true`: हर जगह पूर्ण व्यवहार।<br/>• `false`: कोई लोकेल रूटिंग नहीं। Next.js में `intlayerProxy` मिडलवेयर पास-थ्रू बन जाता है। |
+| `storage`     | क्लाइंट पर लोकेल स्टोरेज का कॉन्फ़िगरेशन।                                                                                                                                                                      | `false` &#124; <br/> `'cookie'` &#124; <br/> `'localStorage'` &#124; <br/> `'sessionStorage'` &#124; <br/> `'header'` &#124; <br/> `CookiesAttributes` &#124; <br/> `StorageAttributes` &#124; <br/> `Array` | `['cookie', 'header']` | `'localStorage'` <br/> `[{ type: 'cookie', name: 'custom-locale', secure: true }]`                                                                                                                       | नीचे स्टोरेज मापदंडों की तालिका देखें।                                                                                                                                                                                                                                                                                                                       |
+| `basePath`    | एप्लिकेशन URL के लिए बेस पाथ।                                                                                                                                                                                  | `string`                                                                                                                                                                                                     | `''`                   | `'/my-app'`                                                                                                                                                                                              | यदि एप्लिकेशन `https://example.com/my-app` पते पर चलता है, तो basePath `'/my-app'` है और URL `https://example.com/my-app/en` बन जाते हैं।                                                                                                                                                                                                                    |
+| `rewrite`     | कस्टम URL पुनर्लेखन नियम जो विशिष्ट पाथ के लिए डिफ़ॉल्ट राउटींग मोड को ओवरराइड करते हैं। गतिशील मापदंडों `[param]` का समर्थन करता है।                                                                          | `Record<string, StrictModeLocaleMap<string>>`                                                                                                                                                                | `undefined`            | नीचे उदाहरण देखें                                                                                                                                                                                        | • पुनर्लेखन नियमों को `mode` पर प्राथमिकता दी जाती है।<br/>• Next.js और Vite के साथ काम करता है।<br/>• `getLocalizedUrl()` स्वचालित रूप से उचित नियमों को लागू करता है।<br/>• [कस्टम URL पुनर्लेखन](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/custom_url_rewrites.md) देखें।                                                             |
+| `domains`     | डोमेन-आधारित रूटिंग के लिए लोकेल को डोमेन होस्टनामों से मैप करता है। सेट होने पर, उस लोकेल के लिए URL इस डोमेन को बेस (पूर्ण URL) के रूप में उपयोग करते हैं और पाथ में कोई लोकेल प्रीफिक्स नहीं जोड़ा जाता है। | `Partial<Record<Locale, string>>`                                                                                                                                                                            | `undefined`            | `{ zh: 'intlayer.zh', fr: 'intlayer.org' }`                                                                                                                                                              | • होस्टनाम में शामिल न होने पर डिफ़ॉल्ट प्रोटोकॉल `https://` है।<br/>• डोमेन स्वयं लोकेल की पहचान करता है, इसलिए `/zh/` प्रीफिक्स नहीं जोड़ा जाता है।<br/>• `getLocalizedUrl('/', 'zh')`, `https://intlayer.zh/` लौटाता है।                                                                                                                                  |
 
 **`rewrite` उदाहरण**:
 

package/docs/hi/dictionary/file.md

@@ -23,7 +23,9 @@ history:
 author: aymericzip
 ---
 
-# फ़ाइल सामग्री / Intlayer में फ़ाइलें एम्बेड करना
+# फाइल कंटेंट / Intlayer में फाइलों को एम्बेड करना
+
+Intlayer में, `file` फ़ंक्शन एक शब्दकोश में बाहरी फाइल कंटेंट को एम्बेड करने की अनुमति देता है। यह दृष्टिकोण सुनिश्चित करता है कि Intlayer स्रोत फाइल को पहचानता है, जिससे Intlayer Visual Editor और CMS के साथ seamless integration संभव हो जाती है।
 
 ## फ़ाइल एम्बेडिंग कैसे काम करता है
 

package/docs/hi/dictionary/nesting.md

@@ -64,6 +64,53 @@ export default firstDictionary;
 }
 ```
 
+### Nest के साथ संदर्भित करना
+
+अब एक और content module बनाएं जो `nest` फ़ंक्शन का उपयोग करके उपरोक्त content को संदर्भित करे। आप संपूर्ण content या किसी विशिष्ट nested value को संदर्भित कर सकते हैं:
+
+```typescript fileName="secondDictionary.content.ts" contentDeclarationFormat={["typescript", "esm", "commonjs"]}
+import { nest, type Dictionary } from "intlayer";
+
+const myNestingContent = {
+  key: "key_of_my_second_dictionary",
+  content: {
+    // संपूर्ण dictionary को संदर्भित करता है:
+    fullNestedContent: nest("key_of_my_first_dictionary"),
+    // किसी विशिष्ट nested value को संदर्भित करता है:
+    partialNestedContent: nest(
+      "key_of_my_first_dictionary",
+      "subContent.contentNumber"
+    ),
+  },
+} satisfies Dictionary;
+
+export default myNestingContent;
+```
+
+```json fileName="secondDictionary.content.json" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "key_of_my_second_dictionary",
+  "content": {
+    "fullNestedContent": {
+      "nodeType": "nested",
+      "nested": {
+        "dictionaryKey": "key_of_my_first_dictionary"
+      }
+    },
+    "partialNestedContent": {
+      "nodeType": "nested",
+      "nested": {
+        "dictionaryKey": "key_of_my_first_dictionary",
+        "path": "subContent.contentNumber"
+      }
+    }
+  }
+}
+```
+
+दूसरे पैरामीटर के रूप में, आप उस content के भीतर किसी nested value का पथ निर्दिष्ट कर सकते हैं। जब कोई पथ प्रदान नहीं किया जाता है, तो संदर्भित dictionary की संपूर्ण content वापस की जाती है।
+
 ## नेस्टिंग सेट करना
 
 <Tabs group="framework">
@@ -258,36 +305,6 @@ document.getElementById("nested")!.textContent = content.partialNestedContent;
   </Tab>
 </Tabs>
 
-## React Intlayer के साथ नेस्टिंग का उपयोग करना
-
-React कंपोनेंट में नेस्टेड सामग्री का उपयोग करने के लिए, `react-intlayer` पैकेज से `useIntlayer` हुक का उपयोग करें। यह हुक निर्दिष्ट कुंजी के आधार पर सही सामग्री प्राप्त करता है। इसका उपयोग करने का एक उदाहरण यहां दिया गया है:
-
-```tsx fileName="**/*.tsx" codeFormat={["typescript", "esm"]}
-import type { FC } from "react";
-import { useIntlayer } from "react-intlayer";
-
-const NestComponent: FC = () => {
-  const { fullNestedContent, partialNestedContent } = useIntlayer(
-    "key_of_my_second_dictionary"
-  );
-
-  return (
-    <div>
-      <p>
-        Full Nested Content: {JSON.stringify(fullNestedContent)}
-        {/* आउटपुट: {"content": "content", "subContent": {"contentNumber": 0, "contentString": "string"}} */}
-      </p>
-      <p>
-        Partial Nested Value: {partialNestedContent}
-        {/* आउटपुट: 0 */}
-      </p>
-    </div>
-  );
-};
-
-export default NestComponent;
-```
-
 ## अतिरिक्त संसाधन
 
 कॉन्फ़िगरेशन और उपयोग पर अधिक विस्तृत जानकारी के लिए, निम्नलिखित संसाधनों का संदर्भ लें: