@intlayer/docs 8.9.4-canary.0 → 8.9.5

package/docs/ar/plugins/sync-po.md

@@ -0,0 +1,333 @@
+---
+createdAt: 2026-05-10
+updatedAt: 2026-05-10
+title: إضافة Sync PO
+description: قم بمزامنة قواميس Intlayer مع ملفات Gettext PO. حافظ على نظام i18n الحالي الخاص بك مع استخدام Intlayer لإدارة رسائلك وترجمتها واختبارها.
+keywords:
+  - Intlayer
+  - Sync PO
+  - Gettext
+  - i18n
+  - ترجمات
+slugs:
+  - doc
+  - plugin
+  - sync-po
+youtubeVideo: https://www.youtube.com/watch?v=MpGMxniDHNg
+history:
+  - version: 8.9.4
+    date: 2026-05-10
+    changes: "التوثيق الأولي لإضافة Sync PO"
+---
+
+# Sync PO (جسور i18n) - مزامنة PO مع دعم ICU / i18next
+
+استخدم Intlayer كإضافة لمجموعة أدوات i18n الحالية لديك. تحافظ هذه الإضافة على رسائل Gettext PO الخاصة بك متزامنة مع قواميس Intlayer حتى تتمكن من:
+
+- الحفاظ على سير عمل الترجمة الحالي المعتمد على PO.
+- إدارة رسائلك وترجمتها باستخدام Intlayer (CLI، CI، المزودين، CMS)، دون إعادة صياغة تطبيقك.
+- شحن الدروس ومحتوى SEO الذي يستهدف كل نظام بيئي، مع اقتراح Intlayer كطبقة إدارة PO.
+
+ملاحظات والنطاق الحالي:
+
+- يعمل التصدير الخارجي إلى CMS للترجمات والنصوص الكلاسيكية.
+- لا يوجد دعم حتى الآن للإدراجات، أو الجموع/ICU، أو ميزات وقت التشغيل المتقدمة للمكتبات الأخرى داخل مدخلات PO نفسها.
+- المحرر المرئي غير مدعوم بعد لمخرجات i18n التابعة لجهات خارجية.
+
+### متى تستخدم هذه الإضافة
+
+- أنت تستخدم بالفعل ملفات Gettext PO لترجماتك.
+- تريد التعبئة بمساعدة الذكاء الاصطناعي، والاختبار في CI، وعمليات المحتوى دون تغيير وقت تشغيل العرض الخاص بك.
+
+## التثبيت
+
+```bash
+pnpm add -D @intlayer/sync-po-plugin
+# أو
+npm i -D @intlayer/sync-po-plugin
+```
+
+## الإضافات
+
+توفر هذه الحزمة إضافتين:
+
+- `loadPO`: تحميل ملفات PO في قواميس Intlayer.
+  - تُستخدم هذه الإضافة لتحميل ملفات PO من مصدر وسيتم تحميلها في قواميس Intlayer. يمكنها مسح كامل قاعدة الأكواد والبحث عن ملفات PO محددة.
+    يمكن استخدام هذه الإضافة:
+    - إذا كنت تستخدم مكتبة i18n تفرض موقعًا معينًا لتحميل ملفات PO الخاصة بك، ولكنك تريد وضع إعلان المحتوى الخاص بك في أي مكان تريده في قاعدة الأكواد الخاصة بك.
+    - يمكن استخدامها أيضًا إذا كنت تريد جلب رسائلك من مصدر بعيد (مثل: CMS، API، إلخ) وتخزين رسائلك في ملفات PO.
+
+  > تحت الغطاء، ستقوم هذه الإضافة بمسح كامل قاعدة الأكواد والبحث عن ملفات PO محددة وتحميلها في قواميس Intlayer.
+  > لاحظ أن هذه الإضافة لن تكتب المخرجات والترجمات مرة أخرى في ملفات PO.
+
+- `syncPO`: مزامنة ملفات PO مع قواميس Intlayer.
+  - تُستخدم هذه الإضافة لمزامنة ملفات PO مع قواميس Intlayer. يمكنها مسح الموقع المحدد وتحميل ملفات PO التي تطابق النمط لملفات PO محددة. هذه الإضافة مفيدة إذا كنت تريد الحصول على فوائد Intlayer أثناء استخدام مكتبة i18n أخرى.
+
+## استخدام كلتا الإضافتين
+
+```ts fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+import { loadPO, syncPO } from "@intlayer/sync-po-plugin";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
+
+  // حافظ على ملفات PO الحالية متزامنة مع قواميس Intlayer
+  plugins: [
+    /**
+     * سيقوم بتحميل جميع ملفات PO في src التي تطابق النمط {key}.i18n.po
+     */
+    loadPO({
+      source: ({ key }) => `./src/**/${key}.i18n.po`,
+      locale: Locales.ENGLISH,
+      priority: 1, // يضمن أن ملفات PO هذه لها الأولوية على الملفات في `./locales/en/${key}.po`
+    }),
+    /**
+     * سيقوم بتحميل وكتابة المخرجات والترجمات مرة أخرى في ملفات PO في دليل locales
+     */
+    syncPO({
+      source: ({ key, locale }) => `./locales/${locale}/${key}.po`,
+      priority: 0,
+    }),
+  ],
+};
+
+export default config;
+```
+
+## إضافة `syncPO`
+
+### بداية سريعة
+
+أضف الإضافة إلى `intlayer.config.ts` الخاص بك ووجهها إلى هيكل PO الحالي لديك.
+
+```ts fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+import { syncPO } from "@intlayer/sync-po-plugin";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
+
+  // حافظ على ملفات PO الحالية متزامنة مع قواميس Intlayer
+  plugins: [
+    syncPO({
+      // تخطيط لكل لغة ولكل مساحة اسم
+      source: ({ key, locale }) => `./locales/${locale}/${key}.po`,
+    }),
+  ],
+};
+
+export default config;
+```
+
+بديل: ملف واحد لكل لغة:
+
+```ts fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+import { syncPO } from "@intlayer/sync-po-plugin";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH],
+    defaultLocale: Locales.ENGLISH,
+  },
+  plugins: [
+    syncPO({
+      source: ({ locale }) => `./locales/${locale}.po`,
+    }),
+  ],
+};
+
+export default config;
+```
+
+#### كيف تعمل
+
+- القراءة: تكتشف الإضافة ملفات PO من منشئ `source` الخاص بك وتحملها كقواميس Intlayer.
+- الكتابة: بعد عمليات البناء والتعبئة، تقوم بكتابة ملفات PO المترجمة مرة أخرى إلى نفس المسارات (مع رؤوس Gettext المناسبة).
+- التعبئة التلقائية: تعلن الإضافة عن مسار `autoFill` لكل قاموس. تشغيل `intlayer fill` يقوم بتحديث الترجمات المفقودة فقط في ملفات PO الخاصة بك بشكل افتراضي.
+
+واجهة برمجة التطبيقات (API):
+
+```ts
+syncPO({
+  source: ({ key, locale }) => string, // مطلوب
+  location?: string, // تسمية اختيارية، الافتراضي: "sync-po::path/to/source"
+  priority?: number, // أولوية اختيارية لحل النزاعات، الافتراضي: 0
+});
+```
+
+### مصادر PO متعددة والأولوية
+
+يمكنك إضافة إضافات `syncPO` متعددة لمزامنة مصادر PO مختلفة. هذا مفيد عندما يكون لديك مصادر ترجمة متعددة أو هياكل PO مختلفة في مشروعك.
+
+#### نظام الأولوية
+
+عندما تستهدف إضافات متعددة نفس مفتاح القاموس، تحدد معلمة `priority` أي إضافة لها الأسبقية:
+
+- أرقام الأولوية الأعلى تفوز على الأرقام الأقل
+- الأولوية الافتراضية لملفات `.content` هي `0`
+- الأولوية الافتراضية للإضافات هي `0`
+- تتم معالجة الإضافات التي لها نفس الأولوية بالترتيب الذي تظهر به في التكوين
+
+```ts fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+import { syncPO } from "@intlayer/sync-po-plugin";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH],
+    defaultLocale: Locales.ENGLISH,
+  },
+
+  plugins: [
+    // مصدر PO الأساسي (أعلى أولوية)
+    syncPO({
+      source: ({ key, locale }) => `./locales/${locale}/${key}.po`,
+      location: "main-translations",
+      priority: 10,
+    }),
+
+    // مصدر PO احتياطي (أولوية أقل)
+    syncPO({
+      source: ({ locale }) => `./fallback-locales/${locale}.po`,
+      location: "fallback-translations",
+      priority: 5,
+    }),
+
+    // مصدر PO قديم (أقل أولوية)
+    syncPO({
+      source: ({ locale }) => `/my/other/app/legacy/${locale}/messages.po`,
+      location: "legacy-translations",
+      priority: 1,
+    }),
+  ],
+};
+
+export default config;
+```
+
+## إضافة Load PO
+
+### بداية سريعة
+
+أضف الإضافة إلى `intlayer.config.ts` لاستيعاب ملفات PO الحالية كقواميس Intlayer. هذه الإضافة للقراءة فقط (لا توجد كتابة على القرص):
+
+```ts fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+import { loadPO } from "@intlayer/sync-po-plugin";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
+
+  plugins: [
+    // استيعاب رسائل PO الموجودة في أي مكان في شجرة المصدر الخاصة بك
+    loadPO({
+      source: ({ key }) => `./src/**/${key}.i18n.po`,
+      // تحميل لغة واحدة لكل نسخة إضافة (يتم تعيينها افتراضيًا على defaultLocale للتكوين)
+      locale: Locales.ENGLISH,
+      priority: 0,
+    }),
+  ],
+};
+
+export default config;
+```
+
+بديل: تخطيط لكل لغة، لا يزال للقراءة فقط (يتم تحميل اللغة المحددة فقط):
+
+```ts fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+import { loadPO } from "@intlayer/sync-po-plugin";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH],
+    defaultLocale: Locales.ENGLISH,
+  },
+  plugins: [
+    loadPO({
+      // سيتم تحميل الملفات لـ Locales.FRENCH فقط من هذا النمط
+      source: ({ key, locale }) => `./locales/${locale}/${key}.po`,
+      locale: Locales.FRENCH,
+    }),
+  ],
+};
+
+export default config;
+```
+
+### كيف تعمل
+
+- الاكتشاف: يبني glob من منشئ `source` الخاص بك ويجمع ملفات PO المطابقة.
+- الاستيعاب: يحمل كل ملف PO كقاموس Intlayer مع `locale` المقدم.
+- للقراءة فقط: لا يكتب أو ينسق ملفات المخرجات؛ استخدم `syncPO` إذا كنت بحاجة إلى مزامنة ذهاب وإياب.
+- جاهز للتعبئة التلقائية: يحدد مسار `fill` حتى يتمكن `intlayer content fill` من تعبئة المفاتيح المفقودة.
+
+### واجهة برمجة التطبيقات (API)
+
+```ts
+loadPO({
+  // بناء المسارات إلى ملفات PO الخاصة بك. `locale` اختياري إذا كان هيكلك لا يحتوي على جزء للغة
+  source: ({ key, locale }) => string,
+
+  // اللغة المستهدفة للقواميس التي يتم تحميلها بواسطة نسخة الإضافة هذه
+  // يتم تعيينها افتراضيًا على configuration.internationalization.defaultLocale
+  locale?: Locale,
+
+  // تسمية اختيارية لتحديد المصدر
+  location?: string, // الافتراضي: "plugin"
+
+  // الأولوية المستخدمة لحل النزاعات ضد المصادر الأخرى
+  priority?: number, // الافتراضي: 0
+});
+```
+
+### السلوك والاتفاقيات
+
+- إذا كان قناع `source` الخاص بك يتضمن نائب لغة، فسيتم استيعاب الملفات الخاصة بـ `locale` المحدد فقط.
+- إذا لم يكن هناك جزء `{key}` في قناعك، فسيكون مفتاح القاموس "index".
+- يتم اشتقاق المفاتيح من مسارات الملفات عن طريق استبدال النائب `{key}` في منشئ `source` الخاص بك.
+- تستخدم الإضافة الملفات المكتشفة فقط ولا تصطنع لغات أو مفاتيح مفقودة.
+- يتم استنتاج مسار `fill` من `source` الخاص بك ويستخدم لتحديث القيم المفقودة عبر CLI عند اختيارك.
+
+## حل النزاعات
+
+عندما يوجد نفس مفتاح الترجمة في مصادر PO متعددة:
+
+1. تحدد الإضافة ذات الأولوية القصوى القيمة النهائية
+2. تُستخدم المصادر ذات الأولوية الأقل كبدائل للمفاتيح المفقودة
+3. يتيح لك هذا الحفاظ على الترجمات القديمة مع الانتقال تدريجيًا إلى الهياكل الجديدة
+
+## واجهة سطر الأوامر (CLI)
+
+سيتم اعتبار ملفات PO المتزامنة كملفات `.content` أخرى. وهذا يعني أن جميع أوامر intlayer ستكون متاحة لملفات PO المتزامنة. بما في ذلك:
+
+- `intlayer content test` لاختبار ما إذا كانت هناك ترجمات مفقودة
+- `intlayer content list` لسرد ملفات PO المتزامنة
+- `intlayer content fill` لتعبئة الترجمات المفقودة
+- `intlayer content push` لدفع ملفات PO المتزامنة
+- `intlayer content pull` لسحب ملفات PO المتزامنة
+
+راجع [Intlayer CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/cli/index.md) لمزيد من التفاصيل.
+
+## القيود (الحالية)
+
+- لا يوجد دعم للإدراجات أو الجموع/ICU عند استهداف مكتبات جهات خارجية.
+- المحرر المرئي غير متاح لأوقات التشغيل غير التابعة لـ Intlayer بعد.
+- مزامنة PO فقط؛ تنسيقات الفهرس غير التابعة لـ PO غير مدعومة.
+
+## لماذا هذا مهم
+
+- يمكننا التوصية بحلول i18n الراسخة ووضع Intlayer كإضافة.
+- نحن نستفيد من SEO/الكلمات الرئيسية الخاصة بهم مع دروس تنتهي باقتراح Intlayer لإدارة PO.
+- يوسع الجمهور القابل للاستهداف من "المشاريع الجديدة" إلى "أي فريق يستخدم بالفعل i18n".

