@intlayer/docs 9.2.0 → 9.3.1

package/docs/ur/bundle_optimization.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-11-25
-updatedAt: 2026-06-07
+updatedAt: 2026-08-09
 title: i18n بنڈل سائز اور کارکردگی کی آپٹیمائزیشن
 description: انٹرنیشنلائزیشن (i18n) مواد کو آپٹیمائز کرکے اپنی ایپلیکیشن کے بنڈل سائز کو کم کریں۔ جانیں کہ Intlayer کے ساتھ ڈکشنریوں کے لیے ٹری شیکنگ (tree shaking) اور لیزی لوڈنگ (lazy loading) کا استعمال کیسے کریں۔
 keywords:
@@ -16,6 +16,12 @@ slugs:
   - concept
   - bundle-optimization
 history:
+  - version: 9.2.1
+    date: 2026-08-09
+    changes: "`purge` اور `minify` اب `@intlayer/swc` کے ذریعے Next.js پر کام کرتے ہیں — `babel.config.js` کی ضرورت نہیں"
+  - version: 8.12.0
+    date: 2026-06-24
+    changes: "حوالہ جاتی جدولوں میں Babel پلگ اِنز کو مطلوبہ پائپ لائن ترتیب (extract → purge → minify → optimize) میں درج کرنا"
   - version: 8.12.0
     date: 2026-06-07
     changes: "Babel/Webpack کے لیے `intlayerPurgeBabelPlugin` اور `intlayerMinifyBabelPlugin` شامل کیا گیا؛ پلگ ان پائپ لائن کو واضح کیا گیا"
@@ -191,12 +197,14 @@ Intlayer کا بلڈ آپٹیمائزیشن کئی الگ الگ پلگ انز
 
 یہ براہ راست Webpack پر مبنی سیٹ اپس کے لیے `babel.config.js` میں استعمال ہوتے ہیں (جیسے Babel کے ساتھ Next.js، CRA، کسٹم Webpack وغیرہ)۔
 
+نیچے دیا گیا جدول انہیں مطلوبہ پائپ لائن ترتیب میں درج کرتا ہے (وہی ترتیب جس میں انہیں `babel.config.js` میں آنا چاہیے):
+
 | پلگ ان                        | یہ کیا کرتا ہے                                                                                                                                              |
 | :---------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `intlayerExtractBabelPlugin`  | `.content.ts` فائلوں کو اسکین کرتا ہے اور مرتب کی گئی (compiled) ڈکشنریوں کو `.intlayer/` میں لکھتا ہے                                                      |
-| `intlayerOptimizeBabelPlugin` | `useIntlayer('key')` کو `useDictionary(hash)` میں بدل دیتا ہے اور متعلقہ ڈکشنری کا `import` شامل (inject) کرتا ہے                                           |
 | `intlayerPurgeBabelPlugin`    | تمام سورس (source) فائلوں کو اسکین کرتا ہے، مرتب شدہ `.intlayer/**/*.json` ڈکشنری فائلوں سے **غیر استعمال شدہ مواد (unused content fields)** کو ہٹا دیتا ہے |
 | `intlayerMinifyBabelPlugin`   | JSON فائلوں اور سورس کوڈ دونوں میں **مواد کی فیلڈ کیز (keys) کا نام بدل کر** چھوٹے حروف تہجی (alias) رکھ دیتا ہے (جیسے `title` → `a`)                       |
+| `intlayerOptimizeBabelPlugin` | `useIntlayer('key')` کو `useDictionary(hash)` میں بدل دیتا ہے اور متعلقہ ڈکشنری کا `import` شامل (inject) کرتا ہے                                           |
 
 > **پلگ ان کی ترتیب اہم ہے۔** آپ کے `babel.config.js` میں purge اور minify کے پلگ انز کا optimize پلگ ان سے **پہلے** ہونا لازمی ہے۔ optimize مرحلہ (pass) `useIntlayer('key')` کو ایک مبہم `useDictionary(hash)` کال سے بدل دیتا ہے، جس سے ڈکشنری کی (key) کی وہ معلومات مٹ جاتی ہے جس کی purge اور minify مراحل کو ضرورت ہوتی ہے تاکہ وہ جان سکیں کہ کون سی فیلڈز استعمال ہو رہی ہیں۔
 
@@ -205,9 +213,9 @@ Intlayer کا بلڈ آپٹیمائزیشن کئی الگ الگ پلگ انز
 | آپشنز ہیلپر (Options helper) | کس کے ساتھ استعمال ہوتا ہے    |
 | :--------------------------- | :---------------------------- |
 | `getExtractPluginOptions()`  | `intlayerExtractBabelPlugin`  |
-| `getOptimizePluginOptions()` | `intlayerOptimizeBabelPlugin` |
 | `getPurgePluginOptions()`    | `intlayerPurgeBabelPlugin`    |
 | `getMinifyPluginOptions()`   | `intlayerMinifyBabelPlugin`   |
+| `getOptimizePluginOptions()` | `intlayerOptimizeBabelPlugin` |
 
 ### Vite پلگ انز (`vite-intlayer`)
 
@@ -220,6 +228,20 @@ Vite کے صارفین **انہیں کبھی بھی براہ راست کنفیگ
 | Dictionary minify   | بالکل `intlayerMinifyBabelPlugin` کے JSON رائٹ مرحلے کی طرح                                     |
 | Babel transform     | بالکل `intlayerMinifyBabelPlugin` کے سورس کوڈ کے رینیم اور `intlayerOptimizeBabelPlugin` کی طرح |
 
+### SWC پلگ اِن (`@intlayer/swc`)
+
+Next.js استعمال کرنے والے بھی **انہیں کبھی براہِ راست ترتیب نہیں دیتے**۔ **v9.2.1** سے، `next.config.ts` میں `withIntlayer()` صرف `build.purge` اور `build.minify` فلیگز کی بنیاد پر مکمل پائپ لائن چلاتا ہے — purge، minify اور import کی دوبارہ تحریر۔
+
+کام دو حصوں میں بٹا ہوا ہے، کیونکہ SWC کا Wasm پلگ اِن ایک وقت میں ایک ہی فائل کو تبدیل کرتا ہے اور اسے فائل سسٹم تک رسائی نہیں ہوتی:
+
+| مرحلہ                                         | کہاں چلتا ہے                   | کیا کرتا ہے                                                                                                |
+| :-------------------------------------------- | :----------------------------- | :--------------------------------------------------------------------------------------------------------- |
+| استعمال کا تجزیہ + JSON purge/minify          | Node، `withIntlayer()` کے اندر | ہر کمپوننٹ سورس فائل پڑھتا ہے، `.intlayer/**/*.json` دوبارہ لکھتا ہے، اور نام بدلنے کی جدولیں تیار کرتا ہے |
+| سورس کی دوبارہ تحریر (`content.title` ← `.a`) | `@intlayer/swc` (Wasm)         | نام بدلنے کی جدولیں آپ کے کوڈ میں متعلقہ پراپرٹی رسائیوں پر لاگو کرتا ہے                                   |
+| Import کی دوبارہ تحریر (`useIntlayer` ← dict) | `@intlayer/swc` (Wasm)         | `intlayerOptimizeBabelPlugin` کی طرح                                                                       |
+
+یہ طے کرنا کہ _کون سے_ فیلڈز غیر استعمال شدہ ہیں اور ہر ایک کو _کون سا_ مختصر نام ملے گا، اس کے لیے فائلوں کے درمیان حالت اور فائل I/O درکار ہے، اس لیے وہ نصف حصہ Node میں چلتا ہے؛ SWC پلگ اِن کو صرف نتیجہ خیز جدولیں ملتی ہیں۔
+
 ## پلیٹ فارم کے لحاظ سے سیٹ اپ
 
 <Tabs>
@@ -227,10 +249,12 @@ Vite کے صارفین **انہیں کبھی بھی براہ راست کنفیگ
 
 ### Next.js
 
