ESLint Configuration - DataTime

تكوين ESLint موحد لمشاريع Node.js في مؤسسة DataTime.

المميزات

• دعم JavaScript و TypeScript: تكوين شامل للغتين
• قواعد الأمان: حماية من الأخطاء الأمنية الشائعة
• تكامل Prettier: تنسيق الكود تلقائياً
• قواعد Import/Export: تنظيم أفضل للواردات
• دعم ملفات الاختبار: تكوين خاص لـ Jest و Mocha

التثبيت

npm install --save-dev @haydar_rs4it/eslint-config @haydar_rs4it/prettier-config

الاستخدام

الطريقة الأولى: ملف التكوين التقليدي

أنشئ ملف .eslintrc.js:

module.exports = {
  extends: ['@haydar_rs4it/eslint-config'],
};

الطريقة الثانية: ESLint Flat Config (ESLint 9+)

أنشئ ملف eslint.config.js:

import datatime from '@haydar_rs4it/eslint-config';

export default [
  ...datatime,
  // يمكنك إضافة قواعد إضافية هنا
];

التبعيات المطلوبة

تأكد من تثبيت التبعيات التالية:

npm install --save-dev eslint@^9.0.0
npm install --save-dev eslint-plugin-import@^2.29.0
npm install --save-dev typescript@^5.0.0
npm install --save-dev @typescript-eslint/parser@^7.0.0
npm install --save-dev @typescript-eslint/eslint-plugin@^7.0.0

تكوين Prettier

يتم استخدام حزمة @haydar_rs4it/prettier-config المنفصلة. أنشئ ملف prettier.config.js:

import config from '@haydar_rs4it/prettier-config';

export default config;

أو ملف .prettierrc.js:

module.exports = require('@haydar_rs4it/prettier-config');

أمثلة الاستخدام

مشروع JavaScript عادي

// .eslintrc.js
module.exports = {
  extends: ['datatime'],
  env: {
    node: true,
  },
};

مشروع TypeScript

// .eslintrc.js
module.exports = {
  extends: ['datatime'],
  parser: '@typescript-eslint/parser',
  plugins: ['@typescript-eslint'],
  parserOptions: {
    project: './tsconfig.json',
  },
};

تخصيص القواعد

// .eslintrc.js
module.exports = {
  extends: ['datatime'],
  rules: {
    'no-console': 'off', // تعطيل تحذير console.log
    'prefer-const': 'error', // فرض استخدام const
  },
};

نصائح للاستخدام

1. استخدم مع Pre-commit Hooks: تأكد من تشغيل ESLint قبل كل commit
2. تكامل مع IDE: فعّل ESLint في محرر النصوص الخاص بك
3. CI/CD: أضف ESLint إلى خط أنابيب CI/CD الخاص بك
4. التحديث الدوري: حافظ على تحديث التبعيات للحصول على أحدث القواعد

الدعم

للمساعدة أو الإبلاغ عن مشاكل، يرجى التواصل مع فريق التطوير في DataTime.