package/docs/bn/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-04-08
+updatedAt: 2026-05-12
 title: কনফিগারেশন (Configuration)
 description: আপনার অ্যাপ্লিকেশনের জন্য Intlayer কীভাবে কনফিগার করবেন তা শিখুন। আপনার প্রয়োজন অনুযায়ী Intlayer কাস্টমাইজ করতে উপলব্ধ বিভিন্ন সেটিংস এবং বিকল্পগুলি বুঝুন।
 keywords:
@@ -14,6 +14,9 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 8.9.4
+    date: 2026-05-12
+    changes: "LM Studio প্রদানকারীর জন্য সমর্থন যোগ করুন"
   - version: 8.7.0
     date: 2026-04-08
     changes: "বিল্ড কনফিগারেশনে `prune` এবং `minify` বিকল্প যোগ করা হয়েছে"
@@ -350,7 +353,7 @@ const config: IntlayerConfig = {
   ai: {
     /**
      * ব্যবহৃত AI প্রোভাইডার।
-     * বিকল্পসমূহ: 'openai', 'anthropic', 'mistral', 'deepseek', 'gemini', 'ollama', 'openrouter', 'alibaba', 'fireworks', 'groq', 'huggingface', 'bedrock', 'googlevertex', 'togetherai'
+     * বিকল্পসমূহ: 'openai', 'anthropic', 'mistral', 'deepseek', 'gemini', 'ollama', 'openrouter', 'alibaba', 'fireworks', 'groq', 'huggingface', 'bedrock', 'googlevertex', 'togetherai', 'lmstudio'
      * ডিফল্ট: 'openai'
      */
     provider: "openai",
@@ -909,16 +912,17 @@ Intlayer সর্বোচ্চ নমনীয়তার জন্য এ
 - **Groq**
 - **Amazon Bedrock**
 - **Together.ai**
-
-| ফিল্ড                | বর্ণনা                                                                                                                                     | টাইপ                                                                                                                                                                                                                                                                                                                                                                                           | ডিফল্ট      | উদাহরণ                                                        | মন্তব্য                                                                                                                                                                                 |
-| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- | ------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `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'` | `undefined` | `'anthropic'`                                                 | বিভিন্ন প্রোভাইডারের জন্য আলাদা আলাদা API কী প্রয়োজন এবং তাদের দামও আলাদা।                                                                                                             |
-| `model`              | AI বৈশিষ্ট্যের জন্য ব্যবহৃত মডেল।                                                                                                          | `string`                                                                                                                                                                                                                                                                                                                                                                                       | নেই         | `'gpt-4o-2024-11-20'`                                         | নির্দিষ্ট মডেল প্রোভাইডারের ওপর নির্ভর করে।                                                                                                                                             |
-| `temperature`        | AI রেসপন্সের র্যান্ডমনেস নিয়ন্ত্রণ করে।                                                                                                   | `number`                                                                                                                                                                                                                                                                                                                                                                                       | নেই         | `0.1`                                                         | উচ্চ টেম্পারেচার = আরও সৃজনশীল এবং কম নির্ভরযোগ্য।                                                                                                                                      |
-| `apiKey`             | নির্বাচিত প্রোভাইডারের জন্য আপনার API কী।                                                                                                  | `string`                                                                                                                                                                                                                                                                                                                                                                                       | নেই         | `process.env.OPENAI_API_KEY`                                  | এটি গোপন রাখতে হবে; এনভায়রনমেন্ট ভেরিয়েবল ব্যবহার করুন।                                                                                                                               |
-| `applicationContext` | AI-কে আরও নির্ভুল অনুবাদ তৈরিতে সাহায্য করার জন্য আপনার অ্যাপ্লিকেশন সম্পর্কে অতিরিক্ত কনটেক্সট (ডোমেইন, টার্গেট অডিয়েন্স, টোন, পরিভাষা)। | `string`                                                                                                                                                                                                                                                                                                                                                                                       | নেই         | `'আমার নিজস্ব অ্যাপ্লিকেশন কনটেক্সট'`                         | নিয়ম যোগ করার জন্য ব্যবহৃত হতে পারে (যেমন: `"আপনাদের URL গুলো রূপান্তর করা উচিত নয়"` )।                                                                                               |
-| `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/>• অতিরিক্ত প্যারামিটার হিসেবে মডেলকে কনটেক্সট পাস করা হয় (রিজনিং এফোর্ট ইত্যাদি)। |
+- **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 বৈশিষ্ট্যের জন্য ব্যবহৃত মডেল।                                                                                                          | `string`                                                                                                                                                                                                                                                                                                                                                                                                                 | নেই         | `'gpt-4o-2024-11-20'`                                         | নির্দিষ্ট মডেল প্রোভাইডারের ওপর নির্ভর করে।                                                                                                                                             |
+| `temperature`        | AI রেসপন্সের র্যান্ডমনেস নিয়ন্ত্রণ করে।                                                                                                   | `number`                                                                                                                                                                                                                                                                                                                                                                                                                 | নেই         | `0.1`                                                         | উচ্চ টেম্পারেচার = আরও সৃজনশীল এবং কম নির্ভরযোগ্য।                                                                                                                                      |
+| `apiKey`             | নির্বাচিত প্রোভাইডারের জন্য আপনার API কী।                                                                                                  | `string`                                                                                                                                                                                                                                                                                                                                                                                                                 | নেই         | `process.env.OPENAI_API_KEY`                                  | এটি গোপন রাখতে হবে; এনভায়রনমেন্ট ভেরিয়েবল ব্যবহার করুন।                                                                                                                               |
+| `applicationContext` | AI-কে আরও নির্ভুল অনুবাদ তৈরিতে সাহায্য করার জন্য আপনার অ্যাপ্লিকেশন সম্পর্কে অতিরিক্ত কনটেক্সট (ডোমেইন, টার্গেট অডিয়েন্স, টোন, পরিভাষা)। | `string`                                                                                                                                                                                                                                                                                                                                                                                                                 | নেই         | `'আমার নিজস্ব অ্যাপ্লিকেশন কনটেক্সট'`                         | নিয়ম যোগ করার জন্য ব্যবহৃত হতে পারে (যেমন: `"আপনাদের URL গুলো রূপান্তর করা উচিত নয়"` )।                                                                                               |
+| `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/cs/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-04-08
+updatedAt: 2026-05-12
 title: Konfigurace (Configuration)
 description: Naučte se, jak nakonfigurovat Intlayer pro vaši aplikaci. Porozumějte různým nastavením a možnostem dostupným pro přizpůsobení Intlayer vašim potřebám.
 keywords:
@@ -14,6 +14,9 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 8.9.4
+    date: 2026-05-12
+    changes: "Přidána podpora pro poskytovatele LM Studio"
   - version: 8.7.0
     date: 2026-04-08
     changes: "Přidány volby `prune` a `minify` do konfigurace sestavení"
@@ -350,7 +353,7 @@ const config: IntlayerConfig = {
   ai: {
     /**
      * Použitý poskytovatel AI.
-     * Možnosti: 'openai', 'anthropic', 'mistral', 'deepseek', 'gemini', 'ollama', 'openrouter', 'alibaba', 'fireworks', 'groq', 'huggingface', 'bedrock', 'googlevertex', 'togetherai'
+     * Možnosti: 'openai', 'anthropic', 'mistral', 'deepseek', 'gemini', 'ollama', 'openrouter', 'alibaba', 'fireworks', 'groq', 'huggingface', 'bedrock', 'googlevertex', 'togetherai', 'lmstudio'
      * Výchozí: 'openai'
      */
     provider: "openai",
@@ -916,16 +919,17 @@ Intlayer podporuje několik AI poskytovatelů pro maximální flexibilitu. V sou
 - **Groq**
 - **Amazon Bedrock**
 - **Together.ai**
-
-| Pole                 | Popis                                                                                                                        | Typ                                                                                                                                                                                                                                                                                                                                                                                            | Výchozí     | Příklad                                                       | Poznámka                                                                                                                                                                              |
-| -------------------- | ---------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- | ------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `provider`           | Poskytovatel použitý pro AI funkce 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'` | `undefined` | `'anthropic'`                                                 | Různí poskytovatelé vyžadují různé API klíče a mají různé ceny.                                                                                                                       |
-| `model`              | Model použitý pro AI funkce.                                                                                                 | `string`                                                                                                                                                                                                                                                                                                                                                                                       | Žádný       | `'gpt-4o-2024-11-20'`                                         | Konkrétní model závisí na poskytovateli.                                                                                                                                              |
-| `temperature`        | Ovládá náhodnost odpovědí AI.                                                                                                | `number`                                                                                                                                                                                                                                                                                                                                                                                       | Žádný       | `0.1`                                                         | Vyšší teplota = kreativnější a méně předvídatelné.                                                                                                                                    |
-| `apiKey`             | Váš API klíč pro zvoleného poskytovatele.                                                                                    | `string`                                                                                                                                                                                                                                                                                                                                                                                       | Žádný       | `process.env.OPENAI_API_KEY`                                  | Musí být uchováváno v tajnosti; použijte proměnné prostředí.                                                                                                                          |
-| `applicationContext` | Dodatečný kontext o vaší aplikaci, který pomůže AI generovat přesnější překlady (doména, cílová skupina, tón, terminologie). | `string`                                                                                                                                                                                                                                                                                                                                                                                       | Žádný       | `'Můj vlastní kontext aplikace'`                              | Lze použít k přidání pravidel (např.: `"Neměli byste transformovat URL"`).                                                                                                            |
-| `baseURL`            | Základní URL pro AI API.                                                                                                     | `string`                                                                                                                                                                                                                                                                                                                                                                                       | Žádný       | `'https://api.openai.com/v1'` <br/> `'http://localhost:5000'` | Může ukazovat na lokální nebo vlastní endpoint AI API.                                                                                                                                |
-| `dataSerialization`  | Formát serializace dat pro AI funkce.                                                                                        | `'json'` &#124; <br/> `'toon'`                                                                                                                                                                                                                                                                                                                                                                 | `undefined` | `'toon'`                                                      | • `'json'`: výchozí, spolehlivé; spotřebovává více tokenů.<br/>• `'toon'`: méně tokenů, méně stabilní.<br/>• Další parametry se předávají modelu jako kontext (úsilí uvažování atd.). |
+- **LM Studio**
+
+| Pole                 | Popis                                                                                                                        | Typ                                                                                                                                                                                                                                                                                                                                                                                                                      | Výchozí     | Příklad                                                       | Poznámka                                                                                                                                                                              |
+| -------------------- | ---------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------- | ------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `provider`           | Poskytovatel použitý pro AI funkce 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'`                                                 | Různí poskytovatelé vyžadují různé API klíče a mají různé ceny.                                                                                                                       |
+| `model`              | Model použitý pro AI funkce.                                                                                                 | `string`                                                                                                                                                                                                                                                                                                                                                                                                                 | Žádný       | `'gpt-4o-2024-11-20'`                                         | Konkrétní model závisí na poskytovateli.                                                                                                                                              |
+| `temperature`        | Ovládá náhodnost odpovědí AI.                                                                                                | `number`                                                                                                                                                                                                                                                                                                                                                                                                                 | Žádný       | `0.1`                                                         | Vyšší teplota = kreativnější a méně předvídatelné.                                                                                                                                    |
+| `apiKey`             | Váš API klíč pro zvoleného poskytovatele.                                                                                    | `string`                                                                                                                                                                                                                                                                                                                                                                                                                 | Žádný       | `process.env.OPENAI_API_KEY`                                  | Musí být uchováváno v tajnosti; použijte proměnné prostředí.                                                                                                                          |
+| `applicationContext` | Dodatečný kontext o vaší aplikaci, který pomůže AI generovat přesnější překlady (doména, cílová skupina, tón, terminologie). | `string`                                                                                                                                                                                                                                                                                                                                                                                                                 | Žádný       | `'Můj vlastní kontext aplikace'`                              | Lze použít k přidání pravidel (např.: `"Neměli byste transformovat URL"`).                                                                                                            |
+| `baseURL`            | Základní URL pro AI API.                                                                                                     | `string`                                                                                                                                                                                                                                                                                                                                                                                                                 | Žádný       | `'https://api.openai.com/v1'` <br/> `'http://localhost:5000'` | Může ukazovat na lokální nebo vlastní endpoint AI API.                                                                                                                                |
+| `dataSerialization`  | Formát serializace dat pro AI funkce.                                                                                        | `'json'` &#124; <br/> `'toon'`                                                                                                                                                                                                                                                                                                                                                                                           | `undefined` | `'toon'`                                                      | • `'json'`: výchozí, spolehlivé; spotřebovává více tokenů.<br/>• `'toon'`: méně tokenů, méně stabilní.<br/>• Další parametry se předávají modelu jako kontext (úsilí uvažování atd.). |
 
 ---
 

package/docs/de/benchmark/index.md

@@ -30,6 +30,3 @@ Detaillierte Berichte und technische Dokumentation für jedes Framework finden S
 - [**Vue Benchmark Report**](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/benchmark/vue.md)
 - [**Solid Benchmark Report**](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/benchmark/solid.md)
 - [**Svelte Benchmark Report**](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/benchmark/svelte.md)
-- [**Vue Benchmark Report**](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/benchmark/vue.md)
-- [**Solid Benchmark Report**](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/benchmark/solid.md)
-- [**Svelte Benchmark Report**](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/benchmark/svelte.md)

package/docs/de/benchmark/nextjs.md

@@ -61,6 +61,13 @@ Da das Problem komplex ist, gibt es viele Lösungen – einige konzentrieren sic
 
 Intlayer versucht, über all diese Dimensionen hinweg zu optimieren.
 
+## TL;DR
+
+- **Intlayer** & **next-translate**: Top-Empfehlungen für die Next.js-Performance, mit dem kleinsten Fußabdruck und der besten Unterstützung für statisches Rendering.
+- **next-intl**: Die aktuell trendigste Option, aber schwerfällig und komplex für die Optimierung großer Anwendungen.
+- **next-i18next**: Beliebt und reich an Plugins, bringt jedoch ein erhebliches Bundle-Gewicht mit sich (~3× Intlayer).
+- **Vermeiden**: **gt-next** und **lingo.dev** aufgrund schwerwiegender Performance-Probleme, Vendor-Lock-in und Build-Fehlern.
+
 ## Testen Sie Ihre App
 
 Um diese Probleme aufzudecken, habe ich einen kostenlosen Scanner entwickelt, den Sie [hier](https://intlayer.org/i18n-seo-scanner) ausprobieren können.
@@ -99,14 +106,14 @@ Schließlich wendet `Intlayer` eine Build-Optimierung an, sodass `useIntlayer('m
 Für diesen Benchmark haben wir die folgenden Bibliotheken verglichen:
 
 - `Base App` (Ohne i18n-Bibliothek)
-- `next-intlayer` (v8.7.5)
+- `next-intlayer` (v8.7.12)
 - `next-i18next` (v16.0.5)
 - `next-intl` (v4.9.1)
 - `@lingui/core` (v5.3.0)
 - `next-translate` (v3.1.2)
 - `next-international` (v1.3.1)
 - `@inlang/paraglide-js` (v2.15.1)
-- `tolgee` (v7.0.0)
+- `@tolgee/react` (v7.0.0)
 - `@lingo.dev/compiler` (v0.4.0)
 - `wuchale` (v0.22.11)
 - `gt-next` (v6.16.5)
@@ -161,10 +168,10 @@ Aufgetretene Probleme:
 
 **(General Translation)** (`gt-next@6.16.5`):
 
-- Bei einer 110-KB-App fügt `gt-react` mehr als 440 KB hinzu.
+- Bei einer 110-KB-App fügt `gt-next` mehr als 440 KB hinzu.
 - `Quota Exceeded, please upgrade your plan` bereits beim allerersten Build mit General Translation.
 - Übersetzungen werden nicht gerendert; ich erhalte den Fehler `Error: <T> used on the client-side outside of <GTProvider>`, was anscheinend ein Bug in der Bibliothek ist.
-- Bei der Implementierung von **gt-tanstack-start-react** stieß ich ebenfalls auf ein [Problem](https://github.com/generaltranslation/gt/issues/1210#event-24510646961) mit der Bibliothek: `does not provide an export named 'printAST' - @formatjs/icu-messageformat-parser`, was zum Absturz der Anwendung führte. Nach Meldung dieses Problems behob der Maintainer es innerhalb von 24 Stunden.
+- Bei der Implementierung von **gt-next** stieß ich ebenfalls auf ein [Problem](https://github.com/generaltranslation/gt/issues/1210#event-24510646961) mit der Bibliothek: `does not provide an export named 'printAST' - @formatjs/icu-messageformat-parser`, was zum Absturz der Anwendung führte. Nach Meldung dieses Problems behob der Maintainer es innerhalb von 24 Stunden.
 - Die Bibliothek blockiert das statische Rendering von Next.js-Seiten.
 
 **(Lingo.dev)** (`@lingo.dev/compiler@0.4.0`):
@@ -186,9 +193,11 @@ Die Idee hinter `Wuchale` ist interessant, aber noch nicht reif für den Einsatz
 Persönlich missfällt mir die Notwendigkeit, JS-Dateien vor jedem Push neu zu generieren, was ein ständiges Risiko für Merge-Konflikte in PRs darstellt. Das Tool scheint zudem stärker auf Vite als auf Next.js ausgerichtet zu sein.
 Schließlich nutzt Paraglide im Vergleich zu anderen Lösungen keinen Store (z. B. React Context), um die aktuelle Sprache für das Rendering abzurufen. Für jeden geparsten Node wird die Sprache aus dem localStorage / Cookie etc. angefragt. Dies führt zur Ausführung unnötiger Logik, die die Reaktivität der Komponenten beeinträchtigt.
 
+> Hinweis zu Paraglide: Die Lösung injiziert Code in Ihre Codebasis für den Import, wodurch die Metrik 'Bibliotheksgröße' im Benchmark-Bericht fast 0 ist. Codegenerierung ist eine gute Sache, da die verwendete Funktion nur die notwendige Logik enthält (Präfix-Gesamtheit vs. kein Präfix, Cookie vs. Speicher usw.). Im Vergleich dazu führt Intlayer diese Filterung durch Injektionen von Umgebungsvariablen in den Build durch, um den Bundler zu zwingen, Inhalte je nach Logik per Tree-shaking zu entfernen. Dank dessen sind Paraglide und Intlayer am Ende 6- bis 10-mal leichtere Lösungen als i18next oder next-intl.
+
 ### 3 — Akzeptable Lösungen
 
-**(Tolgee)** (`tolgee@7.0.0`):
+**(Tolgee)** (`@tolgee/react@7.0.0`):
 
 `Tolgee` adressiert viele der oben genannten Probleme. Ich fand es schwieriger zu adoptieren als ähnliche Tools. Es bietet keine Typsicherheit, was es zudem erschwert, fehlende Schlüssel zur Kompilierzeit zu finden. Ich musste die Tolgee-Funktionen mit eigenen Funktionen umhüllen, um eine Erkennung fehlender Schlüssel hinzuzufügen.
 
@@ -216,7 +225,7 @@ Die Nachrichtenformate unterscheiden sich ebenfalls: `next-intl` verwendet ICU M
 
 `next-translate` ist meine Hauptempfehlung, wenn Sie eine API im `t()`-Stil bevorzugen. Es ist durch das `next-translate-plugin` elegant gelöst und lädt Namespaces über `getStaticProps` mit einem Webpack / Turbopack Loader. Es ist zudem die leichteste Option hier (~2,5 KB). Für das Namespacing ist die Definition pro Seite oder Route in der Konfiguration gut durchdacht und einfacher zu warten als die Hauptalternativen wie **next-intl** oder **next-i18next**. In Version `3.1.2` stellte ich fest, dass das statische Rendering nicht funktionierte; Next.js fiel auf dynamisches Rendering zurück.
 
-**(Intlayer)** (`next-intlayer@8.7.5`):
+**(Intlayer)** (`next-intlayer@8.7.12`):
 
 Ich werde `next-intlayer` der Objektivität halber nicht persönlich bewerten, da es meine eigene Lösung ist.