-Next.js کو آپٹیمائز پاس (import rewrite) کے لیے `@intlayer/swc` پلگ ان کی ضرورت ہوتی ہے، کیونکہ Next.js بلڈز کے لیے SWC کا استعمال کرتا ہے۔
+Next.js کو `@intlayer/swc` پلگ اِن درکار ہے، کیونکہ Next.js بلڈ کے لیے SWC استعمال کرتا ہے۔ **v9.2.1** سے یہ اکیلا پیکیج پوری پائپ لائن کا احاطہ کرتا ہے — آپٹیمائز (import کی دوبارہ تحریر)، purge اور minify۔
 
 > یہ پلگ ان بائی ڈیفالٹ انسٹال نہیں ہوتا کیونکہ SWC کے پلگ انز Next.js کے لیے اب بھی تجرباتی مراحل میں ہیں۔ یہ مستقبل میں بدل سکتا ہے۔
 
+> **Next.js 16.1.0 کم از کم ورژن ہے۔** یہ SWC کے آگے کی جانب ہم آہنگ Wasm پلگ اِن ABI پر بنایا گیا پہلا ریلیز ہے؛ اس سے پرانے ریلیز پلگ اِن کو مسترد کر دیتے ہیں۔ `withIntlayer` آپ کے پروجیکٹ کا Next.js ورژن پڑھتا ہے اور 16.1.0 سے نیچے پلگ اِن رجسٹر ہی نہیں کرتا — وہ بلڈز پھر بھی کامیاب ہوتے ہیں، بس بنڈل آپٹیمائزیشن کے بغیر چلتے ہیں۔
+
 <Tabs>
  <Tab value="npm">
 
@@ -265,33 +289,40 @@ intlayer-swc-plugin = "*"
 
 انسٹال ہونے کے بعد، Intlayer خود بخود پلگ ان کو شناخت کر کے اس کا استعمال شروع کر دے گا۔
 
-**purge اور minify** مراحل (فیلڈ کو ہٹانے اور رینیم کرنے) کے لیے، اس کے ساتھ `@intlayer/babel` انسٹال کریں اور Babel کے پلگ انز کو شامل کریں۔ چونکہ Next.js ٹرانسفارمیشن کے لیے SWC استعمال کرتا ہے لیکن پھر بھی پلگ ان کنفیگریشن کے لیے `babel.config.js` کو ایویلیوایٹ (evaluate) کرتا ہے، اس لیے Babel پلگ انز SWC سے پہلے ایک پری-پاس (pre-pass) کے طور پر چلتے ہیں۔
+**Purge اور minify** مراحل (فیلڈ ہٹانا اور فیلڈ کا نام بدلنا) کے لیے کسی اضافی پیکیج یا `babel.config.js` کی ضرورت نہیں۔ اپنی کنفیگ کو `withIntlayer` سے لپیٹیں اور `intlayer.config.ts` میں فلیگز آن کریں:
 
-```bash packageManager="npm"
-npm install -D @intlayer/babel
+```typescript fileName="next.config.ts"
+import { withIntlayer } from "next-intlayer/server";
+import type { NextConfig } from "next";
+
+const nextConfig: NextConfig = {/* آپ کی کنفیگ */};
+
+export default withIntlayer(nextConfig);
 ```
 
-```javascript fileName="babel.config.js"
-const {
-  intlayerPurgeBabelPlugin,
-  intlayerMinifyBabelPlugin,
-  getPurgePluginOptions,
-  getMinifyPluginOptions,
-} = require("@intlayer/babel");
+```typescript fileName="intlayer.config.ts"
+import type { IntlayerConfig } from "intlayer";
 
-module.exports = {
-  presets: ["next/babel"],
-  plugins: [
-    // Purge: غیر استعمال شدہ مواد کو .intlayer/**/*.json سے ہٹا دیں
-    [intlayerPurgeBabelPlugin, getPurgePluginOptions()],
-    // Minify: JSON اور سورس کوڈ میں مواد کی فیلڈ کیز کا نام بدلیں
-    [intlayerMinifyBabelPlugin, getMinifyPluginOptions()],
-    // نوٹ: intlayerOptimizeBabelPlugin کی یہاں ضرورت نہیں ہے کیونکہ
-    // @intlayer/swc اسے useIntlayer → useDictionary ری رائٹ کو سنبھالتا ہے۔
-  ],
+const config: IntlayerConfig = {
+  build: {
+    purge: true, // بنڈل کیے گئے JSON سے غیر استعمال شدہ مواد کے فیلڈز ہٹاتا ہے
+    minify: true, // مواد کے فیلڈ کیز کو مختصر ناموں میں بدلتا ہے
+  },
 };
+
+export default config;
 ```
 
+`next build` کے دوران، `withIntlayer` آپ کے سورسز کا تجزیہ کرتا ہے، مرتب شدہ ڈکشنریز دوبارہ لکھتا ہے، اور نتیجے میں بننے والی فیلڈ نام بدلنے کی جدولیں `@intlayer/swc` کو دیتا ہے، جو آپ کے کوڈ میں متعلقہ پراپرٹی رسائیوں کو اپ ڈیٹ کرتا ہے۔
+
+> `withIntlayerSync` نہیں بلکہ غیر ہم وقت (async) `withIntlayer` استعمال کریں۔ ہم وقت نسخہ تجزیے کی پائپ لائن نہیں چلاتا، اس لیے اس کے ساتھ purge اور minify کا کوئی اثر نہیں ہوتا۔
+
+> Purge اور minify صرف `next build` پر چلتے ہیں — آپٹیمائز پائپ لائن `next dev` کے دوران بند رہتی ہے۔
+
+> جب کمپیٹ اڈاپٹر کالرز ترتیب دیے گئے ہوں تب بھی یہ غیر فعال ہو جاتے ہیں (`swcExtraCallers`، جنہیں `@intlayer/next-intl` یا `@intlayer/react-i18next` جیسے کمپیٹ پیکیجز مقرر کرتے ہیں): وہ کال سائٹس استعمال کے تجزیہ کار کو نظر نہیں آتیں، اس لیے purge ایسے فیلڈز ہٹا دیتا جو کوڈ اب بھی پڑھتا ہے۔ Import کی دوبارہ تحریر فعال رہتی ہے۔
+
+**پرانے ورژنز (9.2.1 سے پہلے)** میں `@intlayer/babel` اور ایک ایسی `babel.config.js` درکار تھی جو `intlayerPurgeBabelPlugin` اور `intlayerMinifyBabelPlugin` کا اعلان کرے۔ اب اس فائل کی ضرورت نہیں اور اسے حذف کیا جا سکتا ہے۔
+
  </Tab>
  <Tab value="vite">
 
@@ -447,6 +478,8 @@ export default config;
 
 > منی فیکیشن کو چھوڑ (skipped) دیا جاتا ہے جب `optimize` کی ویلیو `false` ہو، یا جب `editor.enabled` کی ویلیو `true` ہو (ویژول ایڈیٹر کو ایڈیٹنگ کی اجازت دینے کے لیے اصل فیلڈ کے ناموں کی ضرورت ہوتی ہے)۔
 
+> Next.js پر، minification تب بھی چھوڑ دی جاتی ہے جب `@intlayer/swc` نصب نہ ہو یا لوڈ نہ ہو سکے (16.1.0 سے نیچے کا Next.js)۔ سورس میں رسائیوں کو دوبارہ لکھنے والا نصف حصہ یہی پلگ اِن ہے، اس لیے اس کے بغیر ڈکشنریز کے نام بدلنے سے آپ کا کوڈ ایسے فیلڈ نام پڑھتا رہ جائے گا جو اب موجود نہیں۔
+
 > منی فیکیشن ان ڈکشنریوں کے لیے بھی نظرانداز کی جاتی ہے جنہیں `importMode: 'fetch'` کے ذریعے لوڈ کیا گیا ہو کیونکہ ان کا JSON ریموٹ API سے اصل فیلڈ ناموں کے ساتھ پیش کیا جاتا ہے — کلائنٹ سائیڈ کیز کا نام بدلنے سے سرور/کلائنٹ کا کنٹریکٹ (contract) ٹوٹ جائے گا۔
 
 ### پرجنگ (غیر استعمال شدہ فیلڈز کو ہٹانا)
