@intlayer/docs 7.3.3 → 7.3.4

package/blog/hi/compiler_vs_declarative_i18n.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2025-11-24
 updatedAt: 2025-11-24
-title: कंपाइलर बनाम घोषणात्मक i18n
-description: '"मैजिक" कंपाइलर-आधारित अंतरराष्ट्रीयकरण और स्पष्ट घोषणात्मक सामग्री प्रबंधन के बीच वास्तुशिल्पीय ट्रेड-ऑफ का अन्वेषण।'
+title: "कंपाइलर बनाम घोषणात्मक i18n"
+description: '"मैजिक" कंपाइलर-आधारित अंतरराष्ट्रीयकरण और स्पष्ट घोषणात्मक सामग्री प्रबंधन के बीच वास्तुशिल्पीय ट्रेड-ऑफ़ का अन्वेषण।'
 keywords:
   - Intlayer
   - अंतरराष्ट्रीयकरण
@@ -20,118 +20,201 @@ slugs:
 
 # कंपाइलर-आधारित i18n के पक्ष और विपक्ष
 
-यदि आप एक दशक से अधिक समय से वेब एप्लिकेशन बना रहे हैं, तो आप जानते हैं कि अंतरराष्ट्रीयकरण (i18n) हमेशा एक संघर्ष का बिंदु रहा है। यह अक्सर वह कार्य होता है जिसे कोई करना नहीं चाहता — स्ट्रिंग्स निकालना, JSON फ़ाइलों का प्रबंधन करना, और बहुवचन नियमों की चिंता करना।
+यदि आप एक दशक से अधिक समय से वेब एप्लिकेशन बना रहे हैं, तो आप जानते हैं कि अंतरराष्ट्रीयकरण (i18n) हमेशा एक संघर्ष का बिंदु रहा है। यह अक्सर वह कार्य होता है जिसे कोई करना नहीं चाहता — स्ट्रिंग्स निकालना, JSON फाइलों का प्रबंधन करना, और बहुवचन नियमों की चिंता करना।
 
-हाल ही में, "कंपाइलर-आधारित" i18n टूल्स की एक नई लहर उभरी है, जो इस दर्द को गायब करने का वादा करती है। प्रस्तुति आकर्षक है: **बस अपने कंपोनेंट्स में टेक्स्ट लिखें, और बाकी काम बिल्ड टूल पर छोड़ दें।** न कोई कीज़, न कोई इम्पोर्ट्स, बस जादू।
+हाल ही में, **"कंपाइलर-आधारित" i18n टूल्स** की एक नई लहर उभरी है, जो इस दर्द को गायब करने का वादा करती है। प्रस्ताव आकर्षक है: **बस अपने कंपोनेंट्स में टेक्स्ट लिखें, और बाकी काम बिल्ड टूल पर छोड़ दें।** न कोई कीज़, न कोई इम्पोर्ट्स, बस जादू।
 
 लेकिन सॉफ़्टवेयर इंजीनियरिंग में सभी अमूर्तताओं की तरह, जादू की भी एक कीमत होती है।
 
-इस ब्लॉग पोस्ट में, हम घोषणात्मक लाइब्रेरीज से कंपाइलर-आधारित दृष्टिकोण की ओर हुए बदलाव, उनके द्वारा लाए गए छिपे हुए वास्तुशिल्पीय ऋण, और क्यों "निरस" तरीका अभी भी पेशेवर एप्लिकेशन के लिए सबसे अच्छा तरीका हो सकता है, का अन्वेषण करेंगे।
+इस ब्लॉग पोस्ट में, हम घोषणात्मक लाइब्रेरीज़ से कंपाइलर-आधारित दृष्टिकोणों की ओर बदलाव, उनके द्वारा लाए गए छिपे हुए वास्तुशिल्पीय ऋणों, और क्यों "निरस" तरीका अभी भी पेशेवर एप्लिकेशन के लिए सबसे अच्छा तरीका हो सकता है, का अन्वेषण करेंगे।
 
-## अनुवाद का संक्षिप्त इतिहास
+## विषय सूची
 
-यह समझने के लिए कि हम कहां हैं, हमें यह देखना होगा कि हमने कहां से शुरुआत की थी।
+<TOC/>
 
-2011–2012 के आसपास, JavaScript का परिदृश्य काफी अलग था। जैसे हम आज जानते हैं, वे बंडलर्स (Webpack, Vite) मौजूद नहीं थे या वे अपने प्रारंभिक चरण में थे। हम ब्राउज़र में स्क्रिप्ट्स को जोड़ रहे थे। इसी युग में, **i18next** जैसी लाइब्रेरीज का जन्म हुआ।
+## अंतरराष्ट्रीयकरण का संक्षिप्त इतिहास
+
+यह समझने के लिए कि हम कहाँ हैं, हमें यह देखना होगा कि हमने कहाँ से शुरुआत की थी।
+
+2011–2012 के आसपास, JavaScript का परिदृश्य काफी अलग था। जैसे हम आज जानते हैं, वे बंडलर्स (Webpack, Vite) मौजूद नहीं थे या वे अपने शुरुआती दौर में थे। हम ब्राउज़र में स्क्रिप्ट्स को जोड़ रहे थे। इसी युग में, **i18next** जैसी लाइब्रेरीज़ का जन्म हुआ।
 
 उन्होंने उस समय संभव唯一 तरीके से समस्या का समाधान किया: **रनटाइम डिक्शनरीज़**। आप एक विशाल JSON ऑब्जेक्ट मेमोरी में लोड करते थे, और एक फ़ंक्शन तुरंत कीज़ को खोजता था। यह विश्वसनीय, स्पष्ट था, और हर जगह काम करता था।
 
