Arabic Code Review

---
name: arabic-code-review
description: "مراجعة كود عربي — راجع الكود مع فحص التعامل مع النصوص العربية وRTL والتعليقات العربية"
version: 1.0.0
author: Mousa Abu Mazin
license: MIT
platforms: [linux, macos]
prerequisites:
  commands: []
  env_vars: []
metadata:
  hermes:
    tags: [arabic, code-review, rtl, unicode, i18n]
---

# مراجعة الكود العربي

مراجعة متخصصة للكود الذي يتعامل مع النصوص العربية. استخدم عندما يطلب المستخدم مراجعة كود يتعامل مع العربي.

## الفحوصات

### 1. ترميز Unicode
- هل الملفات محفوظة بـ UTF-8?
- هل يتعامل مع BOM بشكل صحيح?
- هل يعالج الحروف المركبة (combining characters)?

### 2. اتجاه النص (RTL)
- هل يستخدم `dir="rtl"` في HTML?
- هل CSS يستخدم `direction: rtl` و `text-align: right`?
- هل يستخدم Logical Properties (`margin-inline-start` بدل `margin-left`)?
- هل الأيقونات والأسهم معكوسة؟

### 3. معالجة النصوص العربية
- هل يتعامل مع التشكيل بشكل صحيح?
- هل يعمل regex مع العربي? (`\p{Arabic}` بدل `[a-zA-Z]`)
- هل الفرز (sorting) يستخدم `Intl.Collator('ar')`?
- هل البحث يطبّع الألف/الياء (أ/إ/آ → ا، ي → ى)?

### 4. الأرقام
- هل يدعم الأرقام العربية (٠١٢٣٤٥٦٧٨٩)?
- هل يستخدم `toLocaleString('ar')` للتنسيق?
- هل التاريخ يدعم التقويم الهجري?

### 5. أخطاء شائعة
```javascript
// خطأ: ما يشمل العربي
const isLetter = /[a-zA-Z]/.test(char);

// صح: يشمل كل اللغات
const isLetter = /\p{Letter}/u.test(char);

// خطأ: طول النص مع التشكيل
const len = text.length; // يحسب الحركات كحروف

// صح: تطبيع ثم حساب
const stripped = text.normalize("NFC").replace(/[\u064B-\u065F]/g, "");
const len = stripped.length;

// خطأ: فرز عربي
names.sort();

// صح: فرز بالعربي
const collator = new Intl.Collator("ar");
names.sort(collator.compare);

// خطأ: بحث بدون تطبيع
text.includes("محمد");

// صح: تطبيع الألف والتاء المربوطة
function normalizeArabic(t) {
  return t
    .replace(/[أإآ]/g, "ا")
    .replace(/ة/g, "ه")
    .replace(/ى/g, "ي");
}
normalizeArabic(text).includes(normalizeArabic("محمد"));
```

## صيغة المراجعة

مراجعة الكود العربي:

| # | الملف | المشكلة | الخطورة | الإصلاح |
|---|-------|---------|---------|---------|
| 1 | file.js:12 | regex لا يدعم العربي | عالية | استخدم `\p{Letter}` |
| ... | | | | |

**التقييم**: [X/10] جاهزية عربية

## متى تستخدم
- المستخدم يبني تطبيق عربي أو ثنائي اللغة
- يطلب مراجعة كود يتعامل مع نصوص عربية
- يسأل "هل الكود يدعم العربي بشكل صحيح?"