@@ -475,7 +508,7 @@ export default config;
 { "title": "…", "subtitle": "…" }
 ```
 
-> جب `optimize` کی ویلیو `false` ہو یا جب `editor.enabled` کی ویلیو `true` ہو تو پرجنگ (Purging) چھوڑ (skipped) دی جاتی ہے۔
+> جب `optimize` کی ویلیو `false` ہو یا جب `editor.enabled` کی ویلیو `true` ہو تو پرجنگ (Purging) چھوڑ (skipped) دی جاتی ہے۔ Next.js پر یہ تب بھی چھوڑ دیا جاتا ہے جب `@intlayer/swc` دستیاب نہ ہو، اور جب کمپیٹ اڈاپٹر کالرز ترتیب دیے گئے ہوں۔
 
 > پرجنگ کو حفاظتی تدابیر (conservatively) کے طور پر ان حالات میں بھی چھوڑ دیا جاتا ہے جب کوئی سورس فائل پارس (parse) نہیں ہو پاتی، یا جب `useIntlayer` کا نتیجہ کسی ویری ایبل کو تفویض (assign) کر دیا جائے اور پھر ان طریقوں سے آگے بڑھایا جائے جن کا اسٹیٹک اینالائزر کھوج نہیں لگا سکتا (جیسے اسپریڈ کو کسی آبجیکٹ میں ڈالنا، ڈسٹرکچر کیے بغیر پروپ کے طور پر بھیجنا)۔ ان صورتوں میں، مکمل ڈکشنری محفوظ رکھی جاتی ہے۔
 

package/docs/ur/configuration.md

@@ -406,7 +406,7 @@ const config: IntlayerConfig = {
   ai: {
     /**
      * استعمال کیا جانے والا AI فراہم کنندہ۔
-     * اختیارات: 'openai', 'anthropic', 'mistral', 'deepseek', 'gemini', 'ollama', 'openrouter', 'alibaba', 'fireworks', 'groq', 'huggingface', 'bedrock', 'googlevertex', 'togetherai', 'lmstudio'
+     * اختیارات: 'openai', 'anthropic', 'mistral', 'deepseek', 'gemini', 'ollama', 'openrouter', 'alibaba', 'fireworks', 'groq', 'huggingface', 'bedrock', 'googlevertex', 'togetherai', 'lmstudio', 'moonshotai'
      * ڈیفالٹ: 'openai'
      */
     provider: "openai",
@@ -1019,15 +1019,15 @@ Intlayer زیادہ سے زیادہ لچک کو یقینی بنانے کے لی
 - **Together.ai**
 - **LM Studio**
 
-| فیلڈ                 | وضاحت                                                                                                                           | قسم                                                                                                                                                                                                                                                                                                                                                                                                                      | ڈیفالٹ      | مثال                                                          | نوٹ                                                                                                                                                         |
-| -------------------- | ------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------- | ------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `provider`           | Intlayer AI خصوصیات کے لیے استعمال کیا جانے والا فراہم کنندہ۔                                                                   | `'openai'` &#124; <br/> `'anthropic'` &#124; <br/> `'mistral'` &#124; <br/> `'deepseek'` &#124; <br/> `'gemini'` &#124; <br/> `'ollama'` &#124; <br/> `'openrouter'` &#124; <br/> `'alibaba'` &#124; <br/> `'fireworks'` &#124; <br/> `'groq'` &#124; <br/> `'huggingface'` &#124; <br/> `'bedrock'` &#124; <br/> `'googleaistudio'` &#124; <br/> `'googlevertex'` &#124; <br/> `'togetherai'` &#124; <br/> `'lmstudio'` | `undefined` | `'anthropic'`                                                 | مختلف فراہم کنندگان کے لیے مختلف API کلیدوں کی ضرورت ہوتی ہے اور ان کی قیمتوں کا ڈھانچہ بھی مختلف ہوتا ہے۔                                                  |
-| `model`              | AI خصوصیات میں استعمال ہونے والا AI ماڈل۔                                                                                       | `string`                                                                                                                                                                                                                                                                                                                                                                                                                 | کوئی نہیں   | `'gpt-4o-2024-11-20'`                                         | مخصوص ماڈلز فراہم کنندہ پر منحصر ہیں۔                                                                                                                       |
-| `temperature`        | AI کے جوابات میں بے ترتیبی (randomness) کو کنٹرول کرتا ہے۔                                                                      | `number`                                                                                                                                                                                                                                                                                                                                                                                                                 | کوئی نہیں   | `0.1`                                                         | زیادہ ٹمپریچر = زیادہ تخلیقی لیکن کم قابل اعتماد جوابات۔                                                                                                    |
-| `apiKey`             | منتخب کردہ فراہم کنندہ کے لیے آپ کی API کلید۔                                                                                   | `string`                                                                                                                                                                                                                                                                                                                                                                                                                 | کوئی نہیں   | `process.env.OPENAI_API_KEY`                                  | خفیہ رکھیں؛ انوائرمنٹ ویری ایبلز میں محفوظ کریں۔                                                                                                            |
-| `applicationContext` | آپ کی ایپلیکیشن کے بارے میں اضافی تناظر تاکہ AI کو زیادہ درست ترجمے تیار کرنے میں مدد ملے (ڈومین، ٹارگٹ آڈینس، لہجہ، اصطلاحات)۔ | `string`                                                                                                                                                                                                                                                                                                                                                                                                                 | کوئی نہیں   | `'میرا اپنا ایپلیکیشن تناظر'`                                 | قواعد شامل کرنے کے لیے استعمال کیا جا سکتا ہے (مثلاً: `"آپ کو اپنے URLs کا ترجمہ نہیں کرنا چاہیے"`)۔                                                        |
-| `baseURL`            | AI API کے لیے بنیادی URL۔                                                                                                       | `string`                                                                                                                                                                                                                                                                                                                                                                                                                 | کوئی نہیں   | `'https://api.openai.com/v1'` <br/> `'http://localhost:5000'` | کسی مقامی یا کسٹم AI API اینڈ پوائنٹ سے رجوع کر سکتا ہے۔                                                                                                    |
-| `dataSerialization`  | AI خصوصیات کے لیے ڈیٹا سیریلائزیشن فارمیٹ۔                                                                                      | `'json'` &#124; <br/> `'toon'`                                                                                                                                                                                                                                                                                                                                                                                           | `undefined` | `'toon'`                                                      | • `'json'`: ڈیفالٹ، قابل اعتماد؛ زیادہ ٹوکن لیتا ہے۔<br/>• `'toon'`: کم ٹوکن، کم مستحکم۔<br/>• ماڈل کو اضافی پیرامیٹرز بھیجتا ہے (استدلال کی کوششیں وغیرہ)۔ |
+| فیلڈ                 | وضاحت                                                                                                                           | قسم                                                                                                                                                                                                                                                                                                                                                                                                                                                  | ڈیفالٹ      | مثال                                                          | نوٹ                                                                                                                                                         |
+| -------------------- | ------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- | ------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `provider`           | Intlayer AI خصوصیات کے لیے استعمال کیا جانے والا فراہم کنندہ۔                                                                   | `'openai'` &#124; <br/> `'anthropic'` &#124; <br/> `'mistral'` &#124; <br/> `'deepseek'` &#124; <br/> `'gemini'` &#124; <br/> `'ollama'` &#124; <br/> `'openrouter'` &#124; <br/> `'alibaba'` &#124; <br/> `'fireworks'` &#124; <br/> `'groq'` &#124; <br/> `'huggingface'` &#124; <br/> `'bedrock'` &#124; <br/> `'googleaistudio'` &#124; <br/> `'googlevertex'` &#124; <br/> `'togetherai'` &#124; <br/> `'lmstudio'` &#124; <br/> `'moonshotai'` | `undefined` | `'anthropic'`                                                 | مختلف فراہم کنندگان کے لیے مختلف API کلیدوں کی ضرورت ہوتی ہے اور ان کی قیمتوں کا ڈھانچہ بھی مختلف ہوتا ہے۔                                                  |
+| `model`              | AI خصوصیات میں استعمال ہونے والا AI ماڈل۔                                                                                       | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                             | کوئی نہیں   | `'gpt-4o-2024-11-20'`                                         | مخصوص ماڈلز فراہم کنندہ پر منحصر ہیں۔                                                                                                                       |
+| `temperature`        | AI کے جوابات میں بے ترتیبی (randomness) کو کنٹرول کرتا ہے۔                                                                      | `number`                                                                                                                                                                                                                                                                                                                                                                                                                                             | کوئی نہیں   | `0.1`                                                         | زیادہ ٹمپریچر = زیادہ تخلیقی لیکن کم قابل اعتماد جوابات۔                                                                                                    |
+| `apiKey`             | منتخب کردہ فراہم کنندہ کے لیے آپ کی API کلید۔                                                                                   | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                             | کوئی نہیں   | `process.env.OPENAI_API_KEY`                                  | خفیہ رکھیں؛ انوائرمنٹ ویری ایبلز میں محفوظ کریں۔                                                                                                            |
+| `applicationContext` | آپ کی ایپلیکیشن کے بارے میں اضافی تناظر تاکہ AI کو زیادہ درست ترجمے تیار کرنے میں مدد ملے (ڈومین، ٹارگٹ آڈینس، لہجہ، اصطلاحات)۔ | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                             | کوئی نہیں   | `'میرا اپنا ایپلیکیشن تناظر'`                                 | قواعد شامل کرنے کے لیے استعمال کیا جا سکتا ہے (مثلاً: `"آپ کو اپنے URLs کا ترجمہ نہیں کرنا چاہیے"`)۔                                                        |
+| `baseURL`            | AI API کے لیے بنیادی URL۔                                                                                                       | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                             | کوئی نہیں   | `'https://api.openai.com/v1'` <br/> `'http://localhost:5000'` | کسی مقامی یا کسٹم AI API اینڈ پوائنٹ سے رجوع کر سکتا ہے۔                                                                                                    |
+| `dataSerialization`  | AI خصوصیات کے لیے ڈیٹا سیریلائزیشن فارمیٹ۔                                                                                      | `'json'` &#124; <br/> `'toon'`                                                                                                                                                                                                                                                                                                                                                                                                                       | `undefined` | `'toon'`                                                      | • `'json'`: ڈیفالٹ، قابل اعتماد؛ زیادہ ٹوکن لیتا ہے۔<br/>• `'toon'`: کم ٹوکن، کم مستحکم۔<br/>• ماڈل کو اضافی پیرامیٹرز بھیجتا ہے (استدلال کی کوششیں وغیرہ)۔ |
 
 ---
 

package/docs/ur/interest_of_intlayer.md

@@ -188,7 +188,7 @@ export const ComponentExample = () => {
 یہ طریقہ کار آپ کو درج ذیل کی اجازت دیتا ہے:
 
 1. **ڈیولپمنٹ کی رفتار میں اضافہ**
-   - VSCode ایکسٹینشن کا استعمال کرتے ہوئے `.content.{{ts|mjs|cjs|json}}` فائلیں بنائی جا سکتی ہیں
+   - VSCode ایکسٹینشن کا استعمال کرتے ہوئے `.content.{ts|js|mjs|cjs|json|tsx|jsx|md|mdx|yaml|yml}` فائلیں بنائی جا سکتی ہیں
    - آپ کے IDE میں موجود آٹو کمپلیشن AI ٹولز (جیسے GitHub Copilot) مواد کو ڈیکلیئر کرنے میں آپ کی مدد کر سکتے ہیں، جس سے کاپی/پیسٹ کا کام کم ہو جاتا ہے
 
 2. **اپنے codebase کو صاف ستھرا بنانا**
@@ -212,27 +212,27 @@ export const ComponentExample = () => {
 
 ## Intlayer کی اضافی خصوصیات
 
-| Feature                                                                                                                   | Description                                                                                                                                                                                                                                                                                                                                                                                                                                |
-| ------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/frameworks.png?raw=true)                          | **کراس فریم ورک سپورٹ (Cross-Frameworks Support)**<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)       | **جاوا اسکرپٹ سے چلنے والا مواد کا انتظام (JavaScript-Powered Content Management)**<br><br>اپنے مواد کو مؤثر طریقے سے بیان اور منظم کرنے کے لیے جاوا اسکرپٹ کی لچک کا فائدہ اٹھائیں۔ <br><br> - [مواد کا اعلان (Content declaration)](https://intlayer.org/doc/concept/content)                                                                                                                                                            |
-| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/compiler.jpg?raw=true" alt="Feature" width="700">  | **کمپائلر (Compiler)**<br><br>Intlayer کمپائلر خود بخود اجزاء سے مواد نکالتا ہے اور ڈکشنری فائلیں تیار کرتا ہے۔<br><br> - [کمپائلر (Compiler)](https://intlayer.org/doc/compiler)                                                                                                                                                                                                                                                          |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/per_locale_content_declaration_file.png?raw=true) | **فی لوکیل مواد کے اعلان کی فائل (Per-Locale Content Declaration File)**<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)                      | **ٹائپ سیف ماحول (Type-Safe Environment)**<br><br>یہ یقینی بنانے کے لیے ٹائپ اسکرپٹ (TypeScript) کا استعمال کریں کہ آپ کے مواد کی تعریفیں اور کوڈ غلطیوں سے پاک ہیں، جبکہ 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)                         | **آسان سیٹ اپ (Simplified Setup)**<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)                   | **آسان مواد کا حصول (Simplified Content Retrieval)**<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)                    | **مستقل سرور کمپوننٹ عمل درآمد (Consistent Server Component Implementation)**<br><br>Next.js سرور اجزاء کے لیے بالکل موزوں، کلائنٹ اور سرور دونوں اجزاء کے لیے ایک ہی عمل درآمد کا استعمال کریں، ہر سرور جزو میں اپنے `t` فنکشن کو منتقل کرنے کی ضرورت نہیں ہے۔ <br><br> - [سرور اجزاء (Server Components)](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)                           | **منظم کوڈ بیس (Organized Codebase)**<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)                         | **بہتر روٹنگ (Enhanced Routing)**<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)                            | **مارک ڈاؤن سپورٹ (Markdown Support)**<br><br>کثیر لسانی مواد جیسے پرائیویسی پالیسیوں، دستاویزات وغیرہ کے لیے لوکیل فائلوں اور ریموٹ مارک ڈاؤن کو امپورٹ اور انٹرپریٹ کریں۔ اپنے کوڈ میں مارک ڈاؤن میٹا ڈیٹا کو قابل رسائی بنا کریں۔<br><br> - [مواد کی فائلیں (Content files)](https://intlayer.org/doc/concept/content/file)                                                                                                             |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/visual_editor.png?raw=true)                       | **مفت ویژول ایڈیٹر اور CMS (Free Visual Editor & 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 Content)**<br><br>ٹریس شیک ایبل مواد، جو حتمی بنڈل کے سائز کو کم کرتا ہے۔ ہر کمپوننٹ کے حساب سے مواد لوڈ کرتا ہے، آپ کے بنڈل سے کسی بھی غیر استعمال شدہ مواد کو خارج کرتا ہے۔ ایپ لوڈنگ کی کارکردگی کو بڑھانے کے لیے لیزی لوڈنگ کی حمایت کرتا ہے۔ <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)                    | **اسٹیٹک رینڈرنگ (Static Rendering)**<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 سے چلنے والا ترجمہ (AI-Powered Translation)**<br><br>اپنے اپنے AI فراہم کنندہ/API کی کا استعمال کرتے ہوئے Intlayer کے جدید AI سے چلنے والے ترجمے کے ٹولز کے ساتھ صرف ایک کلک میں اپنی ویب سائٹ کو 231 زبانوں میں تبدیل کریں۔ <br><br> - [CI/CD انٹیگریشن](https://intlayer.org/doc/concept/ci-cd) <br> - [Intlayer CLI](https://intlayer.org/doc/concept/cli) <br> - [آٹو فل (Auto fill)](https://intlayer.org/doc/concept/auto-fill) |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/mcp.png?raw=true)                                 | **MCP سرور انٹیگریشن (MCP Server Integration)**<br><br>IDE آٹومیشن کے لیے ایک MCP (Model Context Protocol) سرور فراہم کرتا ہے، جو آپ کے ڈویلپمنٹ ماحول کے اندر ہی ہموار مواد کے انتظام اور i18n ورک فلوز کو قابل بناتا ہے۔ <br><br> - [MCP سرور](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/mcp_server.md)                                                                                                              |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/vscode_extension.png?raw=true)                    | **VSCode ایکسٹینشن (VSCode Extension)**<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)                    | **باہمی مطابقت (Interoperability)**<br><br>react-i18next، next-i18next، next-intl، اور react-intl کے ساتھ باہمی مطابقت کی اجازت دیتا ہے۔ <br><br> - [Intlayer اور react-intl](https://intlayer.org/doc/blog/intlayer-with-react-intl) <br> - [Intlayer اور next-intl](https://intlayer.org/doc/blog/intlayer-with-next-intl) <br> - [Intlayer اور next-i18next](https://intlayer.org/doc/blog/intlayer-with-next-i18next)                  |
-| Testing Missing Translations (CLI/CI)                                                                                     | ✅ CLI: npx intlayer content test (CI کے لیے موزوں آڈٹ)                                                                                                                                                                                                                                                                                                                                                                                    |
+| Feature                                                                                                                   | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
+| ------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/frameworks.png?raw=true)                          | **کراس فریم ورک سپورٹ (Cross-Frameworks Support)**<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)       | **جاوا اسکرپٹ سے چلنے والا مواد کا انتظام (JavaScript-Powered Content Management)**<br><br>اپنے مواد کو مؤثر طریقے سے بیان اور منظم کرنے کے لیے جاوا اسکرپٹ کی لچک کا فائدہ اٹھائیں۔ <br><br> - [مواد کا اعلان (Content declaration)](https://intlayer.org/doc/concept/content)                                                                                                                                                                                                          |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/compiler.jpg?raw=true" alt="Feature" width="700">  | **کمپائلر (Compiler)**<br><br>Intlayer کمپائلر خود بخود اجزاء سے مواد نکالتا ہے اور ڈکشنری فائلیں تیار کرتا ہے۔<br><br> - [کمپائلر (Compiler)](https://intlayer.org/doc/compiler)                                                                                                                                                                                                                                                                                                        |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/per_locale_content_declaration_file.png?raw=true) | **فی لوکیل مواد کے اعلان کی فائل (Per-Locale Content Declaration File)**<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)                      | **ٹائپ سیف ماحول (Type-Safe Environment)**<br><br>یہ یقینی بنانے کے لیے ٹائپ اسکرپٹ (TypeScript) کا استعمال کریں کہ آپ کے مواد کی تعریفیں اور کوڈ غلطیوں سے پاک ہیں، جبکہ 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)                         | **آسان سیٹ اپ (Simplified Setup)**<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)                   | **آسان مواد کا حصول (Simplified Content Retrieval)**<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)                    | **مستقل سرور کمپوننٹ عمل درآمد (Consistent Server Component Implementation)**<br><br>Next.js سرور اجزاء کے لیے بالکل موزوں، کلائنٹ اور سرور دونوں اجزاء کے لیے ایک ہی عمل درآمد کا استعمال کریں، ہر سرور جزو میں اپنے `t` فنکشن کو منتقل کرنے کی ضرورت نہیں ہے۔ <br><br> - [سرور اجزاء (Server Components)](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)                           | **منظم کوڈ بیس (Organized Codebase)**<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)                         | **بہتر روٹنگ (Enhanced Routing)**<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)                            | **مارک ڈاؤن سپورٹ (Markdown Support)**<br><br>کثیر لسانی مواد جیسے پرائیویسی پالیسیوں، دستاویزات وغیرہ کے لیے لوکیل فائلوں اور ریموٹ مارک ڈاؤن کو امپورٹ اور انٹرپریٹ کریں۔ اپنے کوڈ میں مارک ڈاؤن میٹا ڈیٹا کو قابل رسائی بنا کریں۔<br><br> - [مواد کی فائلیں (Content files)](https://intlayer.org/doc/concept/content/file)                                                                                                                                                           |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/visual_editor.png?raw=true)                       | **مفت ویژول ایڈیٹر اور CMS (Free Visual Editor & 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 Content)**<br><br>ٹریس شیک ایبل مواد، جو حتمی بنڈل کے سائز کو کم کرتا ہے۔ ہر کمپوننٹ کے حساب سے مواد لوڈ کرتا ہے، آپ کے بنڈل سے کسی بھی غیر استعمال شدہ مواد کو خارج کرتا ہے۔ ایپ لوڈنگ کی کارکردگی کو بڑھانے کے لیے لیزی لوڈنگ کی حمایت کرتا ہے۔ <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)                    | **اسٹیٹک رینڈرنگ (Static Rendering)**<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 سے چلنے والا ترجمہ (AI-Powered Translation)**<br><br>اپنے اپنے AI فراہم کنندہ/API کی کا استعمال کرتے ہوئے Intlayer کے جدید AI سے چلنے والے ترجمے کے ٹولز کے ساتھ صرف ایک کلک میں اپنی ویب سائٹ کو 231 زبانوں میں تبدیل کریں۔ <br><br> - [CI/CD انٹیگریشن](https://intlayer.org/doc/concept/ci-cd) <br> - [Intlayer CLI](https://intlayer.org/doc/concept/cli) <br> - [آٹو فل (Auto fill)](https://intlayer.org/doc/concept/auto-fill)                                               |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/mcp.png?raw=true)                                 | **MCP سرور انٹیگریشن (MCP Server Integration)**<br><br>IDE آٹومیشن کے لیے ایک MCP (Model Context Protocol) سرور فراہم کرتا ہے، جو آپ کے ڈویلپمنٹ ماحول کے اندر ہی ہموار مواد کے انتظام اور i18n ورک فلوز کو قابل بناتا ہے۔ <br><br> - [MCP سرور](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/mcp_server.md)                                                                                                                                                            |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/vscode_extension.png?raw=true)                    | **VSCode ایکسٹینشن (VSCode Extension)**<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)                    | **باہمی مطابقت (Interoperability)**<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) <br> - [Intlayer کے کمپیٹ اڈاپٹرز](https://intlayer.org/doc/compatibility) |
+| Testing Missing Translations (CLI/CI)                                                                                     | ✅ CLI: npx intlayer content test (CI کے لیے موزوں آڈٹ)                                                                                                                                                                                                                                                                                                                                                                                                                                  |
 
 ## دیگر حلوں کے ساتھ Intlayer کا موازنہ
 
@@ -271,3 +271,5 @@ export const ComponentExample = () => {
 `intlayer` آپ کے `react-intl` ، `react-i18next` ، `next-intl` ، `next-i18next` ، اور `vue-i18n` نیم اسپیسز (namespaces) کو منظم کرنے میں بھی مدد کر سکتا ہے۔
 
 Intlayer کا استعمال کرتے ہوئے، آپ اپنے پسندیدہ i18n لائبریری کے فارمیٹ میں اپنے مواد کا اعلان کر سکتے ہیں، اور intlayer آپ کی پسند کے مقام پر آپ کے نیم اسپیسز تیار کرے گا (مثال کے طور پر: `/messages/{{locale}}/{{namespace}}.json`)۔
+
+اگر آپ اپنی موجودہ i18n لائبریری کا API استعمال کرتے رہنا چاہتے ہیں، تو `intlayer` **کمپیٹ اڈاپٹرز (compat adapters)** بھی فراہم کرتا ہے: ایسے پیکجز جو `react-i18next` ، `next-intl` ، `react-intl` ، `vue-i18n` اور دیگر کا بالکل وہی API فراہم کرتے ہیں، لیکن مواد Intlayer ڈکشنریز سے آتا ہے۔ اس سے آپ اپنا کوڈ دوبارہ لکھے بغیر بتدریج منتقل ہو سکتے ہیں۔ دیکھیں [کمپیٹ اڈاپٹرز کی دستاویزات](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/compat/index.md)۔

package/docs/vi/bundle_optimization.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-11-25
-updatedAt: 2026-06-07
+updatedAt: 2026-08-09
 title: Tối ưu hóa dung lượng Bundle & Hiệu suất i18n
 description: Giảm dung lượng bundle của ứng dụng bằng cách tối ưu hóa nội dung quốc tế hóa (i18n). Tìm hiểu cách tận dụng tree shaking và tải 지연 (lazy loading) cho các từ điển với Intlayer.
 keywords:
@@ -16,6 +16,12 @@ slugs:
   - concept
   - bundle-optimization
 history:
+  - version: 9.2.1
+    date: 2026-08-09
+    changes: "`purge` và `minify` giờ đã hoạt động trên Next.js thông qua `@intlayer/swc` — không cần `babel.config.js`"
+  - version: 8.12.0
+    date: 2026-06-24
+    changes: "Liệt kê các plugin Babel theo đúng thứ tự pipeline (extract → purge → minify → optimize) trong các bảng tham chiếu"
   - version: 8.12.0
     date: 2026-06-07
     changes: "Thêm `intlayerPurgeBabelPlugin` và `intlayerMinifyBabelPlugin` cho Babel/Webpack; làm rõ quá trình thực thi của các plugin"
@@ -191,12 +197,14 @@ Trình tối ưu hóa build của Intlayer được chia làm nhiều plugin ri
 
 Những plugin này được khai báo trực tiếp vào `babel.config.js` ở các dự án phụ thuộc cấu hình Webpack (như Next.js dùng Babel, CRA, hoặc Webpack tùy chỉnh v.v.).
 
+Bảng dưới đây liệt kê chúng theo đúng thứ tự pipeline (cùng thứ tự mà chúng phải xuất hiện trong `babel.config.js`):
+
 | Plugin                        | Công dụng                                                                                                                                     |
 | :---------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------- |
 | `intlayerExtractBabelPlugin`  | Quét các file `.content.ts` và ghi nội dung từ điển đã biên dịch thành định dạng chuẩn vào thư mục `.intlayer/`                               |
-| `intlayerOptimizeBabelPlugin` | Viết lại `useIntlayer('key')` thành `useDictionary(hash)` và tự động inject thư viện `import` để nạp từ điển khớp tương ứng                   |
 | `intlayerPurgeBabelPlugin`    | Quét toàn bộ mã nguồn, thực hiện loại bỏ (remove) **các trường nội dung không được sử dụng** ở file từ điển JSON tại `.intlayer/**/*.json`    |
 | `intlayerMinifyBabelPlugin`   | **Rút ngắn tên (rename) khóa (keys) của nội dung** thành ký tự ngắn rút gọn (vd: `title` đổi thành `a`) ở JSON cũng như bên trong Source Code |
+| `intlayerOptimizeBabelPlugin` | Viết lại `useIntlayer('key')` thành `useDictionary(hash)` và tự động inject thư viện `import` để nạp từ điển khớp tương ứng                   |
 
 > **Thứ tự sắp xếp của plugin là rất quan trọng.** Trong `babel.config.js` của bạn, các plugin purge và minify phải được đặt **trước** plugin optimize. Bước optimize thay thế `useIntlayer('key')` bằng một hàm gọi không minh bạch `useDictionary(hash)`, điều này có khả năng làm mất thông tin dictionary-key gốc - vốn là thông tin cần thiết để purge và minify có thể định danh các trường thuộc tính đang được ứng dụng.
 
@@ -205,9 +213,9 @@ Mỗi plugin Babel sẽ đi kèm một helper option để đọc trực tiếp
 | Options helper               | Dùng cùng với                 |
 | :--------------------------- | :---------------------------- |
 | `getExtractPluginOptions()`  | `intlayerExtractBabelPlugin`  |
-| `getOptimizePluginOptions()` | `intlayerOptimizeBabelPlugin` |
 | `getPurgePluginOptions()`    | `intlayerPurgeBabelPlugin`    |
 | `getMinifyPluginOptions()`   | `intlayerMinifyBabelPlugin`   |
+| `getOptimizePluginOptions()` | `intlayerOptimizeBabelPlugin` |
 
 ### Các plugin của Vite (`vite-intlayer`)
 
@@ -220,6 +228,20 @@ Những người dùng Vite **không bao giờ phải cấu hình cái này mộ
 | Dictionary minify     | Tương tự quy trình cắt giảm và rút ngắn độ dài JSON của `intlayerMinifyBabelPlugin` qua JSON                                                       |
 | Babel transform       | Tương tự quá trình viết lại tên khóa (key rename) bên nguồn code của `intlayerMinifyBabelPlugin` + thay phiên mã của `intlayerOptimizeBabelPlugin` |
 
+### Plugin SWC (`@intlayer/swc`)
+
+Người dùng Next.js cũng **không bao giờ cấu hình những thứ này trực tiếp**. Từ **v9.2.1**, `withIntlayer()` trong `next.config.ts` chạy toàn bộ pipeline — purge, minify và viết lại import — chỉ dựa trên hai cờ `build.purge` và `build.minify`.
+
+Công việc được chia làm hai, vì một plugin Wasm của SWC chỉ biến đổi một tệp tại một thời điểm và không có quyền truy cập hệ thống tệp:
+
+| Lượt xử lý                                 | Chạy ở đâu                       | Làm gì                                                                                   |
+| :----------------------------------------- | :------------------------------- | :--------------------------------------------------------------------------------------- |
+| Phân tích sử dụng + purge/minify JSON      | Node, bên trong `withIntlayer()` | Đọc mọi tệp nguồn của component, viết lại `.intlayer/**/*.json`, tạo ra các bảng đổi tên |
+| Viết lại mã nguồn (`content.title` → `.a`) | `@intlayer/swc` (Wasm)           | Áp dụng các bảng đổi tên cho những truy cập thuộc tính tương ứng trong mã của bạn        |
+| Viết lại import (`useIntlayer` → dict)     | `@intlayer/swc` (Wasm)           | Giống `intlayerOptimizeBabelPlugin`                                                      |
+
+Việc xác định _những_ trường nào không được dùng và mỗi trường nhận _bí danh_ nào đòi hỏi trạng thái xuyên tệp và I/O tệp, nên nửa đó chạy trong Node; plugin SWC chỉ nhận các bảng kết quả.
+
 ## Tùy chỉnh thiết lập dựa vào Platform (nền tảng)
 
 <Tabs>
@@ -227,10 +249,12 @@ Những người dùng Vite **không bao giờ phải cấu hình cái này mộ
 
 ### Next.js
 
-Next.js yêu cầu có plugin `@intlayer/swc` cho bước optimize (bước thay thế các lệnh import của hệ thống), do Next.js dùng lõi SWC làm công cụ biên dịch tự động.
+Next.js cần plugin `@intlayer/swc`, vì Next.js dùng SWC để build. Từ **v9.2.1**, chỉ một gói này đã bao trọn toàn bộ pipeline — tối ưu hóa (viết lại import), purge và minify.
 
 > Plugin này không cài đặt theo mặc định bởi vì nền tảng hỗ trợ (API SWC Plugins) trên Next.js vẫn còn là một thử nghiệm. Do đó sẽ có thay đổi khi nó được cập nhật.
 
+> **Next.js 16.1.0 là phiên bản tối thiểu.** Đây là bản phát hành đầu tiên được xây dựng trên ABI plugin Wasm tương thích tiến của SWC; các bản trước đó từ chối plugin. `withIntlayer` đọc phiên bản Next.js của dự án và đơn giản là không đăng ký plugin nếu thấp hơn 16.1.0 — các build đó vẫn thành công, chỉ là chạy mà không có tối ưu hóa bundle.
+
 <Tabs>
  <Tab value="npm">
 
@@ -265,33 +289,40 @@ intlayer-swc-plugin = "*"
 
 Sau khi hoàn tất, Intlayer có thể tìm kiếm và ứng dụng tự động nó cho phần compile hệ thống.
 
-Để áp dụng các bước thao tác **purge và minify** (chức năng xóa bỏ các trường hoặc cấu trúc bị dư thừa, đặt biệt danh thay thế cho file), nên thực hiện bổ sung cài `@intlayer/babel` và thiết lập trên config của Babel. Vì bản thân lõi Next.js dù sử dụng SWC trong quy trình dịch mã cho code (transform) nhưng lại luôn thực hiện phân giải config cài đặt của Babel (qua file `babel.config.js`). Cho nên plugin của Babel sẽ vận hành như bước khởi động tiền đề trước khi chạy SWC.
+Các lượt **purge và minify** (xóa trường và đổi tên trường) không cần gói bổ sung nào cũng không cần `babel.config.js`. Hãy bọc cấu hình của bạn bằng `withIntlayer` và bật các cờ trong `intlayer.config.ts`:
 
-```bash packageManager="npm"
-npm install -D @intlayer/babel
+```typescript fileName="next.config.ts"
+import { withIntlayer } from "next-intlayer/server";
+import type { NextConfig } from "next";
+
+const nextConfig: NextConfig = {/* cấu hình của bạn */};
+
+export default withIntlayer(nextConfig);
 ```
 