-आज की ओर तेजी से बढ़ें। हमारे पास शक्तिशाली कंपाइलर हैं (SWC, Rust-आधारित बंडलर्स) जो Abstract Syntax Trees (AST) को मिलीसेकंड में पार्स कर सकते हैं। इस शक्ति ने एक नया विचार जन्म दिया: _हम मैन्युअली कीज़ क्यों प्रबंधित कर रहे हैं? क्यों कंपाइलर सीधे "Hello World" टेक्स्ट को देख कर हमारे लिए बदल नहीं सकता?_
+आज के समय में तेजी से आगे बढ़ें। हमारे पास शक्तिशाली कंपाइलर हैं (SWC, Rust-आधारित बंडलर्स) जो Abstract Syntax Trees (AST) को मिलीसेकंड में पार्स कर सकते हैं। इस शक्ति ने एक नया विचार जन्म दिया: _हम मैन्युअली कीज़ क्यों प्रबंधित कर रहे हैं? क्यों कंपाइलर सीधे "Hello World" टेक्स्ट को देख कर उसे हमारे लिए स्वैप नहीं कर सकता?_
 
 इस प्रकार, कंपाइलर-आधारित i18n का जन्म हुआ।
 
+> **कंपाइलर-आधारित i18n का उदाहरण:**
+>
+> - Paraglide (Tree-shaken मॉड्यूल जो प्रत्येक संदेश को एक छोटे ESM फ़ंक्शन में कंपाइल करते हैं ताकि बंडलर्स स्वचालित रूप से अप्रयुक्त लोकल और कीज़ को हटा सकें। आप संदेशों को स्ट्रिंग-की लुकअप करने के बजाय फ़ंक्शंस के रूप में इम्पोर्ट करते हैं।)
+> - LinguiJS (मैक्रो-से-फ़ंक्शन कंपाइलर जो `<Trans>` जैसे मैसेज मैक्रोज़ को बिल्ड समय पर साधारण JS फ़ंक्शन कॉल में पुनः लिखता है। आपको ICU/MessageFormat सिंटैक्स मिलता है जिसमें बहुत छोटा रनटाइम फुटप्रिंट होता है।)
+> - Lingo.dev (लोकलाइज़ेशन पाइपलाइन को स्वचालित करने पर केंद्रित है, जो आपके React एप्लिकेशन के बिल्ड के दौरान सीधे अनुवादित सामग्री इंजेक्ट करता है। यह AI का उपयोग करके स्वचालित रूप से अनुवाद उत्पन्न कर सकता है और सीधे CI/CD में एकीकृत हो सकता है।)
+> - Wuchale (Svelte-प्रथम प्रीप्रोसेसर जो .svelte फ़ाइलों में इनलाइन टेक्स्ट निकालता है और इसे ज़ीरो-रैपर ट्रांसलेशन फ़ंक्शंस में कंपाइल करता है। यह स्ट्रिंग कीज़ से बचता है, और कंटेंट एक्सट्रैक्शन लॉजिक को मुख्य एप्लिकेशन रनटाइम से पूरी तरह अलग करता है।)
+> - Intlayer (कंपाइलर / Extract CLI जो आपके कंपोनेंट्स को पार्स करता है, टाइप्ड डिक्शनरीज़ जनरेट करता है, और वैकल्पिक रूप से कोड को पुनः लिख सकता है ताकि स्पष्ट Intlayer कंटेंट का उपयोग किया जा सके। लक्ष्य है कंपाइलर का उपयोग गति के लिए करना जबकि एक डिक्लेरेटिव, फ्रेमवर्क-एग्नॉस्टिक कोर बनाए रखना।)
+>
+> **डिक्लेरेटिव i18n का उदाहरण:**
+>
+> - i18next / react-i18next / next-i18next (परिपक्व उद्योग मानक जो रनटाइम JSON डिक्शनरीज़ और एक व्यापक प्लगइन इकोसिस्टम का उपयोग करता है)
+> - react-intl (FormatJS लाइब्रेरी का हिस्सा, जो मानक ICU संदेश सिंटैक्स और सख्त डेटा फॉर्मेटिंग पर केंद्रित है)
+> - next-intl (विशेष रूप से Next.js के लिए अनुकूलित, App Router और React Server Components के साथ एकीकरण के साथ)
+> - vue-i18n / @nuxt/i18n (मानक Vue इकोसिस्टम समाधान जो कंपोनेंट-स्तर के अनुवाद ब्लॉक्स और कड़ी प्रतिक्रियाशीलता एकीकरण प्रदान करता है)
+> - svelte-i18n (Svelte स्टोर्स के चारों ओर एक हल्का रैपर जो प्रतिक्रियाशील, रनटाइम अनुवाद के लिए है)
+> - angular-translate (विरासत गतिशील अनुवाद लाइब्रेरी जो रनटाइम की लुकअप पर निर्भर करती है बजाय बिल्ड-टाइम मर्जिंग के)
+> - angular-i18n (Angular की मूल, अग्रिम-समय विधि जो XLIFF फ़ाइलों को सीधे टेम्पलेट्स में बिल्ड के दौरान मर्ज करती है)
+> - Tolgee (घोषणात्मक कोड को एक इन-कॉन्टेक्स्ट SDK के साथ संयोजित करता है जो UI में सीधे "क्लिक-टू-ट्रांसलेट" संपादन की सुविधा देता है)
+> - Intlayer (प्रति-कंपोनेंट दृष्टिकोण, कंटेंट घोषणा फ़ाइलों का उपयोग करता है जो नेटिव ट्री-शेकिंग और TypeScript सत्यापन सक्षम करता है)
+
+## Intlayer कंपाइलर
+
+हालांकि **Intlayer** एक ऐसा समाधान है जो मूल रूप से आपके कंटेंट के लिए एक **घोषणात्मक दृष्टिकोण** को प्रोत्साहित करता है, इसमें विकास को तेज करने या त्वरित प्रोटोटाइपिंग की सुविधा देने के लिए एक कंपाइलर शामिल है।
+
+Intlayer कंपाइलर आपके React, Vue, या Svelte कंपोनेंट्स के AST (Abstract Syntax Tree) के साथ-साथ अन्य JavaScript/TypeScript फ़ाइलों को पार करता है। इसका कार्य हार्डकोडेड स्ट्रिंग्स का पता लगाना और उन्हें समर्पित `.content` घोषणाओं में निकालना है।
+
+> अधिक विवरण के लिए, दस्तावेज़ देखें: [Intlayer Compiler Docs](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/compiler.md)
+
 ## कंपाइलर का आकर्षण (The "Magic" Approach)
 
