@devsamhan/arabic-devtools

أدوات سطر الأوامر للمطور العربي — اكتشاف مشاكل النصوص العربية في المشاريع.

ملاحظة مهمة: النسخة 0.1.2 للتشخيص فقط — لا تعديل تلقائي للملفات. لا يوجد خيار --fix في هذه النسخة. راجع النتائج يدوياً قبل إجراء أي تغيير.

التثبيت

npm install -g @devsamhan/arabic-devtools

الأوامر

check-rtl <المسار>

يكتشف النصوص العربية المكتوبة بالعكس داخل الملفات.

أمثلة على الأخطاء المكتشفة:

• ثحب بدلاً من بحث
• دمحم بدلاً من محمد
• فلم بدلاً من ملف

arabic-devtools check-rtl ./lib
arabic-devtools check-rtl ./src --format json
arabic-devtools check-rtl ./src --severity-threshold high

الكود: AR001 — مستويات الثقة: عالٍ (قاموس) / متوسط / منخفض

يخرج بكود 1 عند وجود نتائج، 0 عند النظافة.

scan <المسار>

يفحص الملفات أو المجلدات عن مشاكل عربية شائعة:

• AR002 — تطويل زائد: مـحـمـد
• AR003 — تشكيل داخل مفاتيح البحث: مُحَمَّد
• AR004 — خلط أرقام شرقية وغربية: رقم ١٢3
• AR001 — نصوص عربية مقلوبة (كما في check-rtl)

arabic-devtools scan ./lib
arabic-devtools scan ./src --format json
arabic-devtools scan ./src --severity-threshold medium

في بيئة CI:

arabic-devtools scan . --format json

يخرج بكود 1 عند وجود نتائج، 0 عند النظافة.

bidi "<النص>"

يحوّل النص العربي ليظهر بشكل صحيح في الطرفيات التي لا تدعم العربية أصلاً.

arabic-devtools bidi "مرحبا بالعالم"
arabic-devtools bidi "مرحبا بالعالم" --reshape-only
arabic-devtools bidi "مرحبا بالعالم" --no-reorder
arabic-devtools bidi "مرحبا بالعالم" --no-reshape

| الخيار | الوصف | |--------|-------| | (بدون خيارات) | تشكيل الحروف + إعادة الترتيب | | --reshape-only | تشكيل الحروف فقط بدون إعادة ترتيب | | --no-reorder | نفس --reshape-only | | --no-reshape | إعادة الترتيب فقط بدون تشكيل الحروف |

تحذير: الطرفيات الحديثة (Windows Terminal، iTerm2، GNOME Terminal) تعرض العربية صحيحاً بدون الحاجة لهذا الأمر. استخدم bidi فقط إذا ظهر النص مقلوباً في بيئتك. إذا ظهر الخرج أسوأ، جرّب --no-reorder أو تجاهل هذا الأمر كلياً.

يخرج دائماً بكود 0 (ما لم يغب المعامل).

رموز القواعد

| الكود | الاسم | الخطورة | |-------|-------|---------| | AR001 | potentially-reversed-arabic-literal | عالية / متوسطة / منخفضة | | AR002 | excessive-tatweel | متوسطة | | AR003 | tashkeel-in-search-key | متوسطة | | AR004 | mixed-digit-scripts | منخفضة |

جميع النتائج تشخيصية — لا إصلاح تلقائي.

التفاصيل الكاملة في docs/rules.md.

مثال على مخرجات JSON

arabic-devtools check-rtl ./src --format json

{
  "tool": "arabic-devtools",
  "command": "check-rtl",
  "findings": [
    {
      "code": "AR001",
      "type": "potentially-reversed-arabic-literal",
      "severity": "high",
      "file": "src/strings.txt",
      "line": 12,
      "column": 18,
      "found": "ثحب",
      "suggestion": "بحث",
      "message": "Potentially reversed Arabic literal"
    }
  ]
}

فلترة حسب الخطورة

arabic-devtools scan ./src --severity-threshold high

• low (الافتراضي) — كل النتائج
• medium — متوسط وعالٍ فقط
• high — عالٍ فقط

المكتبات المستخدمة

• @devsamhan/arabic-text — تطبيع النص العربي
• @devsamhan/arabic-bidi — عرض العربية في الطرفية

الترخيص

MIT — Devsamhan