المساهمات

التنمية المحلية

git clone https://github.com/IEvangelist/resource-translator
cd resource-translator
npm install
npm run verify   # lint + format:check + test + build

إضافة محلل

1. أضف تركيبة تحت __tests__/data/.
2. نفذ TranslationFileParser (parse، format، applyTranslations، toTranslatableTextMap).
3. سجله في translation-file-parser-factory.ts.
4. أضف امتداد الملف إلى translationFileSchemes في translation-file-finder.ts.
5. اكتب اختبارات ذهابا وإيابا لتنسيق تحليل → وتطبيق الترجمات.

حدود التغطية

إعدادات Jest تفرض الحد الأدنى من التغطية. يجب أن يحافظ الكود الجديد على عتبة العبارات + الأسطر فوق 78٪ والوظائف فوق 90٪. أضف التركيبات والاختبارات مع الباقي الخاص بك.

موقع التوثيق

المجلد docs/ هو مشروع Astro 6 + Tailwind v4. شغل npm install هناك مرة واحدة، ثم npm run dev للمعاينة المحلية. سير العمل pages.yml يرسل المستندات إلى صفحات GitHub في كل عملية دمج.