-इस नए दृष्टिकोण के ट्रेंड में आने का एक कारण है। एक डेवलपर के लिए, यह अनुभव अविश्वसनीय लगता है।
+इस नए दृष्टिकोण के ट्रेंड में आने का एक कारण है। एक डेवलपर के लिए, अनुभव अविश्वसनीय लगता है।
 
 ### 1. गति और "फ्लो"
 
-जब आप काम में डूबे होते हैं, तो एक वेरिएबल नाम (`home_hero_title_v2`) सोचने के लिए रुकना आपके फ्लो को तोड़ देता है। कंपाइलर दृष्टिकोण के साथ, आप `<p>Welcome back</p>` टाइप करते हैं और आगे बढ़ते रहते हैं। कोई रुकावट नहीं होती।
+जब आप पूरी तरह से काम में लगे होते हैं, तो एक सेमांटिक वेरिएबल नाम (`home_hero_title_v2`) सोचने के लिए रुकना आपके फ्लो को तोड़ देता है। कंपाइलर दृष्टिकोण के साथ, आप `<p>Welcome back</p>` टाइप करते हैं और आगे बढ़ते रहते हैं। कोई रुकावट नहीं होती।
 
 ### 2. विरासत बचाव मिशन
 
-कल्पना करें कि आपको 5,000 कंपोनेंट्स वाला एक विशाल कोडबेस विरासत में मिला है जिसमें कोई अनुवाद नहीं है। इसे मैन्युअल की-आधारित सिस्टम से अनुकूलित करना महीनों लंबा दुःस्वप्न होगा। एक कंपाइलर-आधारित टूल एक बचाव रणनीति के रूप में काम करता है, जो बिना किसी फाइल को मैन्युअली छुए तुरंत हजारों स्ट्रिंग्स निकाल देता है।
+कल्पना करें कि आपको 5,000 कंपोनेंट्स वाला एक विशाल कोडबेस विरासत में मिला है जिसमें कोई अनुवाद नहीं है। इसे मैनुअल की-आधारित सिस्टम से अनुकूलित करना महीनों लंबा दुःस्वप्न हो सकता है। एक कंपाइलर-आधारित टूल एक बचाव रणनीति के रूप में काम करता है, जो बिना आपको एक भी फाइल मैन्युअली छुए हजारों स्ट्रिंग्स को तुरंत निकाल देता है।
 
 ### 3. एआई युग
 
-यह एक आधुनिक लाभ है जिसे हमें नजरअंदाज नहीं करना चाहिए। AI कोडिंग असिस्टेंट्स (जैसे Copilot या ChatGPT) स्वाभाविक रूप से मानक JSX/HTML उत्पन्न करते हैं। वे आपके विशिष्ट अनुवाद कुंजी स्कीमा को नहीं जानते।
+यह एक आधुनिक लाभ है जिसे हमें नजरअंदाज नहीं करना चाहिए। एआई कोडिंग असिस्टेंट्स (जैसे Copilot या ChatGPT) स्वाभाविक रूप से मानक JSX/HTML उत्पन्न करते हैं। वे आपके विशिष्ट अनुवाद कुंजी स्कीमा को नहीं जानते।
 
-- **Declarative:** आपको AI के आउटपुट को फिर से लिखना होता है ताकि टेक्स्ट को कुंजियों से बदला जा सके।
-- **Compiler:** आप AI का कोड कॉपी-पेस्ट करते हैं, और यह बस काम करता है।
+- **घोषणात्मक:** आपको एआई के आउटपुट को फिर से लिखना होता है ताकि टेक्स्ट को कुंजियों से बदला जा सके।
+- **कंपाइलर:** आप एआई का कोड कॉपी-पेस्ट करते हैं, और यह बस काम करता है।
 
 ## वास्तविकता जांच: क्यों "मैजिक" खतरनाक है
 
-जबकि "मैजिक" आकर्षक है, लेकिन अमूर्तता लीक होती है। एक बिल्ड टूल पर मानव इरादे को समझने के लिए निर्भर रहना वास्तुशिल्पीय कमजोरी लाता है।
+जबकि "मैजिक" आकर्षक है, लेकिन अमूर्तन में रिसाव होता है। एक बिल्ड टूल पर मानव इरादे को समझने के लिए निर्भर रहना वास्तुकला की नाजुकता को जन्म देता है।
+
+### हीयूरिस्टिक नाजुकता (अनुमान लगाने का खेल)
+
+कंपाइलर को यह अनुमान लगाना पड़ता है कि क्या कंटेंट है और क्या कोड है। इससे ऐसे किनारे के मामले उत्पन्न होते हैं जहां आप टूल के साथ "लड़ाई" करते हैं।
+
+इन परिदृश्यों पर विचार करें:
 
