@intlayer/docs 8.6.1 → 8.6.10

package/docs/ur/cli/index.md

@@ -0,0 +1,195 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2026-03-31
+title: CLI - آپ کی کثیر لسانی ویب سائٹ کے لیے تمام Intlayer CLI کمانڈز
+description: اپنی کثیر لسانی ویب سائٹ کو منظم کرنے کے لیے Intlayer CLI کا استعمال سیکھیں۔ چند منٹوں میں اپنے پروجیکٹ کو ترتیب دینے کے لیے اس آن لائن دستاویزات کے مراحل پر عمل کریں۔
+keywords:
+  - CLI
+  - کمانڈ لائن انٹرفیس
+  - بین الاقوامی کاری
+  - دستاویزات
+  - Intlayer
+  - Next.js
+  - JavaScript
+  - React
+slugs:
+  - doc
+  - concept
+  - cli
+history:
+  - version: 8.6.4
+    date: 2026-03-31
+    changes: "اسٹینڈ اکیلے (standalone) کمانڈ کا مواد شامل کیا گیا"
+  - version: 7.5.11
+    date: 2026-01-06
+    changes: "CI کمانڈ کا مواد شامل کیا گیا"
+  - version: 7.5.11
+    date: 2026-01-06
+    changes: "پروجیکٹس کی فہرست (list projects) کمانڈ شامل کی گئی"
+  - version: 7.5.9
+    date: 2025-12-30
+    changes: "انیشئیلائز (init) کمانڈ شامل کی گئی"
+  - version: 7.2.3
+    date: 2025-11-22
+    changes: "ایکسٹریکٹ (extract) کمانڈ شامل کی گئی"
+  - version: 7.1.0
+    date: 2025-11-05
+    changes: "ترجمہ کمانڈ میں skipIfExists آپشن شامل کیا گیا"
+  - version: 6.1.4
+    date: 2025-01-27
+    changes: "CLI دلائل اور کمانڈز کے لیے عرفی نام (aliases) شامل کیے گئے"
+  - version: 6.1.3
+    date: 2025-10-05
+    changes: "کمانڈز میں بلڈ آپشن شامل کیا گیا"
+  - version: 6.1.2
+    date: 2025-09-26
+    changes: "ورژن کمانڈ شامل کی گئی"
+  - version: 6.1.0
+    date: 2025-09-26
+    changes: "CLI کے ذریعے verbose آپشن کو ڈیفالٹ طور پر true سیٹ کیا گیا"
+  - version: 6.1.0
+    date: 2025-09-23
+    changes: "واچ (watch) کمانڈ اور with آپشن شامل کیا گیا"
+  - version: 6.0.1
+    date: 2025-09-23
+    changes: "ایڈیٹر کمانڈ شامل کی گئی"
+  - version: 6.0.0
+    date: 2025-09-17
+    changes: "کنٹینٹ ٹیسٹ اور لسٹ کمانڈز شامل کی گئیں"
+  - version: 5.5.11
+    date: 2025-07-11
+    changes: "CLI کمانڈ پیرامیٹرز کی دستاویزات اپ ڈیٹ کی گئیں"
+  - version: 5.5.10
+    date: 2025-06-29
+    changes: "تاریخ کا آغاز"
+---
+
+# Intlayer CLI - آپ کی کثیر لسانی ویب سائٹ کے لیے تمام Intlayer CLI کمانڈز
+
+---
+
+## فہرست مواد
+
+<TOC/>
+
+---
+
+## پیکیج نصب کرنا
+
+npm کا استعمال کرتے ہوئے ضروری پیکیجز نصب کریں:
+
+```bash packageManager="npm"
+npm install intlayer-cli -g
+```
+
+```bash packageManager="yarn"
+yarn add intlayer-cli -g
+```
+
+```bash packageManager="pnpm"
+pnpm add intlayer-cli -g
+```
+
+```bash packageManager="bun"
+bun add intlayer-cli -g
+```
+
+> اگر `intlayer` پیکیج پہلے ہی نصب ہے، تو CLI خود بخود نصب ہو جاتی ہے۔ آپ اس مرحلے کو چھوڑ سکتے ہیں۔
+
+## intlayer-cli پیکیج
+
+`intlayer-cli` پیکیج آپ کے [Intlayer اعلانات](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/dictionary/content_file.md) کو لغات (dictionaries) میں ٹرانسپائل کرنے کے لیے ڈیزائن کیا گیا ہے۔
+
+یہ پیکیج تمام Intlayer فائلوں کو ٹرانسپائل کرتا ہے، جیسے: `src/**/*.content.{ts|js|mjs|cjs|json}`۔ [دیکھیں کہ اپنی Intlayer اعلان فائلوں کا اعلان کیسے کریں](https://github.com/aymericzip/intlayer/blob/main/packages/intlayer/README.md)۔
+
+Intlayer لغات کی تشریح کرنے کے لیے، آپ انٹرپریٹرز استعمال کر سکتے ہیں، جیسے: [react-intlayer](https://www.npmjs.com/package/react-intlayer) یا [next-intlayer](https://www.npmjs.com/package/next-intlayer)۔
+
+## کنفیگ فائل تعاون
+
+Intlayer کئی کنفیگریشن فائل فارمیٹس قبول کرتا ہے:
+
+- `intlayer.config.ts`
+- `intlayer.config.js`
+- `intlayer.config.json`
+- `intlayer.config.cjs`
+- `intlayer.config.mjs`
+- `.intlayerrc`
+
+دستیاب زبانوں یا دیگر پیرامیٹرز کو ترتیب دینے کا طریقہ سیکھنے کے لیے، [یہاں کنفیگریشن دستاویزات](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/configuration.md) دیکھیں۔
+
+## Intlayer کمانڈز چلانا
+
+### توثیق (Authentication)
+
+- **[لاگ ان](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/login.md)** - Intlayer CMS سے توثیق کریں اور رسائی کی اسناد حاصل کریں
+
+### بنیادی کمانڈز
+
+- **[Build Dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/cli/build.md)** - اپنے مواد کے اعلان والی فائلوں سے اپنی لغات بنائیں
+- **[Watch Dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/cli/watch.md)** - تبدیلیوں کی نگرانی کریں اور لغات کو خود بخود دوبارہ بنائیں
+- **[Create Standalone Bundle](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/cli/standalone.md)** - Intlayer اور متعین پیکیجز پر مشتمل ایک اسٹینڈ اکیلے JavaScript بنڈل تیار کریں
+- **[Check CLI Version](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/cli/version.md)** - نصب شدہ Intlayer CLI ورژن چیک کریں
+- **[List Projects](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/cli/list_projects.md)** - ڈائریکٹری یا گٹ ریپوزٹری میں موجود تمام Intlayer پروجیکٹس کی فہرست دیکھیں
+
+### لغت کا انتظام
+
+- **[Push Dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/cli/push.md)** - لغات کو Intlayer ایڈیٹر اور CMS پر بھیجیں
+- **[Pull Dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/cli/pull.md)** - Intlayer ایڈیٹر اور CMS سے لغات لائیں (fetch)
+- **[Fill Dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/cli/fill.md)** - AI کا استعمال کرتے ہوئے لغات کو پُر کریں، آڈٹ کریں اور ترجمہ کریں
+- **[Test Missing Translations](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/cli/test.md)** - لاپتہ تراجم کی جانچ اور نشاندہی کریں
+- **[List Content Declaration Files](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/cli/list.md)** - اپنے پروجیکٹ میں مواد کے اعلان والی تمام فائلوں کی فہرست دیکھیں
+
+### جزو کا انتظام (Component Management)
+
+- **[Extract Strings](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/cli/extract.md)** - جزو کے قریب ایک .content فائل میں اجزاء سے اسٹرنگز نکالیں
+
+### کنفیگریشن
+
+- **[Initialize Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/cli/init.md)** - خودکار کنفیگریشن کے ساتھ اپنے پروجیکٹ میں Intlayer ترتیب دیں
+- **[Manage Configuration](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/cli/configuration.md)** - اپنی Intlayer کنفیگریشن حاصل کریں اور اسے CMS پر بھیجیں
+
+### دستاویز کا انتظام (Doc Management)
+
+- **[Translate Document](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/cli/doc-translate.md)** - AI کا استعمال کرتے ہوئے دستاویزات کی فائلوں کا خودکار ترجمہ کریں
+- **[Review Document](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/cli/doc-review.md)** - معیار اور مطابقت کے لیے دستاویزات کی فائلوں کا جائزہ لیں
+
+### ایڈیٹر اور لائیو سنک (Live Sync)
+
+- **[Editor Commands](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/cli/editor.md)** - Intlayer ایڈیٹر کمانڈز استعمال کریں
+- **[Live Sync Commands](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/cli/live.md)** - CMS سے مواد کی تبدیلیوں کو ریئل ٹائم میں لاگو کرنے کے لیے لائیو سنک کا استعمال کریں
+
+### CI/CD اور خودکاری
+
+- **[CI Command](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/cli/ci.md)** - CI/CD پائپ لائنز کے لیے خودکار طور پر شامل اسناد کے ساتھ Intlayer کمانڈز پر عمل کریں
+
+### ڈویلپر ٹولز
+
+- **[CLI SDK](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/cli/sdk.md)** - اپنے کوڈ میں Intlayer CLI SDK استعمال کریں
+- **[Debug Intlayer Command](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/cli/debug.md)** - Intlayer CLI کے مسائل کوڈیبگ کریں اور حل کریں
+
+## اپنی `package.json` فائل میں intlayer کمانڈز استعمال کریں
+
+```json fileName="package.json"
+"scripts": {
+  "intlayer:init": "npx intlayer init",
+  "intlayer:login": "npx intlayer login",
+  "intlayer:build": "npx intlayer build",
+  "intlayer:watch": "npx intlayer build --watch",
+  "intlayer:standalone": "npx intlayer standalone --packages intlayer vanilla-intlayer",
+  "intlayer:push": "npx intlayer push",
+  "intlayer:pull": "npx intlayer pull",
+  "intlayer:fill": "npx intlayer fill",
+  "intlayer:list": "npx intlayer content list",
+  "intlayer:test": "npx intlayer content test",
+  "intlayer:extract": "npx intlayer extract",
+  "intlayer:projects": "npx intlayer projects list",
+  "intlayer:doc:translate": "npx intlayer doc translate",
+  "intlayer:doc:review": "npx intlayer doc review"
+}
+```
+
+> **نوٹ**: آپ چھوٹے عرفی نام (short aliases) بھی استعمال کر سکتے ہیں:
+>
+> - `npx intlayer list`: یہ `npx intlayer content list` کی جگہ لیتا ہے
+> - `npx intlayer test`: یہ `npx intlayer content test` کی جگہ لیتا ہے
+> - `npx intlayer projects-list` یا `npx intlayer pl`: یہ `npx intlayer projects list` کی جگہ لیتا ہے

package/docs/ur/cli/init.md

@@ -0,0 +1,96 @@
+---
+createdAt: 2025-12-30
+updatedAt: 2025-12-30
+title: Intlayer شروع کریں (Init)
+description: سیکھیں کہ اپنے پروجیکٹ میں Intlayer کو کیسے شروع کیا جائے۔
+keywords:
+  - شروع (Init)
+  - CLI
+  - Intlayer
+  - AI
+slugs:
+  - doc
+  - concept
+  - cli
+  - init
+history:
+  - version: 8.6.4
+    date: 2026-03-31
+    changes: "--no-gitignore آپشن شامل کیا گیا"
+  - version: 7.5.9
+    date: 2025-12-30
+    changes: "init کمانڈ کا مواد شامل کیا گیا"
+---
+
+# Intlayer شروع کریں (Init)
+
+```bash
+npx intlayer init
+```
+
+`init` کمانڈ ضروری فائلیں اور ترتیبات بنا کر آپ کے پروجیکٹ میں Intlayer کو خودکار طور پر کنفیگر کرتی ہے۔ Intlayer کے ساتھ شروع کرنے کا یہ تجویز کردہ طریقہ ہے۔
+
+## عرفی نام (Aliases):
+
+- `npx intlayer init`
+
+## دلائل (Arguments):
+
+- `--project-root [projectRoot]` - اختیاری۔ پروجیکٹ کی جڑ (root) ڈائریکٹری متعین کریں۔ اگر نہیں دی گئی، تو کمانڈ موجودہ ورکنگ ڈائریکٹری سے شروع کر کے پروجیکٹ روٹ تلاش کرے گی۔
+- `--no-gitignore` - اختیاری۔ `.gitignore` فائل کی خودکار اپ ڈیٹ کو نظر انداز کرتا ہے۔ اگر یہ فلیگ لگا ہو، تو `.intlayer` کو `.gitignore` میں شامل نہیں کیا جائے گا۔
+
+## یہ کیا کرتا ہے:
+
+`init` کمانڈ درج ذیل سیٹ اپ کام انجام دیتی ہے:
+
+1. **پروجیکٹ کے ڈھانچے کی تصدیق** - یقینی بناتی ہے کہ آپ ایک درست پروجیکٹ ڈائریکٹری میں ہیں جس میں `package.json` فائل موجود ہے۔
+2. **`.gitignore` کو اپ ڈیٹ کرنا** - آپ کی `.gitignore` فائل میں `.intlayer` شامل کرتی ہے تاکہ تیار کردہ فائلوں کو ورژن کنٹرول سے خارج کیا جا سکے (`--no-gitignore` کے ذریعے اسے نظر انداز کیا جا سکتا ہے)۔
+3. **TypeScript کو کنفیگر کرنا** - کسی بھی `tsconfig.json` فائلوں کو اپ ڈیٹ کرتی ہے تاکہ Intlayer کی ٹائپ ڈیفینیشنز (`.intlayer/**/*.ts`) شامل کی جا سکیں۔
+4. **کنفیگریشن فائل بنانا** - ڈیفالٹ سیٹنگز کے ساتھ `intlayer.config.ts` (TypeScript پروجیکٹس کے لیے) یا `intlayer.config.mjs` (JavaScript پروجیکٹس کے لیے) تیار کرتی ہے۔
+5. **Vite کنفیگریشن اپ ڈیٹ کرنا** - اگر کسی Vite کنفیگ فائل کا پتہ چلتا ہے، تو یہ `vite-intlayer` پلگ ان کے لیے امپورٹ شامل کرتی ہے۔
+6. **Next.js کنفیگریشن اپ ڈیٹ کرنا** - اگر کسی Next.js کنفیگ فائل کا پتہ چلتا ہے، تو یہ `next-intlayer` پلگ ان کے لیے امپورٹ شامل کرتی ہے۔
+
+## مثالیں:
+
+### بنیادی انیشلائزیشن:
+
+```bash
+npx intlayer init
+```
+
+یہ خودکار طور پر پروجیکٹ روٹ کا پتہ لگا کر موجودہ ڈائریکٹری میں Intlayer شروع کرتا ہے۔
+
+### اپنی مرضی کے پروجیکٹ روٹ کے ساتھ شروع کرنا:
+
+```bash
+npx intlayer init --project-root ./my-project
+```
+
+یہ متعین کردہ ڈائریکٹری میں Intlayer شروع کرتا ہے۔
+
+### .gitignore اپ ڈیٹ کیے بغیر شروع کرنا:
+
+```bash
+npx intlayer init --no-gitignore
+```
+
+یہ تمام کنفیگریشن فائلیں ترتیب دے دے گا لیکن آپ کی `.gitignore` فائل میں ترمیم نہیں کرے گا۔
+
+## آؤٹ پٹ کی مثال:
+
+```bash
+npx intlayer init
+Checking Intlayer configuration...
+✓ Added .intlayer to .gitignore
+✓ Updated tsconfig.json to include intlayer types
+✓ Created intlayer.config.ts
+✓ Injected import into vite.config.ts
+✓ Intlayer init setup complete.
+```
+
+## نوٹ:
+
+- یہ کمانڈ آئیڈیمپوٹنٹ (idempotent) ہے — آپ اسے محفوظ طریقے سے کئی بار چلا سکتے ہیں۔ پہلے سے کنفیگر شدہ مراحل کو خود بخود نظر انداز کر دیا جائے گا۔
+- اگر کوئی کنفیگریشن فائل پہلے سے موجود ہے، تو اسے اوور رائٹ نہیں کیا جائے گا۔
+- ایسی TypeScript کنفیگریشنز جن میں `include` ارے نہیں ہوتی (مثلاً حوالہ جات کے ساتھ سلوشن اسٹائل کنفیگریشنز) انہیں نظر انداز کر دیا جاتا ہے۔
+- اگر پروجیکٹ روٹ میں `package.json` نہیں ملتی، تو کمانڈ غلطی (error) دے کر رک جائے گی۔

package/docs/ur/cli/standalone.md

@@ -0,0 +1,91 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2026-03-31
+title: اسٹینڈ اکیلے بنڈل (Standalone Bundle)
+description: سیکھیں کہ ایپ کے مواد کے لیے اسٹینڈ اکیلے JavaScript بنڈل کیسے تیار کیا جائے۔
+keywords:
+  - Standalone
+  - بنڈل
+  - CLI
+  - Intlayer
+  - ایڈیٹر
+  - CMS
+slugs:
+  - doc
+  - concept
+  - cli
+  - standalone
+history:
+  - version: 8.6.4
+    date: 2026-03-31
+    changes: "اسٹینڈ اکیلے کمانڈ کی دستاویزات کا آغاز"
+---
+
+# اسٹینڈ اکیلے بنڈل (Standalone Bundle)
+
+`standalone` کمانڈ آپ کو ایک اسٹینڈ اکیلے JavaScript بنڈل تیار کرنے کی اجازت دیتی ہے جس میں Intlayer اور کوئی بھی دیگر متعین پیکیجز شامل ہوتے ہیں۔ یہ خاص طور پر ان ماحولوں میں Intlayer استعمال کرنے کے لیے مفید ہے جہاں پیکیج منیجر یا بنڈلر نہیں ہوتا، جیسے کہ ایک سادہ HTML/JS ایپ۔
+
+یہ بنڈل [esbuild](https://esbuild.github.io/) کا استعمال کرتے ہوئے مطلوبہ پیکیجز اور ان کے انحصار (dependencies) کو ایک واحد فائل میں یکجا کرتا ہے جسے کسی بھی ویب پروجیکٹ میں آسانی سے درآمد کیا جا سکتا ہے۔
+
+## استعمال
+
+```bash
+npx intlayer standalone --packages [پیکیجز...] [اختیارات]
+```
+
+## اختیارات
+
+- `-o, --outfile [outfile]` - اختیاری۔ آؤٹ پٹ فائل کا نام۔ ڈیفالٹ: `intlayer-bundle.js`۔
+- `--packages [پیکیجز...]` - لازمی۔ بنڈل میں شامل کرنے کے لیے پیکیجز کی فہرست (مثلاً: `intlayer`, `vanilla-intlayer`)۔
+- `--version [version]` - اختیاری۔ بنڈل کرنے کے لیے پیکیجز کا ورژن۔ اگر متعین نہ ہو تو ڈیفالٹ طور پر Intlayer CLI کا ورژن استعمال کیا جاتا ہے۔
+- `--minify` - اختیاری۔ آیا آؤٹ پٹ کو چھوٹا (minify) کرنا ہے یا نہیں۔ ڈیفالٹ: `true`۔
+- `--platform [platform]` - اختیاری۔ بنڈل کے لیے ٹارگٹ پلیٹ فارم (مثلاً: `browser`, `node`)۔ ڈیفالٹ: `browser`۔
+- `--format [format]` - اختیاری۔ بنڈل کے لیے آؤٹ پٹ فارمیٹ (مثلاً: `esm`, `cjs`, `iife`)۔ ڈیفالٹ: `esm`۔
+
+## عمومی اختیارات
+
+- `--env-file [envFile]` - انوائرمنٹ فائل۔
+- `-e, --env [env]` - ماحول۔
+- `--base-dir [baseDir]` - بیس ڈائریکٹری۔
+- `--no-cache` - کیشے کو غیر فعال کریں۔
+- `--verbose` - تفصیلی آؤٹ پٹ دکھائیں۔
+
+## مثالیں:
+
+### Vanilla JS کے لیے بنڈل بنانا:
+
+```bash
+npx intlayer standalone --packages intlayer vanilla-intlayer --outfile intlayer.js
+```
+
+یہ ایک `intlayer.js` فائل بنائے گا جس میں `intlayer` اور `vanilla-intlayer` دونوں پیکیجز شامل ہوں گے، جو چھوٹے کیے گئے ہوں گے اور ESM فارمیٹ میں ہوں گے، اور ایک `<script>` ٹیگ کے ذریعے براؤزر میں استعمال کے لیے تیار ہوں گے۔
+
+### مخصوص ورژن کا بنڈل بنانا:
+
+```bash
+npx intlayer standalone --packages intlayer --version 8.6.4
+```
+
+### دوسرے فارمیٹ میں بنڈل بنانا:
+
+```bash
+npx intlayer standalone --packages intlayer --format iife
+```
+
+## یہ کیا کرتا ہے:
+
+1. **ایک عارضی ماحول بناتا ہے** - انحصار کو منظم کرنے کے لیے ایک عارضی ڈائریکٹری ترتیب دیتا ہے۔
+2. **پیکیجز نصب کرتا ہے** - مطلوبہ پیکیجز اور ان کے انحصار کو نصب کرنے کے لیے `npm` یا `bun` (اگر دستیاب ہو) کا استعمال کرتا ہے۔
+3. **انٹری پوائنٹ تیار کرتا ہے** - ایک عارضی انٹری پوائنٹ فائل بناتا ہے جو تمام مطلوبہ پیکیجز کو ایکسپورٹ کرتی ہے اور براؤزر میں چلنے پر انہیں عالمی متغیرات (global variables) کے طور پر ظاہر کرتی ہے۔
+4. **esbuild کے ساتھ بنڈل کرتا ہے** - ہر چیز کو ایک فائل میں یکجا کرنے کے لیے esbuild کا استعمال کرتا ہے، اور درخواست کے مطابق منی فکیشن اور فارمیٹنگ لاگو کرتا ہے۔
+5. **فائل تیار کرتا ہے** - تیار شدہ بنڈل کو متعین آؤٹ پٹ پاتھ پر لکھتا ہے۔
+
+## عالمی متغیرات (Global Variables)
+
+جب بنڈل براؤزر میں لوڈ ہوتا ہے، تو یہ مطلوبہ پیکیجز کو `window` آبجیکٹ پر عالمی متغیرات کے طور پر ظاہر کرتا ہے۔ متغیرات کے نام پیکیج کے ناموں سے لیے جاتے ہیں (مثلاً: `intlayer` بن جاتا ہے `Intlayer` ، اور `vanilla-intlayer` بن جاتا ہے `VanillaIntlayer`)۔
+
+```javascript
+// بنڈل سے Intlayer تک رسائی
+const { getLocaleName } = window.Intlayer;
+const { installIntlayer, useIntlayer } = window.VanillaIntlayer;
+```

package/docs/ur/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-03-20
+updatedAt: 2026-04-03
 title: ترتیب (Configuration)
 description: سیکھیں کہ اپنی ایپلیکیشن کے لیے Intlayer کو کیسے ترتیب دینا ہے۔ اپنی ضروریات کے مطابق Intlayer کو اپنی مرضی کے مطابق بنانے کے لیے دستیاب مختلف ترتیبات اور اختیارات کو سمجھیں۔
 keywords:
@@ -16,6 +16,12 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 8.7.0
+    date: 2026-04-07
+    changes: "بلڈ کنفیگریشن میں `minify` اور `prune` کے اختیارات شامل کیے گئے۔"
+  - version: 8.7.0
+    date: 2026-04-03
+    changes: "`currentDomain` آپشن شامل کیا گیا۔"
   - version: 8.4.0
     date: 2026-03-20
     changes: "'compiler.output' اور 'dictionary.fill' کے لیے فی لوکیل (per-locale) نوٹیشن شامل کی گئی۔"
@@ -239,6 +245,17 @@ const config: IntlayerConfig = {
         fr: "/[locale]/a-propos",
       },
     }),
+
+    /**
+     * ڈومین پر مبنی راؤٹنگ کے لیے لوکلز کو ڈومین ہوسٹ نیمز کے ساتھ میپ کرتا ہے۔
+     * ان لوکلز کے URLs مطلق (absolute) ہوں گے (مثلاً https://intlayer.cn/)۔
+     * ڈومین خود لوکل کی نشاندہی کرتا ہے، اس لیے پاتھ میں کوئی لوکل سابقہ (prefix) شامل نہیں کیا جاتا۔
+     * ڈیفالٹ: undefined
+     */
+    domains: {
+      en: "intlayer.org",
+      zh: "intlayer.cn",
+    },
   },
 
   /**
@@ -390,6 +407,25 @@ const config: IntlayerConfig = {
      */
     optimize: true,
 