-```javascript fileName="babel.config.js"
-const {
-  intlayerPurgeBabelPlugin,
-  intlayerMinifyBabelPlugin,
-  getPurgePluginOptions,
-  getMinifyPluginOptions,
-} = require("@intlayer/babel");
+```typescript fileName="intlayer.config.ts"
+import type { IntlayerConfig } from "intlayer";
 
-module.exports = {
-  presets: ["next/babel"],
-  plugins: [
-    // Purge: hủy bỏ các trường đã không còn sử dụng được tìm thấy bên trong .intlayer/**/*.json
-    [intlayerPurgeBabelPlugin, getPurgePluginOptions()],
-    // Minify: rút gọn và rút ngắn tên cho các JSON + sửa lệnh ở trên source code
-    [intlayerMinifyBabelPlugin, getMinifyPluginOptions()],
-    // Lưu ý: Không cần đến khai báo `intlayerOptimizeBabelPlugin` ở đây vì
-    // @intlayer/swc đã tiếp quản tiến trình biến đổi useIntlayer → useDictionary.
-  ],
+const config: IntlayerConfig = {
+  build: {
+    purge: true, // xóa các trường nội dung không dùng khỏi JSON được đóng gói
+    minify: true, // đổi tên khóa trường nội dung thành bí danh ngắn
+  },
 };
+
+export default config;
 ```
 
+Trong quá trình `next build`, `withIntlayer` phân tích mã nguồn, viết lại các từ điển đã biên dịch và chuyển các bảng đổi tên trường thu được cho `@intlayer/swc`, plugin này cập nhật những truy cập thuộc tính tương ứng trong mã của bạn.
+
+> Hãy dùng `withIntlayer` bất đồng bộ, không phải `withIntlayerSync`. Biến thể đồng bộ không chạy pipeline phân tích, nên purge và minify không có tác dụng với nó.
+
+> Purge và minify chỉ chạy khi `next build` — pipeline tối ưu hóa tắt trong lúc `next dev`.
+
+> Chúng cũng bị tắt khi có cấu hình các lời gọi từ bộ chuyển đổi tương thích (`swcExtraCallers`, do các gói tương thích như `@intlayer/next-intl` hay `@intlayer/react-i18next` thiết lập): những điểm gọi đó vô hình với bộ phân tích sử dụng, nên purge sẽ xóa mất các trường mà mã vẫn đang đọc. Việc viết lại import vẫn hoạt động.
+
+**Các phiên bản trước (trước 9.2.1)** yêu cầu `@intlayer/babel` và một tệp `babel.config.js` khai báo `intlayerPurgeBabelPlugin` và `intlayerMinifyBabelPlugin`. Tệp đó không còn cần thiết và có thể xóa.
+
  </Tab>
  <Tab value="vite">
 
@@ -447,6 +478,8 @@ export default config;
 
 > Lưu ý: Sự can thiệp minify sẽ ngừng thực hiện nếu cờ `optimize` được kích ở mức `false` hoặc lúc bộ hiển thị bằng editor đang dùng tham số `editor.enabled` = `true` (do phía editor thiết kế cần đọc đúng định dạng khai báo nguồn nội dung ban đầu từ file config).
 
+> Trên Next.js, minify cũng bị bỏ qua khi `@intlayer/swc` không được cài đặt hoặc không thể tải (Next.js dưới 16.1.0). Plugin chính là nửa viết lại các truy cập trong mã nguồn, nên đổi tên từ điển mà thiếu nó sẽ khiến mã của bạn đọc những tên trường không còn tồn tại.
+
 > Sự can thiệp bằng minify đồng thời mất kiểm soát khi tải từ các lệnh gọi JSON ngoại lai của server api khác thông qua thông số gán thiết lập mặc định qua file nguồn `importMode: 'fetch'` — điều này giải quyết và chống phá hỏng liên lạc bằng json của đầu ra máy chủ do nếu app tại máy tính người xài thay danh định gốc trên code sẽ đứt đường tiếp nhận dữ liệu phía cloud.
 
 ### Hệ chức năng gạt bỏ rác Purging (xóa trắng các khóa thuộc tính trống hoặc dư)
@@ -475,7 +508,7 @@ export default config;
 { "title": "…", "subtitle": "…" }
 ```
 
-> Hãy cân nhắc bởi Purge cũng chẳng khác gì minify, hệ sẽ phớt lờ thao tác nếu như thông số thuộc `optimize` để là `false` hay công cụ trình hỗ trợ `editor.enabled` đang mở (true).
+> Hãy cân nhắc bởi Purge cũng chẳng khác gì minify, hệ sẽ phớt lờ thao tác nếu như thông số thuộc `optimize` để là `false` hay công cụ trình hỗ trợ `editor.enabled` đang mở (true). Trên Next.js, nó còn bị bỏ qua khi `@intlayer/swc` không khả dụng và khi có cấu hình các lời gọi từ bộ chuyển đổi tương thích.
 
 > Ngoài ra chức năng của hệ cũng bảo lưu quy trình rủi ro và buộc dừng tiến trình purge (như khi không parse được code nguồn để phân tích), hoặc lệnh trả biến ở bộ thu nhận `useIntlayer` xài như thông số ẩn hoặc bị mã hóa ngầm lúc khai báo truyền tin nên analyzer bot mất dấu để định hướng hành tung của nội dung nguồn (một trường hợp cụ thể đó là kiểu trải dữ liệu `spread` cho vô Object bự xài nhưng quên không destructure rõ ràng tham số lúc dùng trong prop). Tại ranh giới bất an kiểu này hệ tự ép lấy sạch sành sanh cho yên tâm trọn gói JSON mà khỏi sợ cắt lố làm mất dữ liệu oan.
 

package/docs/vi/configuration.md

@@ -403,7 +403,7 @@ const config: IntlayerConfig = {
   ai: {
     /**
      * Nhà cung cấp AI được sử dụng.
-     * Tùy chọn: 'openai', 'anthropic', 'mistral', 'deepseek', 'gemini', 'ollama', 'openrouter', 'alibaba', 'fireworks', 'groq', 'huggingface', 'bedrock', 'googlevertex', 'togetherai', 'lmstudio'
+     * Tùy chọn: 'openai', 'anthropic', 'mistral', 'deepseek', 'gemini', 'ollama', 'openrouter', 'alibaba', 'fireworks', 'groq', 'huggingface', 'bedrock', 'googlevertex', 'togetherai', 'lmstudio', 'moonshotai'
      * Mặc định: 'openai'
      */
     provider: "openai",
@@ -1031,15 +1031,15 @@ Intlayer hỗ trợ đa dạng các nhà cung cấp AI để mang lại sự lin
 - **Together.ai**
 - **LM Studio**
 
-| Trường               | Mô tả                                                                                                                                   | Kiểu dữ liệu                                                                                                                                                                                                                                                                                                                                                                                                             | Mặc định    | Ví dụ                                                         | Nhận xét                                                                                                                                                                                        |
-| -------------------- | --------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------- | ------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `provider`           | Nhà cung cấp được sử dụng cho các tính năng AI của Intlayer.                                                                            | `'openai'` &#124; <br/> `'anthropic'` &#124; <br/> `'mistral'` &#124; <br/> `'deepseek'` &#124; <br/> `'gemini'` &#124; <br/> `'ollama'` &#124; <br/> `'openrouter'` &#124; <br/> `'alibaba'` &#124; <br/> `'fireworks'` &#124; <br/> `'groq'` &#124; <br/> `'huggingface'` &#124; <br/> `'bedrock'` &#124; <br/> `'googleaistudio'` &#124; <br/> `'googlevertex'` &#124; <br/> `'togetherai'` &#124; <br/> `'lmstudio'` | `undefined` | `'anthropic'`                                                 | Các nhà cung cấp khác nhau yêu cầu các khóa API khác nhau và có mức giá khác nhau.                                                                                                              |
-| `model`              | Model AI được sử dụng cho các tính năng AI.                                                                                             | `string`                                                                                                                                                                                                                                                                                                                                                                                                                 | Không có    | `'gpt-4o-2024-11-20'`                                         | Các model cụ thể phụ thuộc vào nhà cung cấp.                                                                                                                                                    |
-| `temperature`        | Điều khiển tính ngẫu nhiên của phản hồi AI.                                                                                             | `number`                                                                                                                                                                                                                                                                                                                                                                                                                 | Không có    | `0.1`                                                         | Nhiệt độ cao hơn = sáng tạo hơn và kém đáng tin cậy hơn.                                                                                                                                        |
-| `apiKey`             | Khóa API của bạn cho nhà cung cấp đã chọn.                                                                                              | `string`                                                                                                                                                                                                                                                                                                                                                                                                                 | Không có    | `process.env.OPENAI_API_KEY`                                  | Phải được giữ bí mật; sử dụng biến môi trường.                                                                                                                                                  |
-| `applicationContext` | Ngữ cảnh bổ sung về ứng dụng của bạn để giúp AI tạo ra các bản dịch chính xác hơn (lĩnh vực, đối tượng mục tiêu, tông điệu, thuật ngữ). | `string`                                                                                                                                                                                                                                                                                                                                                                                                                 | Không có    | `'ngữ cảnh ứng dụng tùy chỉnh của tôi'`                       | Có thể được sử dụng để thêm các quy tắc (ví dụ: `"Bạn không nên dịch các URL của bạn"` ).                                                                                                       |
-| `baseURL`            | URL cơ sở cho AI API.                                                                                                                   | `string`                                                                                                                                                                                                                                                                                                                                                                                                                 | Không có    | `'https://api.openai.com/v1'` <br/> `'http://localhost:5000'` | Có thể trỏ tới các endpoint AI API cục bộ hoặc tùy chỉnh.                                                                                                                                       |
-| `dataSerialization`  | Định dạng tuần tự hóa dữ liệu cho các tính năng AI.                                                                                     | `'json'` &#124; <br/> `'toon'`                                                                                                                                                                                                                                                                                                                                                                                           | `undefined` | `'toon'`                                                      | • `'json'`: mặc định, đáng tin cậy; sử dụng nhiều token hơn.<br/>• `'toon'`: ít token hơn, kém ổn định hơn.<br/>• Chuyển ngữ cảnh cho model dưới dạng một tham số phụ (reasoning effort, v.v.). |
+| Trường               | Mô tả                                                                                                                                   | Kiểu dữ liệu                                                                                                                                                                                                                                                                                                                                                                                                                                         | Mặc định    | Ví dụ                                                         | Nhận xét                                                                                                                                                                                        |
+| -------------------- | --------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- | ------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `provider`           | Nhà cung cấp được sử dụng cho các tính năng AI của Intlayer.                                                                            | `'openai'` &#124; <br/> `'anthropic'` &#124; <br/> `'mistral'` &#124; <br/> `'deepseek'` &#124; <br/> `'gemini'` &#124; <br/> `'ollama'` &#124; <br/> `'openrouter'` &#124; <br/> `'alibaba'` &#124; <br/> `'fireworks'` &#124; <br/> `'groq'` &#124; <br/> `'huggingface'` &#124; <br/> `'bedrock'` &#124; <br/> `'googleaistudio'` &#124; <br/> `'googlevertex'` &#124; <br/> `'togetherai'` &#124; <br/> `'lmstudio'` &#124; <br/> `'moonshotai'` | `undefined` | `'anthropic'`                                                 | Các nhà cung cấp khác nhau yêu cầu các khóa API khác nhau và có mức giá khác nhau.                                                                                                              |
+| `model`              | Model AI được sử dụng cho các tính năng AI.                                                                                             | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                             | Không có    | `'gpt-4o-2024-11-20'`                                         | Các model cụ thể phụ thuộc vào nhà cung cấp.                                                                                                                                                    |
+| `temperature`        | Điều khiển tính ngẫu nhiên của phản hồi AI.                                                                                             | `number`                                                                                                                                                                                                                                                                                                                                                                                                                                             | Không có    | `0.1`                                                         | Nhiệt độ cao hơn = sáng tạo hơn và kém đáng tin cậy hơn.                                                                                                                                        |
+| `apiKey`             | Khóa API của bạn cho nhà cung cấp đã chọn.                                                                                              | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                             | Không có    | `process.env.OPENAI_API_KEY`                                  | Phải được giữ bí mật; sử dụng biến môi trường.                                                                                                                                                  |
+| `applicationContext` | Ngữ cảnh bổ sung về ứng dụng của bạn để giúp AI tạo ra các bản dịch chính xác hơn (lĩnh vực, đối tượng mục tiêu, tông điệu, thuật ngữ). | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                             | Không có    | `'ngữ cảnh ứng dụng tùy chỉnh của tôi'`                       | Có thể được sử dụng để thêm các quy tắc (ví dụ: `"Bạn không nên dịch các URL của bạn"` ).                                                                                                       |
+| `baseURL`            | URL cơ sở cho AI API.                                                                                                                   | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                             | Không có    | `'https://api.openai.com/v1'` <br/> `'http://localhost:5000'` | Có thể trỏ tới các endpoint AI API cục bộ hoặc tùy chỉnh.                                                                                                                                       |
+| `dataSerialization`  | Định dạng tuần tự hóa dữ liệu cho các tính năng AI.                                                                                     | `'json'` &#124; <br/> `'toon'`                                                                                                                                                                                                                                                                                                                                                                                                                       | `undefined` | `'toon'`                                                      | • `'json'`: mặc định, đáng tin cậy; sử dụng nhiều token hơn.<br/>• `'toon'`: ít token hơn, kém ổn định hơn.<br/>• Chuyển ngữ cảnh cho model dưới dạng một tham số phụ (reasoning effort, v.v.). |
 
 ---