-### 1. हीयूरिस्टिक कमजोरी (अनुमान लगाने का खेल)
+- क्या `<span className="active"></span>` निकाला जाता है? (यह एक स्ट्रिंग है, लेकिन संभवतः एक क्लास है)।
+- क्या `<span status="pending"></span>` निकाला जाता है? (यह एक प्रॉप वैल्यू है)।
+- क्या `<span>{"Hello World"}</span>` निकाला जाता है? (यह एक JS एक्सप्रेशन है)।
+- क्या `<span>Hello {name}. How are you?</span>` निकाला जाता है? (इंटरपोलेशन जटिल है)।
+- क्या `<span aria-label="Image of cat"></span>` निकाला जाता है? (एक्सेसिबिलिटी एट्रिब्यूट्स का अनुवाद आवश्यक है)।
+- क्या `<span data-testid="my-element"></span>` निकाला जाता है? (टेस्ट आईडी का अनुवाद नहीं किया जाना चाहिए)।
+- क्या `<MyComponent errorMessage="An error occurred" />` निकाला जाता है?
+- क्या `<p>This is a paragraph{" "}\n containing multiple lines</p>` निकाला जाता है?
+- क्या `<p>{getStatusMessage()}</p>` फ़ंक्शन परिणाम निकाला जाता है?
+- क्या `<div>{isLoading ? "The page is loading" : <MyComponent/>} </div>` निकाला जाता है?
+- क्या `<span>AX-99</span>` जैसे प्रोडक्ट आईडी को निकाला जाता है?
 
-कंपाइलर को यह अनुमान लगाना होता है कि क्या कंटेंट है और क्या कोड है।
+आप अंततः विशिष्ट टिप्पणियाँ जोड़ने लगते हैं (जैसे `// ignore-translation`, या विशिष्ट प्रॉप्स जैसे `data-compiler-ignore="true"`) ताकि यह आपकी एप्लिकेशन लॉजिक को तोड़ने से रोका जा सके।
 
-- क्या `className="active"` का अनुवाद होता है? यह एक स्ट्रिंग है।
-- क्या `status="pending"` का अनुवाद होता है?
-- क्या `<MyComponent errorMessage="An error occurred" />` का अनुवाद होता है?
-- क्या `"AX-99"` जैसे उत्पाद आईडी का अनुवाद होता है?
+### Intlayer इस जटिलता को कैसे संभालता है?
 
-आप अंततः "कंपाइलर से लड़ते" हुए पाएंगे, विशिष्ट टिप्पणियाँ (जैसे `// ignore-translation`) जोड़कर ताकि यह आपकी एप्लिकेशन लॉजिक को तोड़ने से रोका जा सके।
+Intlayer यह पता लगाने के लिए एक मिश्रित दृष्टिकोण का उपयोग करता है कि किसी फ़ील्ड को अनुवाद के लिए निकाला जाना चाहिए या नहीं, और गलत सकारात्मक परिणामों को कम करने का प्रयास करता है:
 
-### 2. डायनेमिक डेटा की कठोर सीमा
+1.  **AST विश्लेषण:** यह तत्व के प्रकार की जांच करता है (जैसे, `reactNode`, `label`, या `title` prop के बीच अंतर करना)।
+2.  **पैटर्न पहचान:** यह पता लगाता है कि क्या स्ट्रिंग कैपिटलाइज़्ड है या इसमें स्पेस शामिल हैं, जो यह सुझाव देता है कि यह संभवतः मानव-पठनीय टेक्स्ट है न कि कोड पहचानकर्ता।
+
+### डायनेमिक डेटा हार्ड लिमिट
 
 कंपाइलर निष्कर्षण **स्थैतिक विश्लेषण** पर निर्भर करता है। इसे आपके कोड में सटीक स्ट्रिंग देखनी होती है ताकि एक स्थिर ID बनाई जा सके।
-यदि आपका API `server_error` जैसे त्रुटि कोड स्ट्रिंग लौटाता है, तो आप इसे कंपाइलर के साथ अनुवादित नहीं कर सकते क्योंकि कंपाइलर को बिल्ड समय पर उस स्ट्रिंग के अस्तित्व का पता नहीं होता। आपको डायनेमिक डेटा के लिए एक द्वितीयक "रनटाइम-केवल" सिस्टम बनाना पड़ता है।
+यदि आपका API एक त्रुटि कोड स्ट्रिंग जैसे `server_error` लौटाता है, तो आप इसे कंपाइलर के साथ अनुवादित नहीं कर सकते क्योंकि कंपाइलर को बिल्ड समय पर उस स्ट्रिंग के अस्तित्व का पता नहीं होता है। आपको गतिशील डेटा के लिए एक द्वितीयक "केवल रनटाइम" सिस्टम बनाना होगा।
+
+### चंकिंग की कमी
+
+कुछ कंपाइलर पृष्ठ के अनुसार अनुवादों को चंक नहीं करते हैं। यदि आपका कंपाइलर प्रति भाषा एक बड़ा JSON फ़ाइल उत्पन्न करता है (जैसे, `./lang/en.json`, `./lang/fr.json`, आदि), तो आप संभवतः एक ही विज़िट किए गए पृष्ठ के लिए आपकी सभी पृष्ठों की सामग्री लोड कर लेंगे। इसके अलावा, आपकी सामग्री का उपयोग करने वाला प्रत्येक घटक संभवतः आवश्यक से कहीं अधिक सामग्री के साथ हाइड्रेट होगा, जिससे प्रदर्शन संबंधी समस्याएं हो सकती हैं।
+
+अपने अनुवादों को गतिशील रूप से लोड करने में भी सावधानी बरतें। यदि ऐसा नहीं किया गया, तो आप वर्तमान भाषा के अलावा सभी भाषाओं के लिए सामग्री लोड कर लेंगे।
+
+> समस्या को समझाने के लिए, एक साइट पर विचार करें जिसमें 10 पेज और 10 भाषाएँ हों (सभी 100% अद्वितीय)। आप 99 अतिरिक्त पेजों की सामग्री लोड करेंगे (10 × 10 - 1)।
+
+### "चंक विस्फोट" और नेटवर्क वॉटरफॉल
 