+    /**
+     * بنڈل کے سائز کو کم کرنے کے لیے لغات کو منی فائی (minify) کریں۔
+     * ڈیفالٹ: false
+     *
+     * نوٹ:
+     * - اگر `optimize` غیر فعال ہو تو اسے نظر انداز کر دیا جائے گا۔
+     * - اگر `editor.enabled` کی ویلیو true ہو تو اسے نظر انداز کر دیا جائے گا۔
+     */
+    minify: true,
+
+    /**
+     * لغات میں غیر استعمال شدہ کلیدوں کو ہٹا دیں (prune)۔
+     * ڈیفالٹ: false
+     *
+     * نوٹ:
+     * - اگر `optimize` غیر فعال ہو تو اسے نظر انداز کر دیا جائے گا۔
+     */
+    prune: true,
+
     /**
      * تیار کردہ لغت فائلوں کے لیے آؤٹ پٹ فارمیٹ۔
      * ڈیفالٹ: ['cjs', 'esm']
@@ -599,12 +635,13 @@ export default config;
 
 ترتیبات جو راؤٹنگ کے رویے کو کنٹرول کرتی ہیں، بشمول URL کا ڈھانچہ، لوکل اسٹوریج، اور مڈل ویئر ہینڈلنگ۔
 
-| فیلڈ       | وضاحت                                                                                                                        | قسم                                                                                                                                                                                                          | ڈیفالٹ                 | مثال                                                                                                                                                                                               | نوٹ                                                                                                                                                                                                                                                                            |
-| ---------- | ---------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `mode`     | لوکل ہینڈلنگ کے لیے URL راؤٹنگ موڈ۔                                                                                          | `'prefix-no-default'` &#124; <br/> `'prefix-all'` &#124; <br/> `'no-prefix'` &#124; <br/> `'search-params'`                                                                                                  | `'prefix-no-default'`  | `'prefix-no-default'`: `/dashboard` (en) یا `/fr/dashboard` (fr). `'prefix-all'`: `/en/dashboard`. `'no-prefix'`: لوکل دوسرے ذرائع سے ہینڈل کیا جاتا ہے۔ `'search-params'`: `/dashboard?locale=fr` | کوکی یا لوکل اسٹوریج مینجمنٹ پر اثر انداز نہیں ہوتا۔                                                                                                                                                                                                                           |
-| `storage`  | کلائنٹ میں لوکل محفوظ کرنے کی کنفیگریشن۔                                                                                     | `false` &#124; <br/> `'cookie'` &#124; <br/> `'localStorage'` &#124; <br/> `'sessionStorage'` &#124; <br/> `'header'` &#124; <br/> `CookiesAttributes` &#124; <br/> `StorageAttributes` &#124; <br/> `Array` | `['cookie', 'header']` | `'localStorage'` <br/> `[{ type: 'cookie', name: 'custom-locale', secure: true }]`                                                                                                                 | نیچے اسٹوریج کے اختیارات والا ٹیبل دیکھیں۔                                                                                                                                                                                                                                     |
-| `basePath` | ایپلیکیشن URLs کے لیے بنیادی راستہ۔                                                                                          | `string`                                                                                                                                                                                                     | `''`                   | `'/my-app'`                                                                                                                                                                                        | اگر ایپ `https://example.com/my-app` پر ہے، تو basePath `'/my-app'` ہے اور URLs `https://example.com/my-app/en` بن جاتے ہیں۔                                                                                                                                                   |
-| `rewrite`  | کسٹم URL رائٹنگ کے قواعد جو مخصوص راستوں کے لیے ڈیفالٹ راؤٹنگ موڈ کو اوور رائڈ کرتے ہیں۔ `[param]` متحرک پیرامیٹرز کی سپورٹ۔ | `Record<string, StrictModeLocaleMap<string>>`                                                                                                                                                                | `undefined`            | نیچے دی گئی مثال دیکھیں                                                                                                                                                                            | • ری رائٹ رولز `mode` پر فوقیت رکھتے ہیں۔<br/>• Next.js اور Vite کے ساتھ کام کرتا ہے۔<br/>• `getLocalizedUrl()` خودکار طور پر مماثل رولز لاگو کرتا ہے۔<br/>• [کسٹم URL ری رائٹس](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/custom_url_rewrites.md) دیکھیں۔ |
+| فیلڈ       | وضاحت                                                                                                                                                                                                            | قسم                                                                                                                                                                                                          | ڈیفالٹ                 | مثال                                                                                                                                                                                               | نوٹ                                                                                                                                                                                                                                                                            |
+| ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `mode`     | لوکل ہینڈلنگ کے لیے URL راؤٹنگ موڈ۔                                                                                                                                                                              | `'prefix-no-default'` &#124; <br/> `'prefix-all'` &#124; <br/> `'no-prefix'` &#124; <br/> `'search-params'`                                                                                                  | `'prefix-no-default'`  | `'prefix-no-default'`: `/dashboard` (en) یا `/fr/dashboard` (fr). `'prefix-all'`: `/en/dashboard`. `'no-prefix'`: لوکل دوسرے ذرائع سے ہینڈل کیا جاتا ہے۔ `'search-params'`: `/dashboard?locale=fr` | کوکی یا لوکل اسٹوریج مینجمنٹ پر اثر انداز نہیں ہوتا۔                                                                                                                                                                                                                           |
+| `storage`  | کلائنٹ میں لوکل محفوظ کرنے کی کنفیگریشن۔                                                                                                                                                                         | `false` &#124; <br/> `'cookie'` &#124; <br/> `'localStorage'` &#124; <br/> `'sessionStorage'` &#124; <br/> `'header'` &#124; <br/> `CookiesAttributes` &#124; <br/> `StorageAttributes` &#124; <br/> `Array` | `['cookie', 'header']` | `'localStorage'` <br/> `[{ type: 'cookie', name: 'custom-locale', secure: true }]`                                                                                                                 | نیچے اسٹوریج کے اختیارات والا ٹیبل دیکھیں۔                                                                                                                                                                                                                                     |
+| `basePath` | ایپلیکیشن URLs کے لیے بنیادی راستہ۔                                                                                                                                                                              | `string`                                                                                                                                                                                                     | `''`                   | `'/my-app'`                                                                                                                                                                                        | اگر ایپ `https://example.com/my-app` پر ہے، تو basePath `'/my-app'` ہے اور URLs `https://example.com/my-app/en` بن جاتے ہیں۔                                                                                                                                                   |
+| `rewrite`  | کسٹم URL رائٹنگ کے قواعد جو مخصوص راستوں کے لیے ڈیفالٹ راؤٹنگ موڈ کو اوور رائڈ کرتے ہیں۔ `[param]` متحرک پیرامیٹرز کی سپورٹ۔                                                                                     | `Record<string, StrictModeLocaleMap<string>>`                                                                                                                                                                | `undefined`            | نیچے دی گئی مثال دیکھیں                                                                                                                                                                            | • ری رائٹ رولز `mode` پر فوقیت رکھتے ہیں۔<br/>• Next.js اور Vite کے ساتھ کام کرتا ہے۔<br/>• `getLocalizedUrl()` خودکار طور پر مماثل رولز لاگو کرتا ہے۔<br/>• [کسٹم URL ری رائٹس](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/custom_url_rewrites.md) دیکھیں۔ |
+| `domains`  | ڈومین پر مبنی راؤٹنگ کے لیے لوکلز کو ڈومین ہوسٹ نیمز کے ساتھ میپ کرتا ہے۔ جب سیٹ کیا جائے تو اس لوکل کے URLs اس ڈومین کو بطور بنیاد (مطلق URL) استعمال کرتے ہیں اور پاتھ میں کوئی لوکل سابقہ شامل نہیں کیا جاتا۔ | `Partial<Record<Locale, string>>`                                                                                                                                                                            | `undefined`            | `{ zh: 'intlayer.zh', fr: 'intlayer.org' }`                                                                                                                                                        | • اگر ہوسٹ نیم میں شامل نہ ہو تو ڈیفالٹ پروٹوکول `https://` ہے۔<br/>• ڈومین خود لوکل کی شناخت کرتا ہے، اس لیے کوئی `/zh/` سابقہ شامل نہیں کیا جاتا۔<br/>• `getLocalizedUrl('/', 'zh')` واپسی دیتا ہے `https://intlayer.zh/`۔                                                   |
 
 **`rewrite` کی مثال**:
 
@@ -908,6 +945,8 @@ Intlayer زیادہ سے زیادہ لچک کو یقینی بنانے کے لی
 | ----------------- | ------------------------------------------------------------------------------------ | -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `mode`            | بلڈ ایگزیکیوشن موڈ کو کنٹرول کرتا ہے۔                                                | `'auto'` &#124; <br/> `'manual'` | `'auto'`                                                                                                                                                                          | `'manual'`                                                                    | • `'auto'`: ایپ بلڈ کے دوران خودکار طور پر بلڈ شروع ہوتا ہے۔<br/>• `'manual'`: صرف واضح بلڈ کمانڈ کے ذریعے چلتا ہے۔<br/>• لغت کی بلڈ کو روکنے کے لیے مفید ہو سکتا ہے (مثلاً: Node.js ماحول میں چلنے سے بچنے کے لیے)۔                                                                                                 |
 | `optimize`        | کنٹرول کرتا ہے کہ آیا بلڈ آپٹیمائزیشن کی جاتی ہے۔                                    | `boolean`                        | `undefined`                                                                                                                                                                       | `process.env.NODE_ENV === 'production'`                                       | • اگر متعین نہ ہو، تو یہ فریم ورک بلڈ (Vite/Next.js) کے دوران شروع ہوگا۔<br/>• `true` ڈیولپمنٹ موڈ میں بھی آپٹیمائزیشن کو مجبور کرتا ہے۔<br/>• `false` اسے غیر فعال کرتا ہے۔<br/>• اگر فعال ہو، تو لغت کی کالز کو چنکنگ آپٹیمائزیشن سے بدل دیتا ہے۔<br/>• `@intlayer/babel` اور `@intlayer/swc` پلگ انز کی ضرورت ہے۔ |
+| `minify`          | بتاتا ہے کہ آیا بنڈل کے سائز کو کم کرنے کے لیے لغات کو کم (minify) کیا جانا چاہیے۔   | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | • بتاتا ہے کہ آیا بنڈل کو منی فائی کرنا ہے۔<br/>• ڈیفالٹ: پروڈکشن میں `true`۔<br/>• اگر `optimize` غیر فعال ہو تو اسے نظر انداز کر دیا جائے گا۔<br/>• اگر `editor.enabled` کی ویلیو true ہو تو اسے نظر انداز کر دیا جائے گا۔                                                                                         |
+| `prune`           | بتاتا ہے کہ آیا لغات میں غیر استعمال شدہ کلیدوں کو ہٹا دینا (prune) چاہیے۔           | `boolean`                        | `true`                                                                                                                                                                            |                                                                               | • بتاتا ہے کہ آیا بنڈل کو پرون (prune) کرنا ہے۔ <br/>• ڈیفالٹ: پروڈکشن میں `true`۔<br/>• اگر `optimize` غیر فعال ہو تو اسے نظر انداز کر دیا جائے گا۔                                                                                                                                                                 |
 | `checkTypes`      | بتاتا ہے کہ آیا بلڈ کو TypeScript اقسام کو چیک کرنا چاہیے اور ایررز لاگ کرنے چاہئیں۔ | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | بلڈ کی کارکردگی کو سست کر سکتا ہے۔                                                                                                                                                                                                                                                                                   |
 | `outputFormat`    | لغت کے آؤٹ پٹ فارمیٹ کو کنٹرول کرتا ہے۔                                              | `('esm' &#124; 'cjs')[]`         | `['esm', 'cjs']`                                                                                                                                                                  | `['cjs']`                                                                     |                                                                                                                                                                                                                                                                                                                      |
 | `traversePattern` | آپٹیمائزیشن کے دوران اسکین کی جانے والی فائلوں کا پیٹرن۔                             | `string[]`                       | `['**/*.{tsx,ts,js,mjs,cjs,jsx,vue,svelte,svte}', '!**/node_modules/**', '!**/dist/**', '!**/.intlayer/**', '!**/*.config.*', '!**/*.test.*', '!**/*.spec.*', '!**/*.stories.*']` | `['src/**/*.{ts,tsx}', '../ui-library/**/*.{ts,tsx}', '!**/node_modules/**']` | • متعلقہ فائلوں تک آپٹیمائزیشن کو محدود کرکے بلڈ کی کارکردگی کو بہتر بناتا ہے۔<br/>• اگر `optimize` غیر فعال ہو تو نظر انداز کر دیا جاتا ہے۔<br/>• گلوب (glob) پیٹرنز استعمال کرتا ہے۔                                                                                                                               |