مترجم TypeScript والتكوين

tsc --init

{
  "compilerOptions": {
    "target": "ES2020",
    "module": "commonjs",
    "outDir": "./dist",
    "rootDir": "./src",
    "strict": true
  },
  "include": ["src/**/*"],
  "exclude": ["node_modules", "**/*.spec.ts"]
}

"target": "ES5"      // للمتصفحات القديمة (IE11)
"target": "ES6"      // يُعرف أيضاً باسم ES2015
"target": "ES2020"   // JavaScript الحديث
"target": "ESNext"   // أحدث الميزات

"module": "commonjs"   // نمط Node.js (require/module.exports)
"module": "es2015"     // وحدات ES الحديثة (import/export)
"module": "esnext"     // أحدث ميزات الوحدة
"module": "amd"        // لمحمّلات وحدات المتصفح
"module": "umd"        // تعريف الوحدة العالمي

{
  "compilerOptions": {
    "rootDir": "./src",      // أين توجد ملفات TypeScript
    "outDir": "./dist"       // أين يذهب JavaScript المُجمَّع
  }
}

{
  "compilerOptions": {
    "removeComments": true,           // إزالة التعليقات من الإخراج
    "sourceMap": true,                // توليد ملفات .map للتصحيح
    "declaration": true,              // توليد ملفات تعريف النوع .d.ts
    "declarationMap": true,           // توليد خرائط المصدر لملفات .d.ts
    "inlineSourceMap": false,         // تضمين خرائط المصدر مضمّنة
    "outFile": "./dist/bundle.js"     // دمج جميع الإخراج في ملف واحد
  }
}

{
  "compilerOptions": {
    "moduleResolution": "node",        // استخدام دقة وحدة Node.js
    "baseUrl": "./",                   // الدليل الأساسي لدقة الوحدة
    "paths": {                         // تعيين المسار للواردات
      "@utils/*": ["src/utils/*"],
      "@models/*": ["src/models/*"],
      "@components/*": ["src/components/*"]
    },
    "esModuleInterop": true,          // تمكين التوافق بين CommonJS و ES modules
    "allowSyntheticDefaultImports": true,  // السماح بالواردات الافتراضية من الوحدات بدون تصدير افتراضي
    "resolveJsonModule": true         // السماح باستيراد ملفات .json
  }
}

// بدلاً من الواردات النسبية
import { formatDate } from '../../../utils/dateFormatter';

// استخدم أسماء مستعارة نظيفة للمسار
import { formatDate } from '@utils/dateFormatter';

{
  "compilerOptions": {
    "strict": true
  }
}

// بدون strictNullChecks
let name: string = null;  // OK

// مع strictNullChecks
let name: string = null;  // Error: Type 'null' is not assignable to type 'string'
let name: string | null = null;  // OK - السماح صراحةً بـ null

type Logger = (message: string | number) => void;

// بدون strictFunctionTypes - OK
const numberLogger: Logger = (message: number) => {
  console.log(message);
};

// مع strictFunctionTypes - Error
// يجب أن تكون معلمات الدالة متوافقة

function greet(name: string, age: number) {
  console.log(`Hello ${name}, you are ${age} years old`);
}

// مع strictBindCallApply
greet.call(null, "Alice", 25);      // OK
greet.call(null, "Alice", "25");    // Error: Argument of type 'string' is not assignable to parameter of type 'number'
greet.apply(null, ["Alice"]);       // Error: Expected 2 arguments, but got 1

// بدون noImplicitAny - OK
function log(message) {  // message هو ضمنياً 'any'
  console.log(message);
}

// مع noImplicitAny - Error
function log(message) {  // Error: Parameter 'message' implicitly has an 'any' type
  console.log(message);
}

// تم الإصلاح
function log(message: string) {  // OK
  console.log(message);
}

// بدون noImplicitThis
const obj = {
  name: "Alice",
  greet() {
    return function() {
      console.log(this.name);  // 'this' هو ضمنياً 'any'
    };
  }
};

// مع noImplicitThis - يجب تحديد نوع this
const obj = {
  name: "Alice",
  greet() {
    return function(this: { name: string }) {
      console.log(this.name);
    };
  }
};

// سيتضمن JavaScript الناتج:
"use strict";

// هذا يمنع مخاطر JavaScript الشائعة مثل:
x = 10;  // Error: Cannot assign to undeclared variable