-### 3. "चंक विस्फोट" और नेटवर्क वॉटरफॉल्स
+चंकिंग समस्या को हल करने के लिए, कुछ समाधान प्रत्येक कंपोनेंट या यहां तक कि प्रत्येक कुंजी के लिए चंकिंग प्रदान करते हैं। फिर भी समस्या केवल आंशिक रूप से हल होती है। इन समाधानों का मुख्य विक्रय बिंदु अक्सर यह होता है कि "आपकी सामग्री ट्री-शेक की गई है।"
 
-ट्री-शेकिंग की अनुमति देने के लिए, कंपाइलर टूल अक्सर अनुवादों को प्रत्येक कंपोनेंट के अनुसार विभाजित करते हैं।
+वास्तव में, यदि आप सामग्री को स्थैतिक रूप से लोड करते हैं, तो आपका समाधान अप्रयुक्त सामग्री को ट्री-शेक करेगा, लेकिन फिर भी आपकी एप्लिकेशन के साथ सभी भाषाओं की सामग्री लोड हो जाएगी।
 
-- **परिणाम:** 50 छोटे कंपोनेंट्स वाली एक ही पेज व्यू में **50 अलग-अलग HTTP अनुरोध** हो सकते हैं छोटे अनुवाद खंडों के लिए। HTTP/2 के बावजूद, यह एक नेटवर्क वॉटरफॉल बनाता है जो आपकी एप्लिकेशन को एकल, अनुकूलित भाषा बंडल की तुलना में धीमा महसूस कराता है।
+तो इसे गतिशील रूप से क्यों न लोड किया जाए? हाँ, उस स्थिति में आप आवश्यक सामग्री से अधिक लोड करेंगे, लेकिन इसके बिना कुछ समझौते नहीं हैं।
 
-### 4. रनटाइम प्रदर्शन ओवरहेड
+सामग्री को गतिशील रूप से लोड करने से प्रत्येक सामग्री का टुकड़ा अपने स्वयं के चंक में अलग हो जाता है, जिसे केवल तब लोड किया जाएगा जब कंपोनेंट रेंडर होगा। इसका मतलब है कि आप प्रत्येक टेक्स्ट ब्लॉक के लिए एक HTTP अनुरोध करेंगे। आपके पेज पर 1,000 टेक्स्ट ब्लॉक हैं? → आपके सर्वरों को 1,000 HTTP अनुरोध। और नुकसान को सीमित करने और आपके एप्लिकेशन के पहले रेंडर समय को अनुकूलित करने के लिए, आपको कई Suspense सीमाओं या Skeleton Loaders को सम्मिलित करना होगा।
 
-अनुवादों को प्रतिक्रियाशील बनाने के लिए (ताकि जब आप भाषाएँ बदलें तो वे तुरंत अपडेट हों), कंपाइलर अक्सर _हर_ कंपोनेंट में स्टेट मैनेजमेंट हुक्स इंजेक्ट करता है।
+> नोट: Next.js और SSR के साथ भी, आपके कंपोनेंट लोड होने के बाद हाइड्रेट किए जाएंगे, इसलिए HTTP अनुरोध अभी भी किए जाएंगे।
 
-- **लागत:** यदि आप 5,000 आइटम की एक सूची रेंडर करते हैं, तो आप केवल टेक्स्ट के लिए 5,000 `useState` और `useEffect` हुक्स इनिशियलाइज़ कर रहे हैं। यह मेमोरी और CPU चक्रों को खपत करता है, जिन्हें डिक्लेरेटिव लाइब्रेरीज़ (जो आमतौर पर एकल Context प्रोवाइडर का उपयोग करती हैं) बचाती हैं।
+समाधान? एक ऐसा समाधान अपनाना जो स्कोप्ड कंटेंट डिक्लेरेशन की अनुमति देता हो, जैसे कि `i18next`, `next-intl`, या `intlayer` करता है।
+
+> नोट: `i18next` और `next-intl` आपको प्रत्येक पेज के लिए अपने namespace / messages आयातों को मैन्युअली प्रबंधित करने की आवश्यकता होती है ताकि आपके बंडल का आकार अनुकूलित हो सके। आपको एक बंडल एनालाइज़र का उपयोग करना चाहिए जैसे कि `rollup-plugin-visualizer` (vite), `@next/bundle-analyzer` (next.js), या `webpack-bundle-analyzer` (React CRA / Angular / आदि) यह पता लगाने के लिए कि क्या आप अपने बंडल को अप्रयुक्त अनुवादों से प्रदूषित कर रहे हैं।
+
+### रनटाइम प्रदर्शन ओवरहेड
+
+अनुवादों को प्रतिक्रियाशील बनाने के लिए (ताकि जब आप भाषा बदलें तो वे तुरंत अपडेट हो जाएं), कंपाइलर अक्सर प्रत्येक कॉम्पोनेंट में स्टेट मैनेजमेंट हुक्स इंजेक्ट करता है।
+
+- **लागत:** यदि आप 5,000 आइटम की एक सूची रेंडर करते हैं, तो आप केवल टेक्स्ट के लिए 5,000 `useState` और `useEffect` हुक्स इनिशियलाइज़ कर रहे हैं। React को सभी 5,000 कंज्यूमर्स को एक साथ पहचानना और पुनः रेंडर करना होता है। इससे एक बड़ा "Main Thread" ब्लॉक होता है, जो स्विच के दौरान UI को फ्रीज कर देता है। यह मेमोरी और CPU साइकल्स को खपत करता है, जिन्हें डिक्लेरेटिव लाइब्रेरीज़ (जो आमतौर पर एकल Context प्रोवाइडर का उपयोग करती हैं) बचाती हैं।
+
+> ध्यान दें कि यह समस्या React के अलावा अन्य फ्रेमवर्क्स के लिए भी समान है।
 
 ## जाल: विक्रेता लॉक-इन
 
