@intlayer/docs 8.11.1 → 8.11.3

package/docs/ur/introduction.md

@@ -2,33 +2,33 @@
 createdAt: 2025-08-23
 updatedAt: 2025-08-23
 title: تعارف
-description: دریافت کریں کہ Intlayer کیسے کام کرتا ہے۔ اپنی ایپلی کیشن میں Intlayer کے ذریعے استعمال ہونے والے مراحل دیکھیں۔ دیکھیں کہ مختلف پیکیجز کیا کرتے ہیں۔
+description: دریافت کریں کہ Intlayer کیسے کام کرتا ہے۔ وہ اقدامات دیکھیں جو Intlayer آپ کی ایپلیکیشن میں استعمال کرتا ہے۔ جانیں कि مختلف پیکجز کیا کرتے ہیں۔
 keywords:
   - تعارف
-  - شروع کریں
+  - شروعات کریں
   - Intlayer
-  - ایپلی کیشن
-  - پیکیجز
+  - ایپلیکیشن
+  - پیکجز
 slugs:
   - doc
   - get-started
 history:
   - version: 5.5.10
     date: 2025-06-29
-    changes: "تاریخ کا آغاز"
+    changes: "Init history"
 ---
 
-# Intlayer دستاویزات
+# Intlayer ڈاکیومنٹیشن
 
-آفیشل Intlayer دستاویزات میں خوش آمدید! یہاں آپ کو اپنی تمام بین الاقوامی سازی (i18n) کی ضروریات کے لیے Intlayer کو انٹیگریٹ کرنے، کنفیگر کرنے اور اس میں مہارت حاصل کرنے کے لیے درکار ہر چیز ملے گی، چاہے آپ Next.js، React، Vite، Express، یا کسی دوسرے JavaScript ماحول کے ساتھ کام کر رہے ہوں۔
+آفیشل Intlayer ڈاکیومنٹیشن میں خوش آمدید! یہاں، آپ کو اپنی تمام بین الاقوامی کاری (i18n) کی ضروریات کے لیے Intlayer کو مربوط (integrate)، کنفیگر اور ماسٹر کرنے کے لیے درکار ہر چیز مل جائے گی، چاہے آپ Next.js، React، Vite، Express، یا کسی اور JavaScript ماحول کے ساتھ کام کر رہے ہوں۔
 
 ## تعارف
 
 ### Intlayer کیا ہے؟
 
-**Intlayer** ایک بین الاقوامی سازی لائبریری ہے جو خاص طور پر JavaScript ڈویلپرز کے لیے ڈیزائن کی گئی ہے۔ یہ آپ کو اپنے کوڈ میں ہر جگہ اپنے مواد کا اعلان کرنے کی اجازت دیتی ہے۔ یہ کثیر لسانی مواد کے اعلانات کو منظم ڈکشنریوں میں تبدیل کرتی ہے تاکہ آپ کے کوڈ میں آسانی سے انٹیگریٹ کیا جا سکے۔ TypeScript کا استعمال کرتے ہوئے، **Intlayer** آپ کی ڈویلپمنٹ کو مضبوط اور زیادہ موثر بناتی ہے۔
+**Intlayer** ایک بین الاقوامی کاری (internationalization) لائبریری ہے جو خاص طور پر JavaScript ڈیولپرز کے لیے ڈیزائن کی گئی ہے۔ یہ آپ کے مواد کو آپ کے کوڈ میں کہیں بھی ڈیکلیئر کرنے کی اجازت دیتی ہے۔ یہ کثیر لسانی مواد کے ڈیکلریشنز کو ساختی لغات (structured dictionaries) میں تبدیل کرتی ہے تاکہ آپ کے کوڈ میں آسانی سے مربوط ہو سکے۔ TypeScript کا استعمال کرتے ہوئے، **Intlayer** آپ کے ڈیولپمنٹ کو زیادہ مضبوط اور موثر بناتی ہے۔
 
-Intlayer ایک اختیاری ویژول ایڈیٹر بھی فراہم کرتی ہے جو آپ کو اپنے مواد کو آسانی سے ایڈٹ اور منظم کرنے کی اجازت دیتی ہے۔ یہ ایڈیٹر خاص طور پر ان ڈویلپرز کے لیے مفید ہے جو مواد کے انتظام کے لیے ویژول انٹرفیس کو ترجیح دیتے ہیں، یا ان ٹیموں کے لیے جو کوڈ کی فکر کیے بغیر مواد تیار کرنا چاہتی ہیں۔
+Intlayer ایک اختیاری بصری ایڈیٹر (visual editor) بھی فراہم کرتا ہے جو آپ کو اپنے مواد کو آسانی سے ایڈٹ اور منظم کرنے کی اجازت دیتا ہے۔ یہ ایڈیٹر خاص طور پر ان ڈیولپرز کے لیے مفید ہے جو مواد کے انتظام کے لیے بصری انٹرفیس کو ترجیح دیتے ہیں، یا ان ٹیموں کے لیے جو کوڈ کی فکر کیے بغیر مواد تیار کرتی ہیں۔
 
 ### استعمال کی مثال
 
