@intlayer/docs 9.4.2 → 9.4.3

package/blog/ar/is_i18next_outdated.md

@@ -0,0 +1,315 @@
+---
+createdAt: 2026-09-02
+updatedAt: 2026-09-02
+title: هل أصبحت مكتبة i18next قديمة في عام 2026؟
+description: تدير i18next ملايين المواقع، لكن بنية وقت التشغيل التي صُممت في عام 2011 بدأت تظهر عليها علامات القدم. تحليل لحجم الحزم وقيود Tree-shaking وركود التطوير.
+keywords:
+  - i18next
+  - react-i18next
+  - next-i18next
+  - Intlayer
+  - تدويل المواقع
+  - i18n
+  - حجم الحزمة
+  - مدونة
+slugs:
+  - blog
+  - is-i18next-outdated
+author: aymericzip
+---
+
+# هل أصبحت مكتبة i18next قديمة في عام 2026؟
+
+أُطلقت `i18next` في عام 2011، قبل أن تصبح مكونات React وحزم Webpack ولغة TypeScript معايير أساسية في تطوير الويب. هيمنت على النظام البيئي بفضل مرونتها وانتشارها، وحصلت على إضافات لمعظم التقنيات وحلول جاهزة على StackOverflow لكل مشكلة تقريباً.
+
+المشروع لم يُهمل، فالتحديثات والإصلاحات مستمرة بانتظام. ومع ذلك، هناك فرق جوهري بين صيانة محرك قديم ليبقى قيد التشغيل، وبين مواكبة البنى الحديثة للواجهات الأمامية.
+
+خلال السنوات الأخيرة، اتجهت الواجهات الأمامية نحو الترجمة أثناء البناء (Build-time Compilation)، وReact Server Components (RSC)، والتقليم الصارم للشيفرات غير المستخدمة (Tree-shaking)، وسير العمل القائم على الذكاء الاصطناعي. في المقابل، بقي جوهر i18next كما كان قبل عقد: كائن منفرد يعمل في وقت التشغيل ليطابق مفاتيح النصوص في المتصفح.
+
+<TOC/>
+
+## النقاط الرئيسية
+
+**وضع الصيانة:**
+
+خلال الاثني عشر شهراً الماضية، سجلت `next-i18next` قرابة 63 تعديلاً (commit)، وسجلت `react-i18next` حوالي 157 تعديلاً، واقتصر معظمها على تحديث التبعيات وإصلاحات طفيفة.
+
+**عبء وقت التشغيل:**
+
+تضيف كل من `react-i18next` و`next-i18next` ما بين 17 إلى 18 كيلوبايت مضغوطة بـ gzip (نحو 60 كيلوبايت minified) قبل عرض أي كلمة مترجمة، أي نحو 4 أضعاف حجم `next-intlayer` (4.7 كيلوبايت).
+
+**تسريب كبير للمحتوى:**
+
+في الإعدادات الثابتة الافتراضية، فإن ما يصل إلى **89.8%** من بيانات الترجمة المحملة في الصفحة تنتمي إلى مسارات أخرى أو لغات غير معروضة.
+
+**صعوبة التقليم (Tree-shaking):**
+
+استدعاء النصوص ديناميكياً مثل `t("home.hero.title")` يمنع أدوات الحزم من تحليله ثابتاً، مما يضطرها لتضمين ملفات JSON كاملة في حزمة العميل.
+
+**الحوافز التجارية:**
+
+يدير المشرفون على المكتبة منصة Locize التجارية. بالتالي، فإن بناء أداة ترجمة محلية مجانية بالذكاء الاصطناعي مدمجة في الـ CLI سيتعارض مباشرة مع مصدر دخلهم الأساسي.
+
+## الصيانة في مقابل التطور المستمر
+
+تعكس نجوم GitHub الشعبية التاريخية للمشروع، لكنها لا تعكس وتيرة التحديث المعماري الراهنة.
+
+| المستودع                | النجوم                                                                                                                                                     | إجمالي التعديلات                                                                                                                                                        | التعديلات / سنة                                                                                                                                                        | آخر تعديل                                                                                                                                        |
+| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `i18next/i18next`       | [![stars](https://img.shields.io/github/stars/i18next/i18next?style=for-the-badge&label=stars)](https://github.com/i18next/i18next/stargazers)             | [![commits](https://img.shields.io/github/commit-activity/t/i18next/i18next?style=for-the-badge&label=commits)](https://github.com/i18next/i18next/commits)             | [![yearly](https://img.shields.io/github/commit-activity/y/i18next/i18next?style=for-the-badge&label=%2Fyear)](https://github.com/i18next/i18next/commits)             | [![last](https://img.shields.io/github/last-commit/i18next/i18next?style=for-the-badge)](https://github.com/i18next/i18next/commits)             |
+| `i18next/react-i18next` | [![stars](https://img.shields.io/github/stars/i18next/react-i18next?style=for-the-badge&label=stars)](https://github.com/i18next/react-i18next/stargazers) | [![commits](https://img.shields.io/github/commit-activity/t/i18next/react-i18next?style=for-the-badge&label=commits)](https://github.com/i18next/react-i18next/commits) | [![yearly](https://img.shields.io/github/commit-activity/y/i18next/react-i18next?style=for-the-badge&label=%2Fyear)](https://github.com/i18next/react-i18next/commits) | [![last](https://img.shields.io/github/last-commit/i18next/react-i18next?style=for-the-badge)](https://github.com/i18next/react-i18next/commits) |
+| `i18next/next-i18next`  | [![stars](https://img.shields.io/github/stars/i18next/next-i18next?style=for-the-badge&label=stars)](https://github.com/i18next/next-i18next/stargazers)   | [![commits](https://img.shields.io/github/commit-activity/t/i18next/next-i18next?style=for-the-badge&label=commits)](https://github.com/i18next/next-i18next/commits)   | [![yearly](https://img.shields.io/github/commit-activity/y/i18next/next-i18next?style=for-the-badge&label=%2Fyear)](https://github.com/i18next/next-i18next/commits)   | [![last](https://img.shields.io/github/last-commit/i18next/next-i18next?style=for-the-badge)](https://github.com/i18next/next-i18next/commits)   |
+| `aymericzip/intlayer`   | [![stars](https://img.shields.io/github/stars/aymericzip/intlayer?style=for-the-badge&label=stars)](https://github.com/aymericzip/intlayer/stargazers)     | [![commits](https://img.shields.io/github/commit-activity/t/aymericzip/intlayer?style=for-the-badge&label=commits)](https://github.com/aymericzip/intlayer/commits)     | [![yearly](https://img.shields.io/github/commit-activity/y/aymericzip/intlayer?style=for-the-badge&label=%2Fyear)](https://github.com/aymericzip/intlayer/commits)     | [![last](https://img.shields.io/github/last-commit/aymericzip/intlayer?style=for-the-badge)](https://github.com/aymericzip/intlayer/commits)     |
+
+نشاط التطوير في الأشهر الاثني عشر الماضية:
+
+| المشروع         | إجمالي التعديلات | آخر 12 شهراً | محور التركيز                               |
+| --------------- | ---------------- | ------------ | ------------------------------------------ |
+| `next-i18next`  | 1,311            | **63**       | التوافق مع Next.js وإصلاح الأخطاء          |
+| `react-i18next` | 1,988            | **157**      | تعريفات الأنواع والصيانة                   |
+| `i18next` core  | 2,626            | **259**      | تحسينات طفيفة                              |
+| Intlayer        | 7,156            | **4,343**    | المترجم، أدوات IDE، ومحرك الذكاء الاصطناعي |
+
+[![Star History Chart](https://api.star-history.com/chart?repos=i18next%2Fi18next%2Ci18next%2Freact-i18next%2Ci18next%2Fnext-i18next%2Caymericzip%2Fintlayer&type=date&legend=top-left)](https://www.star-history.com/#i18next/i18next&i18next/react-i18next&i18next/next-i18next&aymericzip/intlayer)
+
+المكتبات المستقرة توفر الأمان البرمجي، لكن أدوات التدويل تشهد تطوراً سريعاً: حزم البناء الحديثة تستبعد النصوص غير المستخدمة وقت البناء، ونماذج الذكاء الاصطناعي تترجم آلياً في مرحلة CI، وبيئات التطوير تستفيد من خوادم اللغات (LSP) والوكلاء الأذكياء. نموذج i18next المعتمد كلياً على وقت التشغيل يواجه صعوبة في مواكبة هذه التحولات.
+
+## قياس التأثير على الحزم
+
+<I18nBenchmark framework="tanstack" vertical/>
+
+<ClickToOpenIframe
+src="https://intlayer.org/markdown?url=https%3A%2F%2Fraw.githubusercontent.com%2Fintlayer-org%2Fbenchmark-i18n%2Fmain%2Freport%2Fscripts%2Fsummarize-tanstack.md"
+width="100%"
+height="600px"
+style="border:none;"
+/>
+
+> تم الاختبار في بيئة بناء إنتاجية تتضمن 10 مسارات و10 لغات مع ضغط gzip. التفاصيل متاحة في [تقرير مقارنة أداء i18n](https://intlayer.org/ar/doc/benchmark).
+
+### العبء الأساسي للمكتبات
+
+الحجم الأولي قبل إضافة أي محتوى مترجم:
+
+| المكتبة                | الحجم (gzip) | الحجم المصغر (Minified) |
+| ---------------------- | ------------ | ----------------------- |
+| `next-i18next@16.0.5`  | 17.8 KB      | 61.2 KB                 |
+| `react-i18next@17.0.2` | 17.3 KB      | 59.8 KB                 |
+| `intlayer@8.7.12`      | **4.7 KB**   | **12.8 KB**             |
+
+### وزن الصفحة وتسريب البيانات
+
+الاختبار في بيئة React / TanStack Start (استراتيجية ثابتة):
+
+| المكتبة               | متوسط JS / صفحة (gz) | تسريب اللغات | تسريب الصفحات الأخرى | متوسط المكون (gz) | وقت الـ Hydration |
+| --------------------- | -------------------- | ------------ | -------------------- | ----------------- | ----------------- |
+| `react-i18next`       | 180.3 KB             | **50.0%**    | **89.8%**            | 24.3 KB           | 85.1 ms           |
+| Intlayer              | **127.8 KB**         | 50.0%        | **0.8%**             | **7.1 KB**        | **24.1 ms**       |
+| Intlayer (scoped dyn) | **118.1 KB**         | **0.0%**     | **0.8%**             | **4.6 KB**        | 23.7 ms           |
+
+في Next.js:
+
+| المكتبة           | متوسط JS / صفحة (gz) | تسريب الصفحات الأخرى | متوسط المكون (gz) |
+| ----------------- | -------------------- | -------------------- | ----------------- |
+| الأساس (دون i18n) | 150.8 KB             | 0.0%                 | 0.7 KB            |
+| `next-i18next`    | **227.5 KB**         | **89.8%**            | 24.5 KB           |
+| `next-intlayer`   | **152.1 KB**         | **0.0%**             | **7.2 KB**        |
+
+### أهم النتائج
+
+**حجم الصفحات:**
+
+في Next.js، تضيف `next-i18next` حوالي **76.7 كيلوبايت مضغوطة** مقارنة بالتطبيق الأساسي (+50%). بينما تضيف `next-intlayer` نحو 1.3 كيلوبايت فقط.
+
+**تسريب الترجمات:**
+
+بشكل افتراضي، ما يقرب من **90% من النصوص** المحملة لأي مسار تخص مسارات وصفحات أخرى. تقسيم ملفات الترجمة يدوياً يستهلك وقتاً ويزيد من احتمالية الأخطاء.
+
+**تأخير تفاعلية الصفحة (Hydration):**
+
+استغرقت مكونات `react-i18next` نحو **85 مللي ثانية** للتفاعل، مقابل **24 مللي ثانية** في Intlayer. تمرير كائنات JSON الضخمة يبطئ الاستجابة الأولية للمستخدم.
+
+## لماذا تعد i18next ثقيلة؟
+
+### تراكم المزايا في وقت التشغيل
+
+الاعتماد الكامل على المتصفح يفرض تحميل كل المكونات مسبقاً: نصوص الاستبدال، وقواعد الجمع، والسياقات، ومنسقات البيانات، وموجّهات الأحداث. حتى عند عرض نص عادي وبسيط، يتم دفع ضريبة المحرك بأكمله.
+
+### المفاتيح الديناميكية تعطل الـ Tree-shaking
+
+نظراً لأن المفتاح مثل `"hero.title"` يُعالج ديناميكياً أثناء التشغيل، تعجز أدوات الحزم عن معرفة النصوص المستخدمة فعلياً. وبالتالي، تبقى النصوص الفائضة داخل حزم العميل.
+
+<Tabs defaultTab="intlayer" group="techno">
+  <Tab label="i18next" value="i18next">
+
+```tsx fileName="Component.tsx"
+const { t } = useTranslation("home");
+
+return <h1>{t("hero.title")}</h1>;
+```
+
+  </Tab>
+  <Tab label="Intlayer" value="intlayer">
+
+```tsx fileName="Hero.tsx"
+const { title } = useIntlayer("hero");
+
+return <h1>{title}</h1>;
+```
+
+  </Tab>
+</Tabs>
+
+يقوم [مترجم Intlayer](https://intlayer.org/ar/doc/compiler) بتحليل الخصائص المستخدمة في `Hero.tsx` بدقة ويستبعد النصوص غير المستعملة قبل تجميع حزم العميل. راجع [تحسين الحزم](https://intlayer.org/ar/doc/concept/bundle-optimization) للمزيد.
+
+## تجربة المطورين
+
+### ملفات JSON المعزولة مقابل التجميع المشترك
+
+في i18next، تُحفظ الترجمات في مجلدات JSON منفصلة وبعيدة عن المكونات. بينما تتيح Intlayer وضع ملفات المحتوى بجوار مكوناتها مباشرة:
+
+<Tabs defaultTab="intlayer" group="techno">
+  <Tab label="i18next" value="i18next">
+
+```json fileName="locales/en/hero.json"
+{
+  "title": "Ship in every language"
+}
+```
+
+```json fileName="locales/ar/hero.json"
+{
+  "title": "أطلق منتجك بكل اللغات"
+}
+```
+
+```tsx fileName="Hero.tsx"
+import { useTranslation } from "react-i18next";
+
+export const Hero = () => {
+  const { t } = useTranslation("hero");
+  return <h1>{t("title")}</h1>;
+};
+```
+
+  </Tab>
+  <Tab label="Intlayer" value="intlayer">
+
+```ts fileName="hero.content.ts"
+import { t, type Dictionary } from "intlayer";
+
+export default {
+  key: "hero",
+  content: {
+    title: t({
+      en: "Ship in every language",
+      ar: "أطلق منتجك بكل اللغات",
+    }),
+  },
+} satisfies Dictionary;
+```
+
+```tsx fileName="Hero.tsx"
+import { useIntlayer } from "react-intlayer";
+
+export const Hero = () => {
+  const { title } = useIntlayer("hero");
+  return <h1>{title}</h1>;
+};
+```
+
+  </Tab>
+</Tabs>
+
+عند نقل المكون `Hero.tsx` أو حذفه، ينتقل ملف المحتوى التابع له أو يُحذف تلقائياً.
+
+### الإكمال التلقائي مقابل أمان الأنواع الصارم
+
+يمنح إعداد `CustomTypeOptions` اقتراحات داخل المحرر، لكنه لا يضمن اكتمال الترجمات عبر كل اللغات. حذف مفتاح من `ar/home.json` لن يعطل البناء بل سيكتفي بالرجوع للنص الافتراضي وقت التشغيل.
+
+تستنتج Intlayer الأنواع مباشرة من تعريفات المحتوى، ويقوم وضع [`strictMode`](https://intlayer.org/ar/doc/concept/configuration) بتحويل أي ترجمة مفقودة إلى خطأ فوري يوقف عملية البناء.
+
+### مقارنة الأدوات
+
+| الميزة                        | بيئة i18next         | Intlayer                                                             |
+| ----------------------------- | -------------------- | -------------------------------------------------------------------- |
+| **إضافة VS Code**             | إضافات خارجية فقط    | ✅ [إضافة رسمية](https://intlayer.org/ar/doc/vs-code-extension)      |
+| **خادم اللغة (LSP)**          | ❌ غير متوفر         | ✅ [LSP مدمج ومخصص](https://intlayer.org/ar/doc/lsp)                 |
+| **خادم MCP للذكاء الاصطناعي** | ❌ غير متوفر         | ✅ [خادم MCP جاهز](https://intlayer.org/ar/doc/mcp-server)           |
+| **مهارات الوكلاء (Skills)**   | ❌ غير متوفر         | ✅ [مهارات جاهزة](https://intlayer.org/ar/doc/agent_skills)          |
+| **نظام CMS مرئي**             | Locize (خدمة مدفوعة) | ✅ [مجاني ومفتوح المصدر](https://intlayer.org/ar/doc/concept/editor) |
+
+## الترجمة ونموذج Locize
+
+تعتبر Locize المنصة التجارية التابعة لمطوري i18next. استدامة المصادر المفتوحة أمر ضروري، لكن هذا النموذج يولد تضارباً في المصالح: فالمشروع الذي يعتمد دخله على منصة ترجمة مدفوعة لن يملك حافزاً كبيراً لتوفير أدوات ترجمة محلية مجانية بالذكاء الاصطناعي داخل الـ CLI.
+
+تتبنى Intlayer نهجاً مفتوحاً بالكامل:
+
+- أمر [`intlayer fill`](https://intlayer.org/ar/doc/concept/auto-fill) يتكفل بملء الترجمات الناقصة في الطرفية أو أدوات CI باستخدام مفاتيحك الخاصة من OpenAI أو Anthropic أو Mistral أو Gemini.
+- [نظام Intlayer CMS](https://intlayer.org/ar/doc/concept/cms) مفتوح المصدر ويمكن استضافته ذاتياً عبر Docker Compose.
+- المترجم، والـ CLI، والمحرر، ونظام إدارة المحتوى جميعها مرخصة تحت رخصة Apache 2.0.
+
+## متى تظل i18next خياراً ملائماً؟
+
+<AccordionGroup>
+<Accordion header="المشاريع القائمة والمستقرة">
+
+إذا كان تطبيقك الحالي يعمل بكفاءة ولا يشكل حجم الحزمة عائقاً أمام أهدافك، فلا داعي للاستعجال في إعادة بنائه.
+
+</Accordion>
+<Accordion header="البيئات والمنصات الخاصة">
+
+تغطي إضافات i18next الواسعة منصات فريدة (مثل Electron، وتطبيقات jQuery القديمة، والجسور المخصصة للهواتف) التي لا تركز عليها المترجمات الحديثة افتراضياً.
+
+</Accordion>
+<Accordion header="المجتمع الممتد والتجارب الموثقة">
+
+يسهل العثور على حلول للمشكلات المعقدة والفريدة بفضل الأرشيف الضخم على StackOverflow وGitHub.
+
+</Accordion>
+</AccordionGroup>
+
+## كيف أطور إعدادات i18next الحالية في مشروعي؟
+
+توفر Intlayer حزم توافق مباشرة تحتفظ بنفس تواقيع دوال مكتبات i18next (`i18next` و`react-i18next` و`next-i18next`). لن تحتاج إلى إعادة كتابة مكوناتك للاستفادة من مزايا المعمارية المعتمدة على المترجم.
+
+يتم الإعداد عبر أمر واحد فقط:
+
+```bash packageManager="npm"
+npx intlayer init --interactive
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer init --interactive
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer init --interactive
+```
+
+```bash packageManager="bun"
+bunx intlayer init --interactive
+```
+
+تقوم هذه الأداة التفاعلية بما يلي تلقائياً:
+
+1. تثبيت حزمة التوافق `@intlayer/i18next`.
+2. ضبط الأسماء المستعارة (aliases) في أداة الحزم لتوجه استدعاءاتك الحالية (`useTranslation`، و`Trans`، و`t`) بسلاسة نحو Intlayer، مما يتيح لك إزالة المكتبة القديمة من ملف `package.json`.
+3. تفعيل تشخيصات خادم اللغة (LSP) داخل المحرر مباشرة، وتطبيق تحسينات الحزم أثناء البناء (tree-shaking كامل)، وتشغيل أدوات الترجمة الآلية بالذكاء الاصطناعي محلياً دون تعديلات معقدة.
+
+للاطلاع على الخطوات التفصيلية، راجع أدلتنا المتخصصة:
+
+- **طبقات التوافق المباشر:** احتفظ بصيغ كودك السابقة عبر طبقات التوافق لـ [i18next](https://intlayer.org/ar/doc/compatibility/i18next)، و[react-i18next](https://intlayer.org/ar/doc/compatibility/react-i18next)، و[next-i18next](https://intlayer.org/ar/doc/compatibility/next-i18next).
+- **دليل تحويل الملفات:** حول ملفات JSON إلى قواميس معرفة الأنواع: [من i18next](https://intlayer.org/ar/doc/migration/i18next)، و[من react-i18next](https://intlayer.org/ar/doc/migration/react-i18next)، و[من next-i18next](https://intlayer.org/ar/doc/migration/next-i18next).
+- **الدمج التدريجي:** احتفظ بـ i18next في وقت التشغيل مع [استخدام Intlayer مع i18next](https://intlayer.org/ar/blog/intlayer-with-i18next) للحصول على أمان الأنواع والترجمة بالذكاء الاصطناعي محلياً.
+
+افحص موقعك وتأكد من نسبة التسريب عبر [ماسح SEO للتدويل المجاني](https://intlayer.org/i18n-seo-scanner):
+
+<ClickToOpenIframe src="https://intlayer.org/i18n-seo-scanner" width="100%" height="600px" style="border:none;"/>
+
+## مقالات مقترحة
+
+- [مقارنة أداء تدويل Next.js: فحص تفصيلي](https://intlayer.org/ar/doc/benchmark/nextjs)
+- [مقارنة react-i18next و react-intl و Intlayer](https://intlayer.org/ar/blog/react-i18next-vs-react-intl-vs-intlayer)
+- [هل أصبحت مكتبة next-intl قديمة في 2026؟](https://intlayer.org/ar/blog/is-next-intl-outdated)
+- [التدويل القائم على المترجم في مواجهة الأسلوب التقليدي](https://intlayer.org/ar/blog/compiler-vs-declarative-i18n)