-यह संभवतः कंपाइलर-आधारित i18n का सबसे खतरनाक पहलू है।
+ऐसे i18n समाधान का चयन करते समय सावधान रहें जो अनुवाद कुंजियों के निष्कर्षण या माइग्रेशन की अनुमति देता हो।
+
+डिक्लेरेटिव लाइब्रेरी के मामले में, आपका स्रोत कोड स्पष्ट रूप से आपके अनुवाद इरादे को दर्शाता है: ये आपके कीज़ हैं, और आप इन्हें नियंत्रित करते हैं। यदि आप लाइब्रेरी बदलना चाहते हैं, तो आमतौर पर आपको केवल इम्पोर्ट को अपडेट करना होता है।
 
-एक डिक्लेरेटिव लाइब्रेरी में, आपके स्रोत कोड में स्पष्ट इरादा होता है। आप कुंजियों के मालिक होते हैं। यदि आप लाइब्रेरी बदलते हैं, तो आप केवल इम्पोर्ट बदलते हैं।
+कंपाइलर दृष्टिकोण के साथ, आपका स्रोत कोड केवल सामान्य अंग्रेज़ी टेक्स्ट हो सकता है, जिसमें अनुवाद लॉजिक का कोई निशान नहीं होता: सब कुछ बिल्ड टूल कॉन्फ़िगरेशन में छिपा होता है। यदि वह प्लगइन अप्रबंधित हो जाता है या आप समाधान बदलना चाहते हैं, तो आप फंस सकते हैं। "इजेक्ट" करने का कोई आसान तरीका नहीं है: आपके कोड में कोई उपयोगी कीज़ नहीं होतीं, और आपको नई लाइब्रेरी के लिए अपने सभी अनुवादों को पुनः उत्पन्न करना पड़ सकता है।
 
-कंपाइलर-आधारित दृष्टिकोण में, **आपका स्रोत कोड केवल अंग्रेज़ी टेक्स्ट होता है।** "अनुवाद लॉजिक" केवल बिल्ड प्लगइन की कॉन्फ़िगरेशन के अंदर मौजूद होता है।
-यदि वह लाइब्रेरी मेंटेन करना बंद कर देती है, या यदि आप उससे आगे बढ़ जाते हैं, तो आप फंसे हुए हैं। आप आसानी से "eject" नहीं कर सकते क्योंकि आपके स्रोत कोड में कोई ट्रांसलेशन कीज़ नहीं हैं। आपको मैन्युअली अपना पूरा एप्लिकेशन फिर से लिखना होगा ताकि आप माइग्रेट कर सकें।
+कुछ समाधान अनुवाद जनरेशन सेवाएं भी प्रदान करते हैं। क्रेडिट खत्म? अनुवाद खत्म।
+
+कंपाइलर अक्सर टेक्स्ट को हैश करते हैं (जैसे, `"Hello World"` -> `x7f2a`)। आपकी अनुवाद फ़ाइलें इस तरह दिखती हैं: `{ "x7f2a": "Hola Mundo" }`। जाल: यदि आप लाइब्रेरी बदलते हैं, तो नई लाइब्रेरी `"Hello World"` देखती है और उस कुंजी की तलाश करती है। यह उसे नहीं पाएगी क्योंकि आपकी अनुवाद फ़ाइल हैश से भरी होती है (`x7f2a`)।
+
+### प्लेटफ़ॉर्म लॉक-इन
+
+कंपाइलर-आधारित दृष्टिकोण चुनकर, आप खुद को अंतर्निहित प्लेटफ़ॉर्म में बंद कर लेते हैं। उदाहरण के लिए, कुछ कंपाइलर सभी बंडलरों (जैसे Vite, Turbopack, या Metro) के लिए उपलब्ध नहीं हैं। यह भविष्य के माइग्रेशन को कठिन बना सकता है, और आपको अपने सभी एप्लिकेशन को कवर करने के लिए कई समाधान अपनाने की आवश्यकता हो सकती है।
 
 ## दूसरी तरफ: डिक्लेरेटिव दृष्टिकोण के जोखिम
 
-सच कहें तो, पारंपरिक डिक्लेरेटिव तरीका भी परफेक्ट नहीं है। इसके अपने "footguns" होते हैं।
+सच कहें तो, पारंपरिक डिक्लेरेटिव तरीका भी परफेक्ट नहीं है। इसके अपने "फुटगन्स" होते हैं।
 
