@intlayer/docs 8.9.6-canary.0 → 8.9.7

package/docs/ur/interest_of_intlayer.md

@@ -0,0 +1,237 @@
+---
+createdAt: 2024-08-14
+updatedAt: 2025-09-27
+title: Intlayer کی اہمیت
+description: اپنے پروجیکٹس میں Intlayer استعمال کرنے کے فوائد اور خوبیوں کو دریافت کریں۔ سمجھیں کہ Intlayer دوسرے فریم ورکس کے درمیان کیوں ممتاز ہے۔
+keywords:
+  - فوائد
+  - خوبیاں
+  - Intlayer
+  - فریم ورک
+  - موازنہ
+slugs:
+  - doc
+  - why
+history:
+  - version: 7.3.1
+    date: 2025-11-27
+    changes: "کمپائلر کی ریلیز"
+  - version: 5.8.0
+    date: 2025-08-19
+    changes: "تقابلی جدول اپ ڈیٹ کیا گیا"
+  - version: 5.5.10
+    date: 2025-06-29
+    changes: "ابتدائی تاریخ"
+---
+
+# آپ کو Intlayer پر کیوں غور کرنا چاہئے؟
+
+## Intlayer کیا ہے؟
+
+**Intlayer** ایک بین الاقوامی سازی (internationalization) لائبریری ہے جو خاص طور پر جاوا اسکرپٹ ڈویلپرز کے لیے ڈیزائن کی گئی ہے۔ یہ آپ کے کوڈ میں ہر جگہ اپنے مواد کا اعلان کرنے کی اجازت دیتی ہے۔ یہ کثیر لسانی مواد کے اعلانات کو آپ کے کوڈ میں آسانی سے ضم کرنے کے لیے منظم لغات میں تبدیل کرتی ہے۔ ٹائپ اسکرپٹ (TypeScript) کا استعمال کرتے ہوئے، **Intlayer** آپ کی ترقی کو مضبوط اور موثر بناتی ہے۔
+
+## Intlayer کیوں بنایا گیا؟
+
+Intlayer کو ایک عام مسئلے کو حل کرنے کے لیے بنایا گیا تھا جو تمام عام i18n لائبریریوں جیسے `next-intl` ، `react-i18next` ، `react-intl` ، `next-i18next` ، `react-intl` ، اور `vue-i18n` کو متاثر کرتا ہے۔
+
+یہ تمام حل آپ کے مواد کو درج کرنے اور منظم کرنے کے لیے ایک مرکزی نقطہ نظر اپناتے ہیں۔ مثال کے طور پر:
+
+```bash
+.
+├── locales
+│   ├── en.json
+│   ├── es.json
+│   └── fr.json
+├── i18n.ts
+└── src
+    └── components
+        └── MyComponent
+            └── index.tsx
+```
+
+یا یہاں نیم اسپیس (namespaces) کا استعمال کرتے ہوئے:
+
+```bash
+.
+├── locales
+│   ├── en
+│   │  ├── footer.json
+│   │  └── navbar.json
+│   ├── fr
+│   │  ├── footer.json
+│   │  └── navbar.json
+│   └── es
+│      ├── footer.json
+│      └── navbar.json
+├── i18n.ts
+└── src
+    └── components
+        └── MyComponent
+            └── index.tsx
+```
+
+اس قسم کا فن تعمیر ترقی کے عمل کو سست کر دیتا ہے اور کئی وجوہات کی بنا پر کوڈ بیس کو برقرار رکھنا زیادہ پیچیدہ بنا دیتا ہے:
+
+1. **کسی بھی نئے بنائے گئے جزو (component) کے لیے، آپ کو یہ کرنا چاہیے:**
+   - `locales` فولڈر میں نیا وسیلہ/نیم اسپیس بنائیں
+   - اپنے پیج میں نیا نیم اسپیس درآمد کرنا یاد رکھیں
+   - اپنے مواد کا ترجمہ کریں (اکثر AI فراہم کنندگان سے کاپی/پیسٹ کر کے دستی طور پر کیا جاتا ہے)
+
+2. **اپنے اجزاء میں کی جانے والی کسی بھی تبدیلی کے لیے، آپ کو یہ کرنا چاہیے:**
+   - متعلقہ وسیلہ/نیم اسپیس تلاش کریں (جزو سے دور)
+   - اپنے مواد کا ترجمہ کریں
+   - یقینی بنائیں کہ آپ کا مواد کسی بھی زبان کے لیے اپ ٹو ڈیٹ ہے
+   - تصدیق کریں کہ آپ کے نیم اسپیس میں غیر استعمال شدہ کلیدیں/قدریں شامل نہیں ہیں
+   - یقینی بنائیں کہ آپ کی JSON فائلوں کی ساخت تمام زبانوں کے لیے ایک جیسی ہے
+
+ان حلوں کا استعمال کرنے والے پیشہ ورانہ پروجیکٹس پر، اکثر لوکلائزیشن پلیٹ فارمز آپ کے مواد کے ترجمے کو منظم کرنے میں مدد کے لیے استعمال کیے جاتے ہیں۔ تاہم، بڑے پروجیکٹس کے لیے یہ تیزی سے مہنگا ہو سکتا ہے۔
+
+اس مسئلے کو حل کرنے کے لیے، Intlayer ایک ایسا نقطہ نظر اپناتا ہے جو آپ کے مواد کو فی جزو (per-component) اسکوپ کرتا ہے اور آپ کے مواد کو آپ کے جزو کے قریب رکھتا ہے، جیسا کہ ہم اکثر CSS (`styled-components`) ، اقسام (types) ، دستاویزات (`storybook`) ، یا یونٹ ٹیسٹ (`jest`) کے ساتھ کرتے ہیں۔
+
+```bash codeFormat="typescript"
+.
+└── components
+    └── MyComponent
+        ├── index.content.ts
+        ├── index.test.tsx
+        ├── index.stories.tsx
+        └── index.tsx
+```
+
+```bash codeFormat="commonjs"
+.
+└── components
+    └── MyComponent
+        ├── index.content.cjs
+        ├── index.test.mjs
+        ├── index.stories.mjs
+        └── index.tsx
+```
+
+```bash codeFormat="esm"
+.
+└── components
+    └── MyComponent
+        ├── index.content.mjs
+        ├── index.test.mjs
+        ├── index.stories.mjs
+        └── index.tsx
+```
+
+```tsx fileName="./components/MyComponent/index.content.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import { t, type Dictionary } from "intlayer";
+
+const componentExampleContent = {
+  key: "component-example",
+  content: {
+    myTranslatedContent: t({
+      en: "Hello World",
+      es: "Hola Mundo",
+      fr: "Bonjour le monde",
+    }),
+  },
+} satisfies Dictionary;
+
+export default componentExampleContent;
+```
+
+```tsx fileName="./components/MyComponent/index.tsx" codeFormat={["typescript", "esm"]}
+import { useIntlayer } from "react-intlayer";
+
+export const ComponentExample = () => {
+  const { myTranslatedContent } = useIntlayer("component-example");
+
+  return <span>{myTranslatedContent}</span>;
+};
+```
+
+یہ نقطہ نظر آپ کو درج ذیل کی اجازت دیتا ہے:
+
+1. **ترقی کی رفتار بڑھائیں**
+   - `.content.{{ts|mjs|cjs|json}}` فائلیں VSCode ایکسٹینشن کا استعمال کرتے ہوئے بنائی جا سکتی ہیں
+   - آپ کے IDE میں آٹو مکمل AI ٹولز (جیسے GitHub Copilot) آپ کو اپنے مواد کا اعلان کرنے میں مدد کر سکتے ہیں، جس سے کاپی/پیسٹ کم ہو جاتا ہے
+
+2. **اپنے کوڈ بیس کو صاف کریں**
+   - پیچیدگی کو کم کریں
+   - دیکھ بھال کی اہلیت کو بڑھائیں
+
+3. **اپنے اجزاء اور ان سے متعلقہ مواد کو زیادہ آسانی سے نقل کریں (مثال: لاگ ان/رجسٹر جزو، وغیرہ)**
+   - دوسرے اجزاء کے مواد کو متاثر کرنے کے خطرے کو محدود کر کے
+   - بیرونی انحصار کے بغیر اپنے مواد کو ایک ایپلیکیشن سے دوسری ایپلیکیشن میں کاپی/پیسٹ کر کے
+
+4. **غیر استعمال شدہ اجزاء کے لیے غیر استعمال شدہ کلیدوں/قدروں کے ساتھ اپنے کوڈ بیس کو آلودہ کرنے سے بچیں**
+   - اگر آپ کوئی جزو استعمال نہیں کرتے ہیں، تو Intlayer اس سے متعلقہ مواد درآمد نہیں کرے گا
+   - اگر آپ کسی جزو کو حذف کرتے ہیں، تو آپ کو اس سے متعلقہ مواد کو حذف کرنا زیادہ آسانی سے یاد رہے گا کیونکہ وہ اسی فولڈر میں موجود ہو گا
+
+5. **اپنے کثیر لسانی مواد کا اعلان کرنے کے لیے AI ایجنٹوں کے لیے استدلال کی لاگت کو کم کریں**
+   - AI ایجنٹ کو یہ جاننے کے لیے آپ کے پورے کوڈ بیس کو اسکین نہیں کرنا پڑے گا کہ آپ کا مواد کہاں لاگو کرنا ہے
+   - ترجمہ آپ کے IDE میں آٹو مکمل AI ٹولز (جیسے GitHub Copilot) کے ذریعے آسانی سے کیا جا سکتا ہے
+
+6. **لوڈنگ کی کارکردگی کو بہتر بنائیں**
+   - اگر کوئی جزو سست لوڈ (lazy-loaded) ہے، تو اس سے متعلقہ مواد اسی وقت لوڈ ہو گا
+
+## Intlayer کی اضافی خصوصیات
+
+| خصوصیت                                                                                                                    | تفصیل                                                                                                                                                                                                                                                                                                                                                                                             |
+| ------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| ![خصوصیت](https://github.com/aymericzip/intlayer/blob/main/docs/assets/frameworks.png?raw=true)                           | **کراس فریم ورک سپورٹ**<br><br>Intlayer تمام بڑے فریم ورکس اور لائبریریوں کے ساتھ مطابقت رکھتا ہے، بشمول Next.js، React، Vite، Vue.js، Nuxt، Preact، Express اور بہت کچھ۔                                                                                                                                                                                                                         |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/javascript_content_management.jpg?raw=true)       | **جاوا اسکرپٹ سے چلنے والا مواد کا انتظام**<br><br>اپنے مواد کو موثر طریقے سے بیان کرنے اور منظم کرنے کے لیے جاوا اسکرپٹ کی لچک سے فائدہ اٹھائیں۔ <br><br> - [مواد کا اعلان](https://intlayer.org/doc/concept/content)                                                                                                                                                                            |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/compiler.jpg?raw=true" alt="خصوصیت" width="700">   | **کمپائلر**<br><br>Intlayer کمپائلر اجزاء سے مواد کو خودکار طور پر نکالتا ہے اور لغت کی فائلیں تیار کرتا ہے۔<br><br> - [کمپائلر](https://intlayer.org/doc/compiler)                                                                                                                                                                                                                               |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/per_locale_content_declaration_file.png?raw=true) | **فی لوکیل مواد کے اعلان کی فائل**<br><br>خودکار جنریشن سے پہلے، اپنے مواد کا ایک بار اعلان کر کے اپنی ترقی کو تیز کریں۔<br><br> - [فی لوکیل مواد کے اعلان کی فائل](https://intlayer.org/doc/concept/per-locale-file)                                                                                                                                                                             |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/autocompletion.png?raw=true)                      | **ٹائپ سیف ماحول**<br><br>ٹائپ اسکرپٹ کا فائدہ اٹھائیں تاکہ یہ یقینی بنایا جا سکے کہ آپ کے مواد کی تعریفیں اور کوڈ غلطی سے پاک ہیں، جبکہ IDE آٹو مکمل سے بھی فائدہ اٹھائیں۔<br><br> - [ٹائپ اسکرپٹ کنفیگریشن](https://intlayer.org/doc/environment/vite-and-react#configure-typescript)                                                                                                           |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/config_file.png?raw=true)                         | **آسان سیٹ اپ**<br><br>کم سے کم کنفیگریشن کے ساتھ تیزی سے شروع کریں۔ بین الاقوامی سازی، روٹنگ، AI، بلڈ اور مواد کے انتظام کے لیے ترتیبات کو آسانی سے ایڈجسٹ کریں۔ <br><br> - [Next.js انٹیگریشن دریافت کریں](https://intlayer.org/doc/environment/nextjs)                                                                                                                                         |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/content_retrieval.png?raw=true)                   | **آسان مواد کی بازیافت**<br><br>مواد کے ہر ٹکڑے کے لیے اپنے `t` فنکشن کو کال کرنے کی ضرورت نہیں ہے۔ ایک ہی ہک کا استعمال کرتے ہوئے براہ راست اپنا تمام مواد حاصل کریں۔<br><br> - [React انٹیگریشن](https://intlayer.org/doc/environment/create-react-app)                                                                                                                                         |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/server_component.png?raw=true)                    | **مستقل سرور کمپوننٹ کا نفاذ**<br><br>Next.js سرور اجزاء کے لیے بالکل موزوں، کلائنٹ اور سرور دونوں اجزاء کے لیے ایک ہی عمل درآمد کا استعمال کریں، ہر سرور جزو کے ذریعے اپنے `t` فنکشن کو پاس کرنے کی ضرورت نہیں ہے۔ <br><br> - [سرور اجزاء](https://intlayer.org/doc/environment/nextjs#step-7-utilize-content-in-your-code)                                                                      |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/file_tree.png?raw=true)                           | **منظم کوڈ بیس**<br><br>اپنے کوڈ بیس کو زیادہ منظم رکھیں: 1 جزو = اسی فولڈر میں 1 لغت۔ ان کے متعلقہ اجزاء کے قریب تراجم دیکھ بھال کی اہلیت اور وضاحت کو بڑھاتے ہیں۔ <br><br> - [Intlayer کیسے کام کرتا ہے](https://intlayer.org/doc/concept/how-works-intlayer)                                                                                                                                   |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/url_routing.png?raw=true)                         | **بہتر روٹنگ**<br><br>Next.js، React، Vite، Vue.js وغیرہ کے لیے پیچیدہ ایپلیکیشن ڈھانچے کے ساتھ ہم آہنگی سے ڈھلنے والی ایپ روٹنگ کی مکمل سپورٹ۔<br><br> - [Next.js انٹیگریشن دریافت کریں](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                            |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/markdown.png?raw=true)                            | **مارک ڈاؤن سپورٹ**<br><br>پرائیویسی پالیسیوں، دستاویزات وغیرہ جیسے کثیر لسانی مواد کے لیے لوکل فائلیں اور ریموٹ مارک ڈاؤن درآمد اور تشریح کریں۔ مارک ڈاؤن میٹا ڈیٹا کی تشریح کریں اور اسے اپنے کوڈ میں قابل رسائی بنائیں۔<br><br> - [مواد کی فائلیں](https://intlayer.org/doc/concept/content/file)                                                                                              |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/visual_editor.png?raw=true)                       | **مفت ویژول ایڈیٹر اور CMS**<br><br>مواد لکھنے والوں کے لیے ایک مفت ویژول ایڈیٹر اور CMS دستیاب ہے، جو لوکلائزیشن پلیٹ فارم کی ضرورت کو ختم کرتا ہے۔ Git کا استعمال کرتے ہوئے اپنے مواد کو ہم آہنگ رکھیں، یا CMS کے ذریعے اسے مکمل یا جزوی طور پر بیرونی بنائیں۔<br><br> - [Intlayer ایڈیٹر](https://intlayer.org/doc/concept/editor) <br> - [Intlayer CMS](https://intlayer.org/doc/concept/cms) |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/bundle.png?raw=true)                              | **Tree-shakable مواد**<br><br>Tree-shakable مواد، جو حتمی بنڈل سائز کو کم کرتا ہے۔ فی جزو مواد لوڈ کرتا ہے، آپ کے بنڈل سے کسی بھی غیر استعمال شدہ مواد کو نکال کر۔ ایپ لوڈنگ کی کارکردگی بڑھانے کے لیے سست لوڈنگ (lazy loading) کی سپورٹ کرتا ہے۔ <br><br> - [ایپ بلڈ آپٹیمائزیشن](https://intlayer.org/doc/concept/how-works-intlayer#app-build-optimization)                                    |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/static_rendering.png?raw=true)                    | **اسٹیٹک رینڈرنگ**<br><br>اسٹیٹک رینڈرنگ کو نہیں روکتا۔ <br><br> - [Next.js انٹیگریشن](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                                                                                                                               |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/AI_translation.png?raw=true)                      | **AI سے چلنے والا ترجمہ**<br><br>اپنے ویب سائٹ کو صرف ایک کلک کے ساتھ Intlayer کے جدید AI سے چلنے والے ترجمہ ٹولز کے ذریعے 231 زبانوں میں تبدیل کریں، اپنے اپنے AI فراہم کنندہ/API کلید کے ساتھ۔ <br><br> - [CI/CD انٹیگریشن](https://intlayer.org/doc/concept/ci-cd) <br> - [Intlayer CLI](https://intlayer.org/doc/concept/cli) <br> - [آٹو فل](https://intlayer.org/doc/concept/auto-fill)     |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/mcp.png?raw=true)                                 | **MCP سرور انٹیگریشن**<br><br>IDE آٹومیشن کے لیے ایک MCP (Model Context Protocol) سرور فراہم کرتا ہے، جو آپ کے ترقیاتی ماحول کے اندر ہموار مواد کے انتظام اور i18n ورک فلو کو قابل بناتا ہے۔ <br><br> - [MCP سرور](https://github.com/aymericzip/intlayer/blob/main/docs/ur/mcp_server.md)                                                                                                        |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/vscode_extension.png?raw=true)                    | **VSCode ایکسٹینشن**<br><br>Intlayer آپ کے مواد اور تراجم کے انتظام، اپنی لغت تیار کرنے، اپنے مواد کا ترجمہ کرنے اور مزید بہت کچھ کرنے میں مدد کے لیے ایک VSCode ایکسٹینشن فراہم کرتا ہے۔ <br><br> - [VSCode ایکسٹینشن](https://intlayer.org/doc/vs-code-extension)                                                                                                                               |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/interoperability.png?raw=true)                    | **انٹرآپریبلٹی**<br><br>react-i18next، next-i18next، next-intl، اور react-intl کے ساتھ انٹرآپریبلٹی کو قابل بناتا ہے۔ <br><br> - [Intlayer اور react-intl](https://intlayer.org/blog/intlayer-with-react-intl) <br> - [Intlayer اور next-intl](https://intlayer.org/blog/intlayer-with-next-intl) <br> - [Intlayer اور next-i18next](https://intlayer.org/blog/intlayer-with-next-i18next)        |
+| لاپتہ تراجم کی جانچ (CLI/CI)                                                                                              | ✅ CLI: npx intlayer content test (CI دوست آڈٹ)                                                                                                                                                                                                                                                                                                                                                   |
+
+## دیگر حلوں کے ساتھ Intlayer کا موازنہ
+
+| خصوصیت                                           | `intlayer`                                                                                                                                                             | `react-i18next`                                                                                    | `react-intl` (FormatJS)                                                                                                  | `lingui`                                                                        | `next-intl`                                                                                        | `next-i18next`                                                                                     | `vue-i18n`                                                        |
+| ------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------- |
+| **اجزاء کے قریب تراجم**                          | ✅ ہاں، مواد ہر جزو کے ساتھ رکھا گیا ہے                                                                                                                                | ❌ نہیں                                                                                            | ❌ نہیں                                                                                                                  | ❌ نہیں                                                                         | ❌ نہیں                                                                                            | ❌ نہیں                                                                                            | ✅ ہاں - `Single File Components` (SFCs) استعمال کرتے ہوئے        |
+| **ٹائپ اسکرپٹ انٹیگریشن**                        | ✅ جدید، خودکار طور پر تیار کردہ سخت اقسام                                                                                                                             | ⚠️ بنیادی؛ سیکیورٹی کے لیے اضافی کنفیگریشن کی ضرورت ہے                                             | ✅ اچھا، لیکن کم سخت                                                                                                     | ⚠️ ٹائپنگ، کنفیگریشن کی ضرورت ہے                                                | ✅ اچھا                                                                                            | ⚠️ بنیادی                                                                                          | ✅ اچھا (اقسام دستیاب ہیں؛ کلیدی سیکیورٹی کے لیے سیٹ اپ ضروری ہے) |
+| **لاپتہ تراجم کی نشاندہی**                       | ✅ ٹائپ اسکرپٹ غلطی کی نشاندہی اور بلڈ ٹائم غلطی/انتباہ                                                                                                                | ⚠️ زیادہ تر رن ٹائم پر فال بیک (fallback) اسٹرنگز                                                  | ⚠️ فال بیک اسٹرنگز                                                                                                       | ⚠️ اضافی کنفیگریشن کی ضرورت ہے                                                  | ⚠️ رن ٹائم فال بیک                                                                                 | ⚠️ رن ٹائم فال بیک                                                                                 | ⚠️ رن ٹائم فال بیک/انتباہ (کنفیگر ایبل)                           |
+| **بھرپور مواد (JSX/Markdown/اجزاء)**             | ✅ براہ راست سپورٹ                                                                                                                                                     | ⚠️ محدود / صرف انٹرپولیشن                                                                          | ⚠️ ICU سنٹیکس، اصل JSX نہیں                                                                                              | ⚠️ محدود                                                                        | ❌ بھرپور نوڈس کے لیے ڈیزائن نہیں کیا گیا                                                          | ⚠️ محدود                                                                                           | ⚠️ محدود (`<i18n-t>` کے ذریعے اجزاء، پلگ انز کے ذریعے مارک ڈاؤن)  |
+| **AI سے چلنے والا ترجمہ**                        | ✅ ہاں، متعدد AI فراہم کنندگان کو سپورٹ کرتا ہے۔ آپ کی اپنی API کلیدوں کے ساتھ استعمال کیا جا سکتا ہے۔ آپ کی ایپلیکیشن کے سیاق و سباق اور مواد کے دائرے پر غور کرتا ہے | ❌ نہیں                                                                                            | ❌ نہیں                                                                                                                  | ❌ نہیں                                                                         | ❌ نہیں                                                                                            | ❌ نہیں                                                                                            | ❌ نہیں                                                           |
+| **ویژول ایڈیٹر**                                 | ✅ ہاں، مقامی ویژول ایڈیٹر + اختیاری CMS؛ کوڈ بیس مواد کو بیرونی بنا سکتا ہے؛ ایمبیڈ ایبل                                                                              | ❌ نہیں / بیرونی لوکلائزیشن پلیٹ فارمز کے ذریعے دستیاب                                             | ❌ نہیں / بیرونی لوکلائزیشن پلیٹ فارمز کے ذریعے دستیاب                                                                   | ❌ نہیں / بیرونی لوکلائزیشن پلیٹ فارمز کے ذریعے دستیاب                          | ❌ نہیں / بیرونی لوکلائزیشن پلیٹ فارمز کے ذریعے دستیاب                                             | ❌ نہیں / بیرونی لوکلائزیشن پلیٹ فارمز کے ذریعے دستیاب                                             | ❌ نہیں / بیرونی لوکلائزیشن پلیٹ فارمز کے ذریعے دستیاب            |
+| **مقامی روٹنگ**                                  | ✅ ہاں، مقامی راستوں کی آؤٹ آف دی باکس سپورٹ کرتا ہے (Next.js اور Vite کے ساتھ کام کرتا ہے)                                                                            | ⚠️ ان بلٹ نہیں، پلگ انز (جیسے `next-i18next`) یا کسٹم راؤٹر کنفیگریشن کی ضرورت ہے                  | ❌ نہیں، صرف پیغام کی فارمیٹنگ، روٹنگ دستی ہونی چاہیے                                                                    | ⚠️ ان بلٹ نہیں، پلگ انز یا دستی کنفیگریشن کی ضرورت ہے                           | ✅ ان بلٹ، App Router `[locale]` سیگمنٹ کی سپورٹ کرتا ہے                                           | ✅ ان بلٹ                                                                                          | ✅ ان بلٹ                                                         |
+| **ڈائنامک روٹ جنریشن**                           | ✅ ہاں                                                                                                                                                                 | ⚠️ پلگ ان/ایکو سسٹم یا دستی سیٹ اپ                                                                 | ❌ فراہم نہیں کیا گیا                                                                                                    | ⚠️ پلگ ان/دستی                                                                  | ✅ ہاں                                                                                             | ✅ ہاں                                                                                             | ❌ فراہم نہیں کیا گیا (Nuxt i18n فراہم کرتا ہے)                   |
+| **جمع بنانا (Pluralization)**                    | ✅ انم (enum) پر مبنی پیٹرنز                                                                                                                                           | ✅ کنفیگر ایبل (i18next-icu جیسے پلگ انز)                                                          | ✅ (ICU)                                                                                                                 | ✅ (ICU/messageformat)                                                          | ✅ اچھا                                                                                            | ✅ اچھا                                                                                            | ✅ ان بلٹ جمع کے قواعد                                            |
+| **فارمیٹنگ (تاریخیں، نمبرز، کرنسیاں)**           | ✅ بہتر فارمیٹرز (اندرونی طور پر Intl استعمال کرتا ہے)                                                                                                                 | ⚠️ پلگ انز یا کسٹم Intl استعمال کے ذریعے                                                           | ✅ ICU فارمیٹرز                                                                                                          | ✅ ICU/CLI ہیلپرز                                                               | ✅ اچھا (Intl ہیلپرز)                                                                              | ✅ اچھا (Intl ہیلپرز)                                                                              | ✅ ان بلٹ تاریخ/نمبر فارمیٹرز (Intl)                              |
+| **مواد کا فارمیٹ**                               | ✅ .tsx، .ts، .js، .json، .md، .txt، (.yaml کام جاری ہے)                                                                                                               | ⚠️ .json                                                                                           | ✅ .json، .js                                                                                                            | ⚠️ .po، .json                                                                   | ✅ .json، .js، .ts                                                                                 | ⚠️ .json                                                                                           | ✅ .json، .js                                                     |
+| **ICU سپورٹ**                                    | ⚠️ کام جاری ہے                                                                                                                                                         | ⚠️ پلگ ان (i18next-icu) کے ذریعے                                                                   | ✅ ہاں                                                                                                                   | ✅ ہاں                                                                          | ✅ ہاں                                                                                             | ⚠️ پلگ ان (`i18next-icu`) کے ذریعے                                                                 | ⚠️ کسٹم فارمیٹر/کمپائلر کے ذریعے                                  |
+| **SEO ہیلپرز (hreflang، sitemap)**               | ✅ ان بلٹ ٹولز: sitemap، robots.txt، میٹا ڈیٹا کے لیے ہیلپرز                                                                                                           | ⚠️ کمیونٹی پلگ انز/دستی                                                                            | ❌ کور نہیں                                                                                                              | ❌ کور نہیں                                                                     | ✅ اچھا                                                                                            | ✅ اچھا                                                                                            | ❌ کور نہیں (Nuxt i18n ہیلپرز فراہم کرتا ہے)                      |
+| **ایکو سسٹم / کمیونٹی**                          | ⚠️ چھوٹا لیکن تیزی سے بڑھ رہا ہے اور جوابدہ ہے                                                                                                                         | ✅ سب سے بڑا اور پختہ                                                                              | ✅ بڑا                                                                                                                   | ⚠️ چھوٹا                                                                        | ✅ درمیانے درجے کا، Next.js پر مرکوز                                                               | ✅ درمیانے درجے کا، Next.js پر مرکوز                                                               | ✅ Vue ایکو سسٹم میں بڑا                                          |
+| **سرور سائیڈ رینڈرنگ اور سرور اجزاء**            | ✅ ہاں، SSR / React سرور اجزاء کے لیے بہتر                                                                                                                             | ⚠️ پیج لیول پر سپورٹ ہے لیکن ذیلی سرور اجزاء کے لیے اجزاء کے درخت پر t-فنکشنز پاس کرنے کی ضرورت ہے | ⚠️ اضافی سیٹ اپ کے ساتھ پیج لیول پر سپورٹ ہے، لیکن ذیلی سرور اجزاء کے لیے اجزاء کے درخت پر t-فنکشنز پاس کرنے کی ضرورت ہے | ✅ سپورٹ ہے، سیٹ اپ کی ضرورت ہے                                                 | ⚠️ پیج لیول پر سپورٹ ہے لیکن ذیلی سرور اجزاء کے لیے اجزاء کے درخت پر t-فنکشنز پاس کرنے کی ضرورت ہے | ⚠️ پیج لیول پر سپورٹ ہے لیکن ذیلی سرور اجزاء کے لیے اجزاء کے درخت پر t-فنکشنز پاس کرنے کی ضرورت ہے | ✅ Nuxt/Vue SSR کے ذریعے SSR (RSC نہیں)                           |
+| **Tree-shaking (صرف استعمال شدہ مواد لوڈ کریں)** | ✅ ہاں، بیبل/SWC پلگ انز کے ذریعے بلڈ ٹائم پر فی جزو                                                                                                                   | ⚠️ عام طور پر سب لوڈ کرتا ہے (نیم اسپیس/کوڈ اسپلٹنگ کے ساتھ بہتر کیا جا سکتا ہے)                   | ⚠️ عام طور پر سب لوڈ کرتا ہے                                                                                             | ❌ ڈیفالٹ نہیں                                                                  | ⚠️ جزوی                                                                                            | ⚠️ جزوی                                                                                            | ⚠️ جزوی (کوڈ اسپلٹنگ/دستی سیٹ اپ کے ساتھ)                         |
+| **سست لوڈنگ (Lazy loading)**                     | ✅ ہاں، فی لوکیل / فی لغت                                                                                                                                              | ✅ ہاں (مثلاً، آن ڈیمانڈ بیک اینڈز/نیم اسپیس)                                                      | ✅ ہاں (منقسم لوکیل بنڈلز)                                                                                               | ✅ ہاں (ڈائنامک کیٹلاگ امپورٹس)                                                 | ✅ ہاں (فی روٹ/فی لوکیل)، نیم اسپیس مینجمنٹ کی ضرورت ہے                                            | ✅ ہاں (فی روٹ/فی لوکیل)، نیم اسپیس مینجمنٹ کی ضرورت ہے                                            | ✅ ہاں (غیر ہم آہنگ لوکیل پیغامات)                                |
+| **غیر استعمال شدہ مواد صاف کریں**                | ✅ ہاں، بلڈ ٹائم پر فی لغت                                                                                                                                             | ❌ نہیں، صرف دستی نیم اسپیس تقسیم کے ذریعے                                                         | ❌ نہیں، تمام اعلانیہ پیغامات بنڈل ہو جاتے ہیں                                                                           | ✅ ہاں، غیر استعمال شدہ کلیدوں کا پتہ لگایا جاتا ہے اور بلڈ پر نکال دیا جاتا ہے | ❌ نہیں، نیم اسپیس مینجمنٹ کے ساتھ دستی طور پر منظم کیا جا سکتا ہے                                 | ❌ नहीं، نیم اسپیس مینجمنٹ کے ساتھ دستی طور پر منظم کیا جا سکتا ہے                                 | ❌ نہیں، صرف دستی سست لوڈنگ کے ذریعے ممکن ہے                      |
+| **بڑے پروجیکٹ مینجمنٹ**                          | ✅ ماڈیولریٹی کی حوصلہ افزائی کرتا ہے، ڈیزائن سسٹمز کے لیے موزوں ہے                                                                                                    | ⚠️ اچھی فائل ڈسپلن کی ضرورت ہے                                                                     | ⚠️ مرکزی کیٹلاگز بڑے ہو سکتے ہیں                                                                                         | ⚠️ پیچیدہ ہو سکتا ہے                                                            | ✅ سیٹ اپ کے ساتھ ماڈیولر                                                                          | ✅ سیٹ اپ کے ساتھ ماڈیولر                                                                          | ✅ Vue Router/Nuxt i18n سیٹ اپ کے ساتھ ماڈیولر                    |
+
+---
+
+## GitHub ستارے
+
+GitHub ستارے کسی پروجیکٹ کی مقبولیت، کمیونٹی کے اعتماد اور طویل مدتی مطابقت کا ایک مضبوط اشارہ ہیں۔ اگرچہ یہ تکنیکی معیار کی براہ راست پیمائش نہیں ہے، وہ اس بات کی عکاسی کرتے ہیں کہ کتنے ڈویلپرز پروجیکٹ کو مفید پاتے ہیں، اس کی پیشرفت کی پیروی کرتے ہیں، اور اسے اپنانے کا امکان رکھتے ہیں۔ کسی پروجیکٹ کی قدر کا اندازہ لگانے کے لیے، ستارے متبادلات کے درمیان کشش کا موازنہ کرنے میں مدد کرتے ہیں اور ماحولیاتی نظام کی ترقی کے بارے میں بصیرت فراہم کرتے ہیں۔
+
+[![Star History Chart](https://api.star-history.com/svg?repos=formatjs/formatjs&repos=i18next/react-i18next&repos=i18next/i18next&repos=i18next/next-i18next&repos=lingui/js-lingui&repos=amannn/next-intl&repos=intlify/vue-i18n&repo=opral/paraglide-js&repos=aymericzip/intlayer&repos=opral/inlang&type=Date)](https://api.star-history.com/chart?repos=formatjs/formatjs%2Ci18next/react-i18next%2Ci18next/i18next%2Ci18next/next-i18next%2Clingui/js-lingui%2Amannn/next-intl%2Cintlify/vue-i18n%2Caymericzip/intlayer%2Copral/inlang&type=date&legend=top-left)
+
+---
+
+## انٹرآپریبلٹی
+
+`intlayer` آپ کے `react-intl` ، `react-i18next` ، `next-intl` ، `next-i18next` ، اور `vue-i18n` نیم اسپیس کو سنبھالنے میں بھی مدد کر سکتا ہے۔
+
+`intlayer` کا استعمال کرتے ہوئے، آپ اپنی پسندیدہ i18n لائبریری کے فارمیٹ میں اپنے مواد کا اعلان کر سکتے ہیں، اور intlayer آپ کی پسند کی جگہ پر آپ کے نیم اسپیس تیار کرے گا (مثال: `/messages/{{locale}}/{{namespace}}.json`)۔
+
+مزید تفصیلات کے لیے [`dictionaryOutput` اور `i18nextResourcesDir` آپشنز](https://intlayer.org/doc/concept/configuration#content-configuration) کو دیکھیں۔

package/docs/vi/benchmark/nextjs.md

@@ -36,14 +36,14 @@ Trang này là báo cáo benchmark cho các giải pháp i18n trên Next.js.
 
 ## Tham chiếu kết quả:
 
-<iframe 
-  src="https://intlayer.org/markdown?url=https%3A%2F%2Fraw.githubusercontent.com%2Fintlayer-org%2Fbenchmark-i18n%2Fmain%2Freport%2Fscripts%2Fsummarize-nextjs.md" 
-  width="100%" 
-  height="600px"
-  style="border:none;">
-</iframe>
+<ClickToOpenIframe
+src="https://intlayer.org/markdown?url=https%3A%2F%2Fraw.githubusercontent.com%2Fintlayer-org%2Fbenchmark-i18n%2Fmain%2Freport%2Fscripts%2Fsummarize-nextjs.md"
+width="100%"
+height="600px"
+style="border:none;"
+/>
 
-> https://intlayer.org/markdown?url=https%3A%2F%2Fraw.githubusercontent.com%2Fintlayer-org%2Fbenchmark-i18n%2Fmain%2Freport%2Fscripts%2Fsummarize-nextjs.md
+> [Xem dữ liệu benchmark đầy đủ](https://intlayer.org/markdown?url=https%3A%2F%2Fraw.githubusercontent.com%2Fintlayer-org%2Fbenchmark-i18n%2Fmain%2Freport%2Fscripts%2Fsummarize-nextjs.md)
 
 Xem kho lưu trữ benchmark đầy đủ [tại đây](https://github.com/intlayer-org/benchmark-i18n).
 
@@ -72,7 +72,7 @@ Intlayer cố gắng tối ưu hóa trên tất cả các khía cạnh này.
 
 Để làm rõ các vấn đề này, tôi đã xây dựng một trình quét miễn phí mà bạn có thể thử [tại đây](https://intlayer.org/i18n-seo-scanner).
 
-<iframe src="https://intlayer.org/i18n-seo-scanner" width="100%" height="600px" style="border:none;"/>
+<ClickToOpenIframe src="https://intlayer.org/i18n-seo-scanner" width="100%" height="600px" style="border:none;"/>
 
 ## Vấn đề
 

package/docs/vi/benchmark/solid.md

@@ -36,14 +36,14 @@ Trang này là báo cáo benchmark cho các giải pháp i18n trên Solid.
 
 ## Tham chiếu kết quả:
 
-<iframe 
-  src="https://intlayer.org/markdown?url=https%3A%2F%2Fraw.githubusercontent.com%2Fintlayer-org%2Fbenchmark-i18n%2Fmain%2Freport%2Fscripts%2Fsummarize-vite_solid.md" 
-  width="100%" 
-  height="600px"
-  style="border:none;">
-</iframe>
+<ClickToOpenIframe
+src="https://intlayer.org/markdown?url=https%3A%2F%2Fraw.githubusercontent.com%2Fintlayer-org%2Fbenchmark-i18n%2Fmain%2Freport%2Fscripts%2Fsummarize-vite_solid.md"
+width="100%"
+height="600px"
+style="border:none;"
+/>
 
-> https://intlayer.org/markdown?url=https%3A%2F%2Fraw.githubusercontent.com%2Fintlayer-org%2Fbenchmark-i18n%2Fmain%2Freport%2Fscripts%2Fsummarize-vite_solid.md
+> [Xem dữ liệu benchmark đầy đủ](https://intlayer.org/markdown?url=https%3A%2F%2Fraw.githubusercontent.com%2Fintlayer-org%2Fbenchmark-i18n%2Fmain%2Freport%2Fscripts%2Fsummarize-vite_solid.md)
 
 Xem toàn bộ kho lưu trữ benchmark [tại đây](https://github.com/intlayer-org/benchmark-i18n/tree/main).
 
@@ -68,7 +68,7 @@ Tác động khác là đối với trải nghiệm nhà phát triển (DX): cá
 
 Để nhanh chóng phát hiện các vấn đề rò rỉ i18n, tôi đã thiết lập một trình quét miễn phí có sẵn [tại đây](https://intlayer.org/i18n-seo-scanner).
 
-<iframe src="https://intlayer.org/i18n-seo-scanner" width="100%" height="600px" style="border:none;"/>
+<ClickToOpenIframe src="https://intlayer.org/i18n-seo-scanner" width="100%" height="600px" style="border:none;"/>
 
 ## Vấn đề
 

package/docs/vi/benchmark/svelte.md

@@ -36,14 +36,14 @@ Trang này là báo cáo benchmark cho các giải pháp i18n trên Svelte.
 
 ## Tham chiếu kết quả:
 
-<iframe 
-  src="https://intlayer.org/markdown?url=https%3A%2F%2Fraw.githubusercontent.com%2Fintlayer-org%2Fbenchmark-i18n%2Fmain%2Freport%2Fscripts%2Fsummarize-vite_svelte.md" 
-  width="100%" 
-  height="600px"
-  style="border:none;">
-</iframe>
+<ClickToOpenIframe
+src="https://intlayer.org/markdown?url=https%3A%2F%2Fraw.githubusercontent.com%2Fintlayer-org%2Fbenchmark-i18n%2Fmain%2Freport%2Fscripts%2Fsummarize-vite_svelte.md"
+width="100%"
+height="600px"
+style="border:none;"
+/>
 
-> https://intlayer.org/markdown?url=https%3A%2F%2Fraw.githubusercontent.com%2Fintlayer-org%2Fbenchmark-i18n%2Fmain%2Freport%2Fscripts%2Fsummarize-vite_svelte.md
+> [Xem dữ liệu benchmark đầy đủ](https://intlayer.org/markdown?url=https%3A%2F%2Fraw.githubusercontent.com%2Fintlayer-org%2Fbenchmark-i18n%2Fmain%2Freport%2Fscripts%2Fsummarize-vite_svelte.md)
 
 Xem toàn bộ kho lưu trữ benchmark [tại đây](https://github.com/intlayer-org/benchmark-i18n/tree/main).
 
@@ -67,7 +67,7 @@ Tác động khác là đối với trải nghiệm nhà phát triển (DX): cá
 
 Để nhanh chóng phát hiện các vấn đề rò rỉ i18n, tôi đã thiết lập một trình quét miễn phí có sẵn [tại đây](https://intlayer.org/i18n-seo-scanner).
 
-<iframe src="https://intlayer.org/i18n-seo-scanner" width="100%" height="600px" style="border:none;"/>
+<ClickToOpenIframe src="https://intlayer.org/i18n-seo-scanner" width="100%" height="600px" style="border:none;"/>
 
 ## Vấn đề
 

package/docs/vi/benchmark/tanstack.md

@@ -36,14 +36,14 @@ Trang này là báo cáo benchmark cho các giải pháp i18n trên TanStack Sta
 
 ## Tham chiếu kết quả:
 
-<iframe 
-  src="https://intlayer.org/markdown?url=https%3A%2F%2Fraw.githubusercontent.com%2Fintlayer-org%2Fbenchmark-i18n%2Fmain%2Freport%2Fscripts%2Fsummarize-tanstack.md" 
-  width="100%" 
+<ClickToOpenIframe
+  src="https://intlayer.org/markdown?url=https%3A%2F%2Fraw.githubusercontent.com%2Fintlayer-org%2Fbenchmark-i18n%2Fmain%2Freport%2Fscripts%2Fsummarize-tanstack.md"
+  width="100%"
   height="600px"
-  style="border:none;">
-</iframe>
+  style="border:none;"
+/>
 
-> https://intlayer.org/markdown?url=https%3A%2F%2Fraw.githubusercontent.com%2Fintlayer-org%2Fbenchmark-i18n%2Fmain%2Freport%2Fscripts%2Fsummarize-tanstack.md
+> [Xem dữ liệu benchmark đầy đủ](https://intlayer.org/markdown?url=https%3A%2F%2Fraw.githubusercontent.com%2Fintlayer-org%2Fbenchmark-i18n%2Fmain%2Freport%2Fscripts%2Fsummarize-tanstack.md)
 
 Xem kho lưu trữ benchmark đầy đủ [tại đây](https://github.com/intlayer-org/benchmark-i18n/tree/main).
 
@@ -68,7 +68,7 @@ Tác động khác là đối với trải nghiệm phát triển (DX): cách b
 
 Để nhanh chóng phát hiện các vấn đề rò rỉ i18n, tôi đã thiết lập một trình quét miễn phí có sẵn [tại đây](https://intlayer.org/i18n-seo-scanner).
 
-<iframe src="https://intlayer.org/i18n-seo-scanner" width="100%" height="600px" style="border:none;"/>
+<ClickToOpenIframe src="https://intlayer.org/i18n-seo-scanner" width="100%" height="600px" style="border:none;"/>
 
 ## Vấn đề
 

package/docs/vi/benchmark/vue.md

@@ -36,14 +36,14 @@ Trang này là báo cáo benchmark cho các giải pháp i18n trên Vue.
 
 ## Tham chiếu kết quả:
 
-<iframe 
-  src="https://intlayer.org/markdown?url=https%3A%2F%2Fraw.githubusercontent.com%2Fintlayer-org%2Fbenchmark-i18n%2Fmain%2Freport%2Fscripts%2Fsummarize-vite_vue.md" 
-  width="100%" 
-  height="600px"
-  style="border:none;">
-</iframe>
+<ClickToOpenIframe
+src="https://intlayer.org/markdown?url=https%3A%2F%2Fraw.githubusercontent.com%2Fintlayer-org%2Fbenchmark-i18n%2Fmain%2Freport%2Fscripts%2Fsummarize-vite_vue.md"
+width="100%"
+height="600px"
+style="border:none;"
+/>
 
-> https://intlayer.org/markdown?url=https%3A%2F%2Fraw.githubusercontent.com%2Fintlayer-org%2Fbenchmark-i18n%2Fmain%2Freport%2Fscripts%2Fsummarize-vite_vue.md
+> [Xem dữ liệu benchmark đầy đủ](https://intlayer.org/markdown?url=https%3A%2F%2Fraw.githubusercontent.com%2Fintlayer-org%2Fbenchmark-i18n%2Fmain%2Freport%2Fscripts%2Fsummarize-vite_vue.md)
 
 Xem toàn bộ kho lưu trữ benchmark [tại đây](https://github.com/intlayer-org/benchmark-i18n/tree/main).
 
@@ -67,7 +67,7 @@ Tác động khác là đối với trải nghiệm nhà phát triển (DX): cá
 
 Để nhanh chóng phát hiện các vấn đề rò rỉ i18n, tôi đã thiết lập một trình quét miễn phí có sẵn [tại đây](https://intlayer.org/i18n-seo-scanner).
 
-<iframe src="https://intlayer.org/i18n-seo-scanner" width="100%" height="600px" style="border:none;"/>
+<ClickToOpenIframe src="https://intlayer.org/i18n-seo-scanner" width="100%" height="600px" style="border:none;"/>
 
 ## Vấn đề