{
  "compilerOptions": {
    "noUnusedLocals": true,           // خطأ على المتغيرات المحلية غير المستخدمة
    "noUnusedParameters": true,       // خطأ على معلمات الدالة غير المستخدمة
    "noImplicitReturns": true,        // خطأ عندما لا تُرجع جميع مسارات الكود قيمة
    "noFallthroughCasesInSwitch": true, // خطأ في حالات السقوط في switch
    "allowUnreachableCode": false,    // خطأ في الكود غير القابل للوصول
    "allowUnusedLabels": false        // خطأ في التسميات غير المستخدمة
  }
}

{
  "compilerOptions": {
    "lib": ["ES2020", "DOM"],         // تعريفات النوع المراد تضمينها
    "types": ["node", "jest"],        // حزم @types المحددة المراد تضمينها
    "skipLibCheck": true              // تخطي فحص النوع لملفات التصريح
  }
}

// لمشاريع Node.js
"lib": ["ES2020"]

// لمشاريع المتصفح
"lib": ["ES2020", "DOM", "DOM.Iterable"]

// للمشاريع التي تحتاج إلى كليهما
"lib": ["ES2020", "DOM", "WebWorker"]

{
  "compilerOptions": {
    "experimentalDecorators": true,   // تمكين بناء جملة المزخرف التجريبي
    "emitDecoratorMetadata": true,    // إصدار البيانات الوصفية للمزخرفات
    "forceConsistentCasingInFileNames": true,  // ضمان أحرف اسم الملف المتسقة
    "isolatedModules": true,          // تأكد من أنه يمكن نقل كل ملف بأمان
    "jsx": "react",                   // وضع JSX لـ React
    "incremental": true,              // تمكين التجميع المتزايد للبناء الأسرع
    "tsBuildInfoFile": "./dist/.tsbuildinfo"  // أين يتم تخزين معلومات البناء المتزايد
  }
}

{
  "include": [
    "src/**/*"          // تضمين جميع الملفات في src والأدلة الفرعية
  ],
  "exclude": [
    "node_modules",     // استبعاد التبعيات
    "**/*.spec.ts",     // استبعاد ملفات الاختبار
    "**/*.test.ts",     // استبعاد ملفات الاختبار
    "dist"              // استبعاد الإخراج المُجمَّع
  ]
}

{
  "compilerOptions": {
    // اللغة والبيئة
    "target": "ES2020",
    "lib": ["ES2020"],
    "module": "commonjs",
    "moduleResolution": "node",

    // الإخراج
    "rootDir": "./src",
    "outDir": "./dist",
    "removeComments": true,
    "sourceMap": true,
    "declaration": true,

    // فحص النوع
    "strict": true,
    "noUnusedLocals": true,
    "noUnusedParameters": true,
    "noImplicitReturns": true,
    "noFallthroughCasesInSwitch": true,

    // دقة الوحدة
    "esModuleInterop": true,
    "allowSyntheticDefaultImports": true,
    "resolveJsonModule": true,
    "forceConsistentCasingInFileNames": true,

    // الأداء
    "skipLibCheck": true,
    "incremental": true,

    // تعيين المسار
    "baseUrl": "./",
    "paths": {
      "@/*": ["src/*"],
      "@utils/*": ["src/utils/*"],
      "@models/*": ["src/models/*"]
    }
  },
  "include": ["src/**/*"],
  "exclude": ["node_modules", "dist", "**/*.spec.ts"]
}

// التجميع مع tsconfig.json
tsc

// تجميع ملف محدد
tsc file.ts

// التجميع مع تكوين مخصص
tsc --project tsconfig.production.json

// وضع المراقبة
tsc --watch

// عرض إصدار المترجم
tsc --version

// عرض المساعدة
tsc --help

// تجاوز target
tsc --target ES5

// تجاوز outDir
tsc --outDir ./build

// تمكين خرائط المصدر
tsc --sourceMap true

// التجميع على الرغم من الأخطاء
tsc --noEmitOnError false

// tsconfig.json (التكوين الأساسي)
{
  "compilerOptions": {
    "strict": true,
    "target": "ES2020"
  }
}

// tsconfig.dev.json (التطوير)
{
  "extends": "./tsconfig.json",
  "compilerOptions": {
    "sourceMap": true,
    "incremental": true
  }
}

// tsconfig.prod.json (الإنتاج)
{
  "extends": "./tsconfig.json",
  "compilerOptions": {
    "removeComments": true,
    "sourceMap": false
  }
}

tsc --project tsconfig.dev.json
tsc --project tsconfig.prod.json