-1.  **Namespace Hell:** आपको अक्सर मैन्युअली यह प्रबंधित करना पड़ता है कि कौन से JSON फाइलें लोड करनी हैं (`common.json`, `dashboard.json`, `footer.json`)। यदि आप कोई फाइल भूल जाते हैं, तो उपयोगकर्ता को कच्ची कुंजियाँ दिखाई देती हैं।
-2.  **Over-fetching:** सावधानीपूर्वक कॉन्फ़िगरेशन के बिना, यह बहुत आसान है कि आप गलती से प्रारंभिक लोड पर _सभी_ पृष्ठों के लिए _सभी_ ट्रांसलेशन कीज़ लोड कर लें, जिससे आपके बंडल का आकार बढ़ जाता है।
-3.  **सिंक ड्रिफ्ट:** यह आम बात है कि JSON फाइल में कुंजियाँ तब तक बनी रहती हैं जब तक कि उन कुंजियों का उपयोग करने वाला कंपोनेंट डिलीट नहीं हो जाता। आपकी ट्रांसलेशन फाइलें अनंत तक बढ़ती रहती हैं, जो "ज़ॉम्बी कीज़" से भरी होती हैं।
+1.  **Namespace Hell:** आपको अक्सर मैन्युअली यह प्रबंध करना पड़ता है कि कौन सी JSON फ़ाइलें लोड करनी हैं (`common.json`, `dashboard.json`, `footer.json`)। यदि आप किसी एक को भूल जाते हैं, तो उपयोगकर्ता को कच्ची कुंजियाँ दिखाई देती हैं।
+2.  **अधिक लोडिंग (Over-fetching):** सावधानीपूर्वक कॉन्फ़िगरेशन के बिना, यह बहुत आसान है कि आप गलती से अपनी सभी पृष्ठों के लिए सभी अनुवाद कुंजियाँ प्रारंभिक लोड पर लोड कर लें, जिससे आपके बंडल का आकार बढ़ जाता है।
+3.  **सिंक ड्रिफ्ट (Sync Drift):** यह सामान्य है कि कुंजियाँ JSON फ़ाइल में तब तक बनी रहती हैं जब तक कि उस कंपोनेंट का उपयोग नहीं किया जाता जो उन्हें उपयोग करता था। आपकी अनुवाद फ़ाइलें अनंत तक बढ़ती रहती हैं, "ज़ॉम्बी कुंजियों" से भरी हुई।
 
 ## Intlayer का मध्य मार्ग
 
-यहीं पर **Intlayer** जैसे टूल्स नवाचार करने की कोशिश कर रहे हैं। Intlayer समझता है कि जबकि कंपाइलर शक्तिशाली होते हैं, अप्रत्यक्ष जादू खतरनाक होता है।
+यहीं पर **Intlayer** जैसे टूल नवाचार करने की कोशिश कर रहे हैं। Intlayer समझता है कि जबकि कंपाइलर शक्तिशाली होते हैं, अप्रत्यक्ष जादू खतरनाक होता है।
 
-Intlayer एक अनोखा **`transform` कमांड** प्रदान करता है। छिपे हुए बिल्ड स्टेप में जादू करने के बजाय, यह वास्तव में **आपके कंपोनेंट कोड को फिर से लिख सकता है**। यह आपके टेक्स्ट को स्कैन करता है और इसे आपके कोडबेस में स्पष्ट कंटेंट डिक्लेरेशन से बदल देता है।
+Intlayer एक मिश्रित दृष्टिकोण प्रदान करता है, जिससे आप दोनों दृष्टिकोणों के लाभ उठा सकते हैं: घोषणात्मक सामग्री प्रबंधन, जो इसके कंपाइलर के साथ भी संगत है ताकि विकास समय बचाया जा सके।
+
+और यदि आप Intlayer कंपाइलर का उपयोग नहीं करते हैं, तब भी Intlayer एक `transform` कमांड प्रदान करता है (जो VSCode एक्सटेंशन के माध्यम से भी सुलभ है)। छिपे हुए बिल्ड चरण में जादू करने के बजाय, यह वास्तव में **आपके कंपोनेंट कोड को पुनः लिख सकता है**। यह आपके टेक्स्ट को स्कैन करता है और इसे आपके कोडबेस में स्पष्ट कंटेंट घोषणाओं से बदल देता है।
 
 यह आपको दोनों दुनिया का सर्वश्रेष्ठ देता है:
 
-1.  **ग्रैन्युलैरिटी:** आप अपनी ट्रांसलेशन्स को अपने कंपोनेंट्स के करीब रखते हैं (जो मॉड्यूलैरिटी और ट्री-शेकिंग में सुधार करता है)।
-2.  **सुरक्षा:** अनुवाद स्पष्ट कोड बन जाता है, छिपे हुए बिल्ड-टाइम जादू नहीं।
-3.  **कोई लॉक-इन नहीं:** चूंकि कोड आपके रिपॉजिटरी के भीतर एक मानक घोषणात्मक संरचना में परिवर्तित हो जाता है, आप लॉजिक को वेबपैक प्लगइन में छिपा नहीं रहे हैं।
+1.  **सूक्ष्मता (Granularity):** आप अपने अनुवादों को अपने कंपोनेंट्स के करीब रखते हैं (जो मॉड्यूलैरिटी और ट्री-शेकिंग को बेहतर बनाता है)।
+2.  **सुरक्षा (Safety):** अनुवाद स्पष्ट कोड बन जाता है, छिपे हुए बिल्ड-टाइम जादू के बजाय।
+3.  **कोई लॉक-इन नहीं (No Lock-in):** चूंकि कोड आपके रिपोजिटरी में एक घोषणात्मक संरचना में परिवर्तित हो जाता है, आप आसानी से टैब दबा सकते हैं, या अपने IDE के कोपिलट का उपयोग करके अपनी कंटेंट घोषणाएं जनरेट कर सकते हैं, आप वेबपैक प्लगइन में लॉजिक छिपा नहीं रहे हैं।
 
 ## निष्कर्ष
 
-तो, आपको क्या चुनना चाहिए?
+तो, आपको कौन सा चुनना चाहिए?
+
+**यदि आप एक MVP बना रहे हैं, या जल्दी आगे बढ़ना चाहते हैं:**
+कंपाइलर-आधारित दृष्टिकोण एक वैध विकल्प है। यह आपको बेहद तेजी से आगे बढ़ने की अनुमति देता है। आपको फ़ाइल संरचनाओं या कुंजियों की चिंता करने की आवश्यकता नहीं है। आप बस निर्माण करें। तकनीकी ऋण "भविष्य के आप" के लिए समस्या है।
+
+**यदि आप एक जूनियर डेवलपर हैं, या अनुकूलन की परवाह नहीं करते:**
+यदि आप सबसे कम मैनुअल प्रबंधन चाहते हैं, तो कंपाइलर-आधारित दृष्टिकोण संभवतः सबसे अच्छा है। आपको कुंजियों या अनुवाद फ़ाइलों को स्वयं संभालने की आवश्यकता नहीं होगी—बस टेक्स्ट लिखें, और कंपाइलर बाकी को स्वचालित करता है। इससे सेटअप प्रयास कम होता है और मैनुअल चरणों से जुड़ी सामान्य i18n गलतियाँ कम होती हैं।
 
-**यदि आप एक जूनियर डेवलपर, एक सोलो फाउंडर, या MVP बना रहे हैं:**
-कंपाइलर-आधारित दृष्टिकोण एक वैध विकल्प है। यह आपको बेहद तेज़ी से आगे बढ़ने की अनुमति देता है। आपको फाइल संरचनाओं या कुंजियों की चिंता करने की जरूरत नहीं है। आप बस निर्माण करते हैं। तकनीकी ऋण "भविष्य के आप" के लिए एक समस्या है।
+**यदि आप एक मौजूदा प्रोजेक्ट का अंतरराष्ट्रीयकरण कर रहे हैं जिसमें पहले से ही हजारों घटक हैं जिन्हें पुनः संरचित करना है:**
+यहाँ एक कंपाइलर-आधारित दृष्टिकोण व्यावहारिक विकल्प हो सकता है। प्रारंभिक निष्कर्षण चरण हफ्तों या महीनों के मैनुअल काम को बचा सकता है। हालांकि, Intlayer के `transform` कमांड जैसे टूल का उपयोग करने पर विचार करें, जो स्ट्रिंग्स को निकाल सकता है और उन्हें स्पष्ट घोषणात्मक कंटेंट डिक्लेरेशन में परिवर्तित कर सकता है। यह आपको ऑटोमेशन की गति देता है जबकि घोषणात्मक दृष्टिकोण की सुरक्षा और पोर्टेबिलिटी को बनाए रखता है। आपको दोनों दुनिया का सर्वश्रेष्ठ मिलता है: तेज़ प्रारंभिक माइग्रेशन बिना दीर्घकालिक आर्किटेक्चरल कर्ज के।
 
-**यदि आप एक पेशेवर, एंटरप्राइज-ग्रेड एप्लिकेशन बना रहे हैं:**
-जादू आमतौर पर एक बुरा विचार है। आपको नियंत्रण की आवश्यकता है।
+**यदि आप एक प्रोफेशनल, एंटरप्राइज-ग्रेड एप्लिकेशन बना रहे हैं:**
+मैजिक आमतौर पर एक खराब विचार है। आपको नियंत्रण की आवश्यकता है।
 
-- आपको बैकएंड से डायनेमिक डेटा को संभालना होगा।
-- आपको कम-श्रेणी के उपकरणों पर प्रदर्शन सुनिश्चित करना होगा (हुक विस्फोटों से बचते हुए)।
-- आपको यह सुनिश्चित करना होगा कि आप हमेशा के लिए किसी विशिष्ट बिल्ड टूल में लॉक न हों।
+- आपको बैकएंड से डायनामिक डेटा को संभालना होगा।
+- आपको लो-एंड डिवाइसेस पर प्रदर्शन सुनिश्चित करना होगा (हुक विस्फोटों से बचते हुए)।
+- आपको यह सुनिश्चित करने की आवश्यकता है कि आप हमेशा के लिए किसी विशिष्ट बिल्ड टूल में फंसे न रहें।
 
-पेशेवर ऐप्स के लिए, **घोषणात्मक कंटेंट मैनेजमेंट** (जैसे Intlayer या स्थापित लाइब्रेरी) स्वर्ण मानक बना रहता है। यह आपकी चिंताओं को अलग करता है, आपकी आर्किटेक्चर को साफ़ रखता है, और यह सुनिश्चित करता है कि आपकी एप्लिकेशन की बहुभाषी क्षमता किसी "ब्लैक बॉक्स" कंपाइलर पर निर्भर न हो जो आपकी मंशाओं का अनुमान लगाता हो।
+पेशेवर ऐप्स के लिए, **घोषणात्मक कंटेंट प्रबंधन** (जैसे Intlayer या स्थापित लाइब्रेरीज़) स्वर्ण मानक बना रहता है। यह आपकी चिंताओं को अलग करता है, आपकी आर्किटेक्चर को साफ रखता है, और यह सुनिश्चित करता है कि आपकी एप्लिकेशन की बहुभाषी क्षमता किसी "ब्लैक बॉक्स" कंपाइलर पर निर्भर न हो जो आपकी मंशाओं का अनुमान लगाता हो।