هندسة عامة قابلة لإعادة الاستخدام
كود وأدوات واختبارات عامة للعربية وRTL والتوطين والوصولية وUnicode والتفاعل، مع وثائق وعقود قابلة للمراجعة الخارجية.
أداة روافد المفتوحة للعربية وRTL والوصولية والتوطين
طبقة هندسية TypeScript عامة وقابلة لإعادة الاستخدام لبناء واختبار واجهات عربية وثنائية الاتجاه بصورة أدق: اتجاه النص والـlocale، Unicode bidi، التوطين، التقسيم الآمن للنص، أنماط التفاعل، CSS المنطقي، والوصولية في المتصفح.
Rawafid Arabic/RTL Accessibility & Localization Toolkit is a framework-agnostic, zero-runtime-dependency open-source engineering component for Arabic and bidirectional web applications.
Apache-2.0npm v0.3.0TypeScript0 runtime dependenciesChromium · Firefox · WebKit
حدود واضحة
فصل متعمد بين البرمجيات العامة ومحتوى منصة روافد.ما هو المشروع — وما ليس هو
لا يحتوي corpus روافد العلمي
لا يتضمن مقالات الموسوعة، قواعد المحتوى العلمي، بيانات المستخدمين، التحليلات، أسرار الإنتاج، أو منطق النشر والترتيب الخاص بالمنصة.
GitHub وnpm قناتا التوزيع العامتان
المصدر والإصدارات وأدلة التحقق متاحة على GitHub، والحزمة العامة @rawafid/arabic-rtl-a11y-toolkit منشورة بإصدار 0.3.0 على npm.
Capability map
العربية ليست مجرد قلب واجهة من اليمين إلى اليسار.المشكلات التي صُممت الأداة لمعالجتها
- اتجاه النص والواجهة وفق النص والـscript الفعلي بدل افتراضات اسم اللغة.
- عزل القيم المختلطة الاتجاه وكشف ضوابط bidi القديمة أو الخطرة في سياق العرض.
- توحيد واختيار locale مع منع fallback صامت يعبر بين scripts مختلفة.
- تنسيق الأرقام والتواريخ والقوائم والنسب عبر Intl مع واجهات formatToParts منظمة.
- تقسيم graphemes والكلمات والجمل بصورة تحترم حدود Unicode/Intl بدل قص UTF-16 الخام.
- نماذج تفاعل للتركيز وtypeahead والاختيار والشبكات تراعي الاتجاه RTL/LTR.
- أدوات CSS منطقية ووصولية واختبارات متصفح حقيقية لسيناريوهات عربية وثنائية الاتجاه.
Due diligence
المراجعة لا تعتمد على وصف تسويقي.أدلة يمكن فحصها مباشرة
دليل عام
الكود والترخيص
المستودع عام ومستقل عن المحتوى العلمي والتحريري لمنصة روافد، ويصدر بترخيص Apache-2.0.
فتح المستودع العام ↗دليل عامحزمة npm العامة
الحزمة العامة @rawafid/arabic-rtl-a11y-toolkit منشورة بإصدار 0.3.0 ويمكن تثبيتها ومراجعة بياناتها مباشرة من سجل npm.
فتح الحزمة على npm ↗دليل عامإصدار GitHub v0.3.0
الإصدار العام موثق في GitHub Release ويتضمن حزمة الإصدار وبيانات SBOM وأدلة الإصدار القابلة للفحص.
فتح الإصدار العام ↗دليل عامالعقود والواجهات
توثيق للواجهات العامة، حدود الاستقرار، سلوك الاتجاه، Unicode، Intl، الوصولية والتفاعل.
قراءة عقد API ↗دليل عامالأمن وسلسلة التوريد
سياسة إبلاغ أمني، نموذج تهديد، CodeQL، Dependency Review، OpenSSF Scorecard، وتثبيت GitHub Actions على SHA كاملة.
قراءة سياسة الأمن ↗دليل عامالتحقق في المتصفحات
اختبارات Playwright عبر Chromium وFirefox وWebKit والجوال، مع فحوص axe-core وحالات RTL/LTR واتجاهات مختلطة.
عرض مصفوفة الاختبار ↗دليل عامالتشغيل البيني
أدلة machine-readable وقائمة عمل شريك قابلة للتنفيذ بدل الاكتفاء بادعاءات وصفية.
فحص أدلة التشغيل البيني ↗دليل عامالمساهمة والحوكمة
مسار علني للقضايا وPull Requests، مهام good first issue، متطلبات اختبار واضحة وحدود لما يجوز إدخاله إلى المستودع العام.
قراءة دليل المساهمة ↗Standards-backed
الالتزام بالمعايير لا يعني ادعاء مطابقة تلقائية.مرجعية المعايير
يعتمد المشروع على مفاهيم وإرشادات W3C WCAG 2.2 وWAI-ARIA Authoring Practices وW3C Internationalization، وعلى Unicode Bidirectional Algorithm ومبادئ أمان Unicode، وBCP 47 وواجهات ECMA-402 / Intl وCSS Logical Properties.
هذه المراجع تحدد خطًا هندسيًا، لكنها لا تجعل كل واجهة تستخدم المكتبة متوافقة تلقائيًا مع WCAG ولا تثبت صحة لغوية لكل locale. التطبيق المستهلك يبقى مسؤولًا عن الدلالات والاختبار والسياق.
قراءة خريطة المعايير والحدود ↗Open collaboration
نبحث عن أدلة ومساهمات قابلة لإعادة الإنتاج، لا عن أرقام شكلية.للمساهمين والمراجعين
ابدأ بمهمة محددة
Good first issues
مهام ذات حدود قبول واضحة لا تتطلب الوصول إلى سياق خاص بروافد.
عرض المهام ↗خبرة خارجيةHelp wanted
مسارات نحتاج فيها أدلة متصفح أو وصولية أو i18n أو معايير أو تشغيل بيني من مراجعين مستقلين.
عرض المسارات ↗بلاغ حساسالأمن
لا تنشر exploit details في Issue عام. اتبع مسار الإبلاغ الخاص المنشور في سياسة الأمن.
سياسة الإبلاغ ↗التواصل التقني
مراجعة، تشغيل بيني، أو مساهمة upstream
للتواصل المؤسسي أو التقني حول المشروع المفتوح، استخدم contact@healthrenewal.org. لا تُعرض أي جهة على أنها شريك أو داعم أو جهة مراجعة إلا بعد وجود أساس مكتوب لذلك.