@@ -50,6 +50,7 @@ const componentContent = {
       en: "Hello World",
       es: "Hola Mundo",
       fr: "Bonjour le monde",
+      ur: "ہیلو دنیا",
     }),
   },
 } satisfies Dictionary;
@@ -67,7 +68,8 @@ export default componentContent;
       "translation": {
         "en": "Hello World",
         "fr": "Bonjour le monde",
-        "es": "Hola Mundo"
+        "es": "Hola Mundo",
+        "ur": "ہیلو دنیا"
       }
     }
   }
@@ -87,49 +89,49 @@ export const MyComponent: FC = () => {
 
 ## اہم خصوصیات
 
-Intlayer جدید ویب ڈویلپمنٹ کی ضروریات کو پورا کرنے کے لیے مختلف خصوصیات پیش کرتی ہے۔ نیچے اہم خصوصیات دی گئی ہیں، جن میں سے ہر ایک کے لیے تفصیلی دستاویزات کے لنکس موجود ہیں:
+Intlayer جدید ویب ڈیولپمنٹ کی ضروریات کو پورا کرنے کے لیے تیار کردہ مختلف خصوصیات پیش کرتا ہے۔ ذیل میں ہر ایک کے لیے تفصیلی ڈاکیومنٹیشن کے لنکس کے ساتھ کلیدی خصوصیات درج ہیں:
 
-- **بین الاقوامی سازی سپورٹ**: بین الاقوامی سازی کے لیے بلٹ ان سپورٹ کے ساتھ اپنی ایپلی کیشن کی عالمی رسائی کو بڑھائیں۔
-- **ویژول ایڈیٹر**: Intlayer کے لیے ڈیزائن کیے گئے ایڈیٹر پلگ انز کے ساتھ اپنے ڈویلپمنٹ ورک فلو کو بہتر بنائیں۔ [ویژول ایڈیٹر گائیڈ](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/intlayer_visual_editor.md) دیکھیں۔
-- **کنفیگریشن میں لچک**: [کنفیگریشن گائیڈ](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/configuration.md) میں بیان کردہ وسیع کنفیگریشن اختیارات کے साथ اپنے سیٹ اپ کو اپنی مرضی کے مطابق بنائیں۔
-- **اعلی درجے کے CLI ٹولز**: Intlayer کے کمانڈ لائن انٹرفیس کا استعمال کرتے ہوئے اپنے پروجیکٹس کو مؤثر طریقے سے منظم کریں۔ [CLI ٹولز دستاویزات](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/cli/index.md) میں صلاحیتوں کو تلاش کریں۔
+- **بین الاقوامی کاری کی معاونت**: بین الاقوامی کاری کے لیے بلٹ ان سپورٹ کے ساتھ اپنی ایپلیکیشن کی عالمی رسائی کو بڑھائیں۔
+- **بصری ایڈیٹر**: Intlayer کے لیے ڈیزائن کردہ ایڈیٹر پلگ انز کے ساتھ اپنے ڈیولپمنٹ ورک فلو کو بہتر بنائیں۔ [بصری ایڈیٹر گائیڈ](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/intlayer_visual_editor.md) دیکھیں۔
+- **کنفیگریشن کی لچک**: [کنفیگریشن گائیڈ](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/configuration.md) میں تفصیلی وسیع کنفیگریشن آپشنز کے ساتھ اپنے سیٹ اپ کو حسب ضرورت بنائیں۔
+- **اعلی درجے کے CLI ٹولز**: Intlayer کے کمانڈ لائن انٹرفیس کا استعمال کرتے ہوئے اپنے پروجیکٹس کو مؤثر طریقے سے منظم کریں۔ [CLI ٹولز ڈاکیومنٹیشن](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/cli/index.md) میں صلاحیتوں کو دریافت کریں۔
 
 ## بنیادی تصورات
 
 ### ڈکشنری (Dictionary)
 
-اپنے کثیر لسانی مواد کو اپنے کوڈ کے قریب منظم کریں تاکہ ہر چیز مستقل اور برقرار رکھنے کے قابل رہے۔
+اپنے کثیر لسانی مواد کو اپنے کوڈ کے قریب منظم کریں تاکہ ہر چیز مطابقت پذیر اور قابل انتظام رہے۔
 
-- **[شروع کریں](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/dictionary/content_file.md)**  
-  Intlayer میں اپنے مواد کے اعلان کی بنیادی باتیں سیکھیں۔
+- **[شروعات کریں (Get Started)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/dictionary/content_file.md)**  
+  Intlayer میں اپنا مواد ڈیکلیئر کرنے کی بنیادی باتیں سیکھیں۔
 
-- **[ترجمہ](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/dictionary/translation.md)**  
-  سمجھیں کہ ترجمہ کیسے تیار، ذخیرہ اور آپ کی ایپلی کیشن میں استعمال کیا جاتا ہے۔
+- **[ترجمہ (Translation)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/dictionary/translation.md)**  
+  سمجھیں کہ آپ کی ایپلیکیشن میں ترجمے کیسے بنائے، محفوظ کیے اور استعمال کیے جاتے ہیں۔
 
-- **[فہرست (Enumeration)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/dictionary/enumeration.md)**  
-  مختلف زبانوں میں بار بار ہونے والے یا طے شدہ ڈیٹا کے سیٹس کو آسانی سے منظم کریں۔
+- **[شماریات (Enumeration)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/dictionary/enumeration.md)**  
+  مختلف زبانوں میں دہرائے گئے یا مقررہ ڈیٹا سیٹس کو آسانی سے منظم کریں۔
 
 - **[شرط (Condition)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/dictionary/condition.md)**  
-  ڈائنامک مواد بنانے کے لیے Intlayer میں مشروط منطق (conditional logic) استعمال کرنا سیکھیں۔
+  متحرک مواد بنانے کے لیے Intlayer میں مشروط منطق کا استعمال سیکھیں۔
 
-- **[شمولیت (Insertion)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/dictionary/insertion.md)**
-  دریافت کریں کہ انسریشن پلیس ہولڈرز کا استعمال کرتے ہوئے اسٹرنگ میں ویلیوز کو کیسے شامل کیا جائے۔
+- **[اندراج (Insertion)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/dictionary/insertion.md)**  
+  اندراج پلیس ہولڈرز کا استعمال کرتے ہوئے سٹرنگ میں اقدار شامل کرنے کا طریقہ دریافت کریں۔
 
-- **[فنکشن فیچنگ (Function Fetching)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/dictionary/function_fetching.md)**  
-  دیکھیں کہ اپنے پروجیکٹ کے ورک فلو کے مطابق کسٹم لاجک کے ساتھ ڈائنامک طور پر مواد حاصل کیا جائے۔
+- **[فنکشن لانا (Function Fetching)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/dictionary/function_fetching.md)**  
+  دیکھیں کہ آپ کے پروجیکٹ کے ورک فلو سے ملنے کے لیے حسب ضرورت منطق کے ساتھ متحرک طور پر مواد کیسے لایا جائے۔
 
 - **[مارک ڈاؤن (Markdown)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/dictionary/markdown.md)**  
-  بھرپور مواد تخلیق کرنے کے لیے Intlayer میں مارک ڈاؤن استعمال کرنا سیکھیں۔
+  بھرپور مواد بنانے کے لیے Intlayer میں مارک ڈاؤن کا استعمال سیکھیں۔
 
 - **[فائل ایمبیڈنگ (File embeddings)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/dictionary/file.md)**  
-  دریافت کریں کہ کٹنٹ ایڈیٹر میں استعمال کرنے کے لیے Intlayer میں بیرونی فائلوں کو کیسے شامل کیا جائے۔
+  کنٹینٹ ایڈیٹر میں استعمال کرنے کے لیے Intlayer میں بیرونی فائلوں کو ایمبیڈ کرنے کا طریقہ دریافت کریں۔
 
 - **[نیسٹنگ (Nesting)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/dictionary/nesting.md)**  
-  پیچیدہ ڈھانچے بنانے کے لیے Intlayer میں مواد کو نیسٹ کرنے کا طریقہ سمجھیں۔
+  پیچیدہ ڈھانچے بنانے کے لیے Intlayer میں مواد کو نیسٹ کرنا سمجھیں۔
 
-### ماحول اور انٹیگریشنز (Environments & Integrations)
+### ماحولیات اور انضمام (Environments & Integrations)
 
-ہم نے Intlayer کو لچک کو مدنظر رکھتے ہوئے بنایا ہے، جو مقبول فریم ورکس اور بلڈ ٹولز میں ہموار انٹیگریشن پیش کرتی ہے:
+ہم نے لچک کو ذہن میں رکھتے ہوئے Intlayer بنایا ہے، جو مقبول فریم ورکس اور بلڈ ٹولز میں ہموار انضمام کی پیشکش کرتا ہے:
 
 - **[Next.js 16 کے ساتھ Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/intlayer_with_nextjs_16.md)**
 - **[Next.js 15 کے ساتھ Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/intlayer_with_nextjs_15.md)**
@@ -149,12 +151,40 @@ Intlayer جدید ویب ڈویلپمنٹ کی ضروریات کو پورا کر
 - **[Express کے ساتھ Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/intlayer_with_express.md)**
 - **[NestJS کے ساتھ Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/intlayer_with_nestjs.md)**
 - **[Hono کے ساتھ Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/intlayer_with_hono.md)**
-- **[Angular کے ساتھ Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/intlayer_with_angular.md)**
+- **[Angular کے ساتھ Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/intlayer_with_angular_21.md)**
 
-ہر انٹیگریشن گائیڈ میں Intlayer کی خصوصیات کے استعمال کے لیے بہترین طریقے شامل ہیں، جیسے **سرور سائیڈ رینڈرنگ**، **ڈائنامک روٹنگ**، یا **کلائنٹ سائیڈ رینڈرنگ**، تاکہ آپ ایک تیز، SEO دوستانہ، اور انتہائی توسیع پذیر ایپلی کیشن برقرار رکھ سکیں۔
+ہر انضمام گائیڈ میں Intlayer کی خصوصیات کو استعمال کرنے کے بہترین طریقے (best practices) شامل ہیں، جیسے **سرور سائیڈ رینڈرنگ (SSR)**، **ڈائنامک روٹنگ**، یا **کلائنٹ سائیڈ رینڈرنگ**، تاکہ آپ ایک تیز، SEO-دوست اور انتہائی قابل توسیع ایپلیکیشن کو برقرار رکھ سکیں۔
 
-## تعاون اور فیڈ بیک
+## شراکت اور تاثرات
 
-ہم اوپن سورس اور کمیونٹی پر مبنی ڈویلپمنٹ کی طاقت کی قدر کرتے ہیں۔ اگر آپ بہتری کی تجویز دینا چاہتے ہیں، کوئی نئی گائیڈ شامل کرنا چاہتے ہیں، یا ہماری دستاویزات میں کسی بھی مسئلے کو درست کرنا چاہتے ہیں، تو بلا جھجھک پل ریکوسٹ (Pull Request) جمع کرائیں یا ہمارے [GitHub ریپوزٹری](https://github.com/aymericzip/intlayer/blob/main/docs/docs) پر ایشو (issue) شروع کریں۔
+ہم اوپن سورس اور کمیونٹی کے ذریعے چلنے والی ڈیولپمنٹ کی طاقت کی قدر کرتے ہیں۔ اگر آپ بہتری کی تجویز دینا چاہتے ہیں، ایک نئی گائیڈ شامل کرنا چاہتے ہیں، یا ہماری ڈاکیومنٹیشن میں کسی بھی مسئلے کو درست کرنا چاہتے ہیں، تو بلا جھجھک پُل ریکویسٹ (Pull Request) جمع کرائیں یا ہمارے [GitHub ریپوزٹری](https://github.com/aymericzip/intlayer/blob/main/docs/docs) پر ایک مسئلہ (Issue) کھولیں۔
 
-**اپنی ایپلی کیشن کو تیزی سے اور زیادہ مؤثر طریقے سے ترجمہ کرنے کے لیے تیار ہیں؟** آج ہی Intlayer کا استعمال شروع کرنے کے لیے ہماری دستاویزات دیکھیں۔ بین الاقوامی سازی کے ایک مضبوط، ہموار طریقہ کار کا تجربہ کریں جو آپ کے مواد کو منظم رکھتا ہے اور آپ کی ٹیم کو زیادہ پیداواری بناتا ہے۔
+**کیا آپ اپنی ایپلیکیشن کا تیزی سے اور زیادہ مؤثر طریقے سے ترجمہ کرنے کے لیے تیار ہیں؟** آج ہی Intlayer کا استعمال شروع کرنے کے لیے ہماری ڈاکیومنٹیشن میں غوطہ لگائیں۔ بین الاقوامی کاری کے لیے ایک مضبوط اور ہموار نقطہ نظر کا تجربہ کریں جو آپ کے مواد کو منظم اور آپ کی ٹیم کو زیادہ نتیجہ خیز بناتا ہے۔
+
+### متبادل کے مقابلے میں Intlayer کیوں؟
+
+`next-intl` یا `i18next` جیسے اہم حلوں کے مقابلے میں، Intlayer ایک ایسا حل ہے جو مربوط آپٹمائزیشن کے ساتھ آتا ہے جیسے:
+
+**بنڈل کا سائز (Bundle size)**
+
+اپنے صفحات میں بھاری JSON فائلیں لوڈ کرنے کے بجائے، صرف ضروری مواد لوڈ کریں۔ Intlayer آپ کے **بنڈل اور صفحہ کے سائز کو 50% تک کم کرنے** میں مدد کرتا ہے۔
+
+**قابلِ برقراری (Maintainability)**
+
+اپنی ایپلیکیشن کے مواد کو قریب رکھنا بڑے پیمانے کی ایپلیکیشنز کے لیے **دیکھ بھال کو آسان بناتا ہے**۔ آپ اپنے پورے مواد کے کوڈ بیس کا جائزہ لینے کے ذہنی بوجھ کے بغیر کسی ایک فیچر فولڈر کو نقل یا حذف کر سکتے ہیں۔ مزید برآں، آپ کے مواد کی درستگی کو یقینی بنانے کے لیے Intlayer کو **مکمل طور پر ٹائپڈ (fully typed)** کیا گیا ہے۔
+
+**AI ایجنٹ (AI Agent)**
+
+مواد کو قریب رکھنا بڑے لینگویج ماڈلز (LLMs) کی طرف سے **درکار سیاق و سباق کو کم کرتا ہے**۔ Intlayer ٹولز کے ایک سوٹ کے ساتھ بھی آتا ہے، جیسے غائب ترجموں کو جانچنے کے لیے **CLI**، **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/lsp.md)**، **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/mcp_server.md)** اور AI ایجنٹس کے لیے ڈیولپر کے تجربے (DX) کو اور بھی ہموار بنانے کے لیے **[ایجنٹ کی مہارتیں (agent skills)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/agent_skills.md)**۔
+
+**آٹومیشن (Automation)**
+
+اپنے AI فراہم کنندہ کی قیمت پر اپنی پسند کا LLM استعمال کرتے ہوئے اپنے CI/CD پائپ لائن میں ترجمہ کرنے کے لیے آٹومیشن کا استعمال کریں۔ Intlayer مواد نکالنے کو خودکار بنانے کے لیے ایک **کمپائلر (compiler)** کے ساتھ ساتھ [ویب پلیٹ فارم](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/intlayer_CMS.md) بھی پیش کرتا ہے تاکہ **پس منظر میں ترجمہ** کرنے میں مدد ملے۔
+
+**کارکردگی (Performance)**
+
+بھاری JSON فائلوں کو اجزاء (components) سے جوڑنے سے کارکردگی اور ردعمل (reactivity) کے مسائل پیدا ہو سکتے ہیں۔ Intlayer تعمیر کے وقت (build time) پر آپ کے مواد کی لوڈنگ کو بہتر بناتا ہے۔
+
+**غیر ڈیولپرز کے ساتھ اسکیلنگ (Scaling with non-dev)**
+
+صرف ایک i18n حل سے بڑھ کر، Intlayer ایک **خود میزبان (self-hosted) [بصری ایڈیٹر](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/intlayer_visual_editor.md)** اور ایک **[مکمل CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/intlayer_CMS.md)** فراہم کرتا ہے تاکہ آپ کو اپنے کثیر لسانی مواد کو **ریئل ٹائم** میں منظم کرنے میں مدد ملے، جس سے مترجمین، کاپی رائٹرز اور ٹیم کے دیگر اراکین کے ساتھ باہمی تعاون کو ہموار بنایا جا سکے۔ مواد کو مقامی طور پر اور/یا دور دراز سے محفوظ کیا جا سکتا ہے۔

package/docs/vi/benchmark/index.md

@@ -2,7 +2,7 @@
 createdAt: 2026-04-20
 updatedAt: 2026-04-20
 title: Điểm chuẩn các thư viện i18n
-description: Tìm hiểu cách Intlayer so sánh với các thư viện i18n khác về hiệu năng và kích thước gói bundle.
+description: Tìm hiểu cách Intlayer so sánh với các thư viện i18n khác về hiệu năng và kích thước bundle bundle.
 keywords:
   - benchmark
   - i18n

package/docs/vi/benchmark/nextjs.md

@@ -2,7 +2,7 @@
 createdAt: 2026-04-20
 updatedAt: 2026-05-18
 title: Giải pháp i18n tốt nhất cho Next.js năm 2026 - Báo cáo Benchmark
-description: So sánh các thư viện quốc tế hóa (i18n) cho Next.js như next-intl, next-i18next và Intlayer. Báo cáo hiệu năng chi tiết về kích thước gói bundle, rò rỉ dữ liệu và tính phản ứng.
+description: So sánh các thư viện quốc tế hóa (i18n) cho Next.js như next-intl, next-i18next và Intlayer. Báo cáo hiệu năng chi tiết về kích thước bundle bundle, rò rỉ dữ liệu và tính phản ứng.
 keywords:
   - benchmark
   - i18n
@@ -54,7 +54,7 @@ Xem kho lưu trữ benchmark đầy đủ [tại đây](https://github.com/intla
 
 Các thư viện quốc tế hóa có tác động nặng nề đến ứng dụng của bạn. Rủi ro chính là tải nội dung cho mọi trang và mọi ngôn ngữ ngay cả khi người dùng chỉ truy cập một trang duy nhất.
 
-Khi ứng dụng của bạn phát triển, kích thước gói bundle có thể tăng theo cấp số nhân, điều này có thể làm giảm hiệu năng một cách rõ rệt.
+Khi ứng dụng của bạn phát triển, kích thước bundle bundle có thể tăng theo cấp số nhân, điều này có thể làm giảm hiệu năng một cách rõ rệt.
 
 Ví dụ, trong những trường hợp xấu nhất, sau khi triển khai đa ngôn ngữ, trang của bạn có thể nặng hơn gần 4 lần.
 
@@ -134,7 +134,7 @@ Tôi đã so sánh **bốn chiến lược tải**:
 
 ## Tóm tắt chiến lược
 
-- **Static**: Đơn giản; không có độ trễ mạng sau lần tải đầu tiên. Nhược điểm: kích thước gói bundle lớn.
+- **Static**: Đơn giản; không có độ trễ mạng sau lần tải đầu tiên. Nhược điểm: kích thước bundle bundle lớn.
 - **Dynamic**: Giảm bớt gánh nặng ban đầu (lazy-loading). Lý tưởng khi bạn có nhiều ngôn ngữ.
 - **Scoped static**: Giữ cho mã được tổ chức (tách biệt logic) mà không cần các yêu cầu mạng bổ sung phức tạp.
 - **Scoped dynamic**: Phương pháp tốt nhất cho việc _chia tách mã_ (code splitting) và hiệu năng. Giảm thiểu bộ nhớ bằng cách chỉ tải những gì cần thiết cho chế độ xem hiện tại và ngôn ngữ đang hoạt động.
@@ -151,7 +151,7 @@ Tôi đã chạy cùng một ứng dụng đa ngôn ngữ trên trình duyệt t
 
 - **Rò rỉ từ các route khác**: Ý tưởng tương tự cho **các màn hình khác** trong ứng dụng: liệu văn bản của chúng có đi kèm khi bạn chỉ mở một trang (ví dụ: nội dung trang `/en/about` nằm trong gói bundle của trang `/en/contact`). Điểm số cao cho thấy việc chia tách yếu hoặc các gói bundle quá rộng.
 
-- **Kích thước gói bundle trung bình cho component**: Các thành phần giao diện người dùng (UI) phổ biến được đo lường **từng cái một** thay vì ẩn bên trong một con số khổng lồ của ứng dụng. Nó cho thấy liệu việc quốc tế hóa có âm thầm làm phồng các component hàng ngày hay không. Ví dụ, nếu component của bạn render lại, nó sẽ tải toàn bộ dữ liệu đó từ bộ nhớ. Việc đính kèm một tệp JSON khổng lồ vào bất kỳ component nào giống như việc kết nối một kho lưu trữ lớn các dữ liệu không dùng đến sẽ làm chậm hiệu năng của component của bạn.
+- **Kích thước bundle bundle trung bình cho component**: Các thành phần giao diện người dùng (UI) phổ biến được đo lường **từng cái một** thay vì ẩn bên trong một con số khổng lồ của ứng dụng. Nó cho thấy liệu việc quốc tế hóa có âm thầm làm phồng các component hàng ngày hay không. Ví dụ, nếu component của bạn render lại, nó sẽ tải toàn bộ dữ liệu đó từ bộ nhớ. Việc đính kèm một tệp JSON khổng lồ vào bất kỳ component nào giống như việc kết nối một kho lưu trữ lớn các dữ liệu không dùng đến sẽ làm chậm hiệu năng của component của bạn.
 
 - **Khả năng phản ứng khi chuyển đổi ngôn ngữ**: Tôi chuyển đổi ngôn ngữ bằng bộ điều khiển của chính ứng dụng và đo thời gian cho đến khi trang được chuyển đổi rõ ràng - những gì một khách truy cập sẽ nhận thấy, không phải là một bước vi mô trong phòng thí nghiệm.
 
@@ -222,7 +222,7 @@ Các định dạng thông báo cũng khác nhau: `next-intl` sử dụng ICU Me
 
 **(Next International)** (`next-international@1.3.1`):
 
-`next-international` cũng giải quyết các vấn đề trên nhưng không khác nhiều so với `next-intl` hay `next-i18next`. Nó bao gồm `scopedT()` cho các bản dịch cụ thể theo namespace, nhưng việc sử dụng nó về cơ bản không ảnh hưởng đến kích thước gói bundle.
+`next-international` cũng giải quyết các vấn đề trên nhưng không khác nhiều so với `next-intl` hay `next-i18next`. Nó bao gồm `scopedT()` cho các bản dịch cụ thể theo namespace, nhưng việc sử dụng nó về cơ bản không ảnh hưởng đến kích thước bundle bundle.
 
 **(Lingui)** (`@lingui/core@5.3.0`):
 

package/docs/vi/benchmark/tanstack.md

@@ -2,7 +2,7 @@
 createdAt: 2026-04-20
 updatedAt: 2026-05-18
 title: Giải pháp i18n tốt nhất cho TanStack Start năm 2026 - Báo cáo Benchmark
-description: So sánh các thư viện quốc tế hóa cho TanStack Start như react-i18next, use-intl và Intlayer. Báo cáo hiệu năng chi tiết về kích thước gói bundle, rò rỉ dữ liệu và tính phản ứng.
+description: So sánh các thư viện quốc tế hóa cho TanStack Start như react-i18next, use-intl và Intlayer. Báo cáo hiệu năng chi tiết về kích thước bundle bundle, rò rỉ dữ liệu và tính phản ứng.
 keywords:
   - benchmark
   - i18n
@@ -119,7 +119,7 @@ Chúng tôi đã so sánh **bốn chiến lược tải**:
 
 ## Tóm tắt chiến lược
 
-- **Static**: Đơn giản; không có độ trễ mạng sau lần tải đầu tiên. Nhược điểm: kích thước gói bundle lớn.
+- **Static**: Đơn giản; không có độ trễ mạng sau lần tải đầu tiên. Nhược điểm: kích thước bundle bundle lớn.
 - **Dynamic**: Giảm bớt gánh nặng ban đầu (lazy-loading). Lý tưởng khi bạn có nhiều ngôn ngữ.
 - **Scoped static**: Giữ cho mã được tổ chức (tách biệt logic) mà không cần các yêu cầu mạng bổ sung phức tạp.
 - **Scoped dynamic**: Phương pháp tốt nhất cho việc _chia tách mã_ (code splitting) và hiệu năng. Giảm thiểu bộ nhớ bằng cách chỉ tải những gì cần thiết cho chế độ xem hiện tại và ngôn ngữ đang hoạt động.

package/docs/vi/dictionary/markdown.md

@@ -17,6 +17,9 @@ slugs:
   - content
   - markdown
 history:
+  - version: 8.11.0
+    date: 2026-05-28
+    changes: "Cho phép phân tích cú pháp trước AST Markdown cho SSR / hydrat hóa"
   - version: 8.10.0
     date: 2026-05-19
     changes: "Thêm hỗ trợ cho các tệp `.content.md`"
@@ -1149,6 +1152,164 @@ export class MyComponent {
 
 ---
 
+## Render Phía Server (SSR) và Hydrat Hóa
+
+So với các trình phân tích cú pháp Markdown khác như remark / rehype, Intlayer Markdown không phụ thuộc và chạy trên cả client lẫn server.
+
+Nhưng Intlayer tối ưu hóa việc phân tích cú pháp cho các framework Server-Side Rendering (SSR) (như Next.js App Router, React Router, Nuxt, SvelteKit, v.v.).
+
+Thay vì gửi chuỗi Markdown thô đến client và phân tích cú pháp trên trình duyệt (gây giảm hiệu suất), Intlayer cho phép bạn phân tích cú pháp trước Markdown thành Cây Cú Pháp Trừu Tượng (AST) trên server.
+
+Bạn có thể sử dụng hàm `parseMarkdown` từ gói Intlayer của framework phía server để tạo ra một AST có thể tuần tự hóa (đối tượng `ParsedMarkdown`), và chuyển trực tiếp đến frontend. Tất cả các tiện ích render của Intlayer (như `<MarkdownRenderer>`, `useMarkdownRenderer`, v.v.) tự động chấp nhận đối tượng AST này và hiển thị nó một cách liền mạch.
+
+### Ví dụ trong Kiến Trúc Server/Client
+
+<Tabs group="framework">
+  <Tab label="React Router" value="react">
+
+    ```tsx fileName="server.ts"
+    import { parseMarkdown } from "react-intlayer/markdown";
+
+    // 1. Trên server: Phân tích cú pháp markdown thành AST có thể tuần tự hóa
+    export const loader = async () => {
+      const markdownString = "## My title \n\nLorem Ipsum";
+      const ast = parseMarkdown(markdownString);
+
+      // Trả về AST dưới dạng JSON cho client
+      return Response.json({ content: ast });
+    };
+    ```
+
+    ```tsx fileName="client.tsx"
+    import { useLoaderData } from "react-router";
+    import { MarkdownRenderer } from "react-intlayer/markdown";
+
+    // 2. Trên client: Hiển thị trực tiếp AST mà không cần phân tích cú pháp lại
+    export default function Page() {
+      const { content } = useLoaderData();
+
+      // Trình kết xuất chấp nhận chuỗi thô hoặc AST đã được phân tích cú pháp
+      return <MarkdownRenderer content={content} />;
+    }
+    ```
+
+  </Tab>
+  <Tab label="Next.js" value="nextjs">
+
+    ```tsx fileName="app/page.tsx"
+    import { parseMarkdown } from "next-intlayer/markdown";
+    import { MarkdownRenderer } from "next-intlayer/markdown";
+
+    export default async function Page() {
+      // 1. Phân tích cú pháp markdown thành AST có thể tuần tự hóa trên server
+      const markdownString = "## My title \n\nLorem Ipsum";
+      const ast = parseMarkdown(markdownString);
+
+      // 2. Hiển thị trực tiếp AST
+      // Trong một Server Component, hoạt động này diễn ra liền mạch và chuyển AST
+    // trực tiếp đến các client component bên dưới nếu cần.
+      return <MarkdownRenderer content={ast} />;
+    }
+    ```
+
+  </Tab>
+  <Tab label="Vue / Nuxt" value="vue">
+
+    ```vue fileName="pages/index.vue"
+    <script setup lang="ts">
+    import { parseMarkdown } from "vue-intlayer/markdown";
+    import { MarkdownRenderer } from "vue-intlayer/markdown";
+
+    // 1. Lấy và phân tích cú pháp markdown thành AST trên server
+    const { data: ast } = await useAsyncData('markdown', () => {
+      const markdownString = "## My title \n\nLorem Ipsum";
+      return parseMarkdown(markdownString);
+    });
+    </script>
+
+    <template>
+      <!-- 2. Trên client: Hiển thị trực tiếp AST mà không cần phân tích cú pháp lại -->
+      <MarkdownRenderer :content="ast" />
+    </template>
+    ```
+
+  </Tab>
+  <Tab label="SvelteKit" value="svelte">
+
+    ```typescript fileName="+page.server.ts"
+    import { parseMarkdown } from "svelte-intlayer/markdown";
+
+    // 1. Trên server: Phân tích cú pháp markdown thành AST có thể tuần tự hóa
+    export const load = async () => {
+      const markdownString = "## My title \n\nLorem Ipsum";
+      const ast = parseMarkdown(markdownString);
+
+      // Trả về AST cho client
+      return { content: ast };
+    };
+    ```
+
+    ```svelte fileName="+page.svelte"
+    <script lang="ts">
+      import { MarkdownRenderer } from "svelte-intlayer/markdown";
+      export let data;
+    </script>
+
+    <!-- 2. Trên client: Hiển thị trực tiếp AST mà không cần phân tích cú pháp lại -->
+    <MarkdownRenderer value={data.content} />
+    ```
+
+  </Tab>
+  <Tab label="Angular" value="angular">
+
+    Angular SSR thường giải quyết dữ liệu trên server trong lần tải đầu tiên và hydrat hóa trên client. Bạn có thể sử dụng resolver để truyền AST.
+
+    ```typescript fileName="app.resolver.ts"
+    import { Injectable } from "@angular/core";
+    import { Resolve } from "@angular/router";
+    import { parseMarkdown, type ParsedMarkdown } from "angular-intlayer/markdown";
+
+    @Injectable({ providedIn: "root" })
+    export class MarkdownResolver implements Resolve<ParsedMarkdown> {
+      resolve(): ParsedMarkdown {
+        const markdownString = "## My title \n\nLorem Ipsum";
+        // 1. Trên server: Phân tích cú pháp markdown thành AST có thể tuần tự hóa
+        return parseMarkdown(markdownString);
+      }
+    }
+    ```
+
+    ```typescript fileName="app.component.ts"
+    import { Component } from "@angular/core";
+    import { ActivatedRoute } from "@angular/router";
+    import { IntlayerMarkdownService, type ParsedMarkdown } from "angular-intlayer/markdown";
+
+    @Component({
+      selector: "app-root",
+      template: `<div [innerHTML]="renderedMarkdown"></div>`,
+    })
+    export class AppComponent {
+      renderedMarkdown: string = "";
+
+      constructor(
+        private route: ActivatedRoute,
+        private markdownService: IntlayerMarkdownService
+      ) {
+        // 2. Trên client: Hiển thị trực tiếp AST mà không cần phân tích cú pháp lại
+        this.route.data.subscribe((data) => {
+          this.renderedMarkdown = this.markdownService.renderMarkdown(
+            data.markdownAst
+          ) as string;
+        });
+      }
+    }
+    ```
+
+  </Tab>
+</Tabs>
+
+Mẫu này đảm bảo logic phân tích cú pháp Markdown được thực thi hoàn toàn trên server, giảm đáng kể thời gian thực thi phía client và cải thiện tốc độ hydrat hóa ban đầu.
+
 ## Tham chiếu tùy chọn
 
 Các tùy chọn này có thể được truyền đến `MarkdownProvider`, `MarkdownRenderer`, `useMarkdownRenderer` và `renderMarkdown`.

package/docs/vi/how_works_intlayer.md

@@ -106,9 +106,9 @@ Khi bạn gọi nội dung của mình bằng cách sử dụng `useIntlayer` v
 
 ## Tối ưu hóa build ứng dụng
 
-Để tối ưu kích thước gói của ứng dụng của bạn, Intlayer cung cấp hai plugin để tối ưu quá trình build ứng dụng của bạn: các plugin `@intlayer/babel` và `@intlayer/swc`.
+Để tối ưu kích thước bundle của ứng dụng của bạn, Intlayer cung cấp hai plugin để tối ưu quá trình build ứng dụng của bạn: các plugin `@intlayer/babel` và `@intlayer/swc`.
 
-Các plugin Babel và SWC hoạt động bằng cách phân tích Cây Cú Pháp Trừu Tượng (AST) của ứng dụng của bạn để thay thế các lời gọi hàm Intlayer bằng mã được tối ưu hóa. Quá trình này giúp gói cuối cùng của bạn nhẹ hơn trong môi trường production bằng cách đảm bảo chỉ những từ điển thực sự được sử dụng mới được nhập khẩu, tối ưu hóa việc chia nhỏ gói và giảm kích thước gói.
+Các plugin Babel và SWC hoạt động bằng cách phân tích Cây Cú Pháp Trừu Tượng (AST) của ứng dụng của bạn để thay thế các lời gọi hàm Intlayer bằng mã được tối ưu hóa. Quá trình này giúp gói cuối cùng của bạn nhẹ hơn trong môi trường production bằng cách đảm bảo chỉ những từ điển thực sự được sử dụng mới được nhập khẩu, tối ưu hóa việc chia nhỏ gói và giảm kích thước bundle.
 
 Trong chế độ phát triển, Intlayer sử dụng việc nhập khẩu tĩnh tập trung cho các từ điển nhằm đơn giản hóa trải nghiệm phát triển.