TypeScript في التطوير الحديث: نصائح واحترافيات

// الأنواع البدائية
const name: string = 'VETAP';
const age: number = 5;
const isActive: boolean = true;
const data: null = null;
const value: undefined = undefined;

// المصفوفات
const numbers: number[] = [1, 2, 3];
const names: Array<string> = ['John', 'Jane'];

// الكائنات
const user: { name: string; age: number } = {
  name: 'John',
  age: 30
};

// الدوال
function greet(name: string): string {
  return `Hello, ${name}!`;
}

// معاملات اختيارية وافتراضية
function createUser(
  name: string,
  age?: number,
  isAdmin: boolean = false
): User {
  return { name, age: age ?? 0, isAdmin };
}

// Interface (مفضل للكائنات)
interface User {
  id: string;
  name: string;
  email: string;
  age?: number; // اختياري
  readonly createdAt: Date; // للقراءة فقط
}

// Type alias (أكثر مرونة)
type Status = 'pending' | 'approved' | 'rejected';
type UserWithStatus = User & { status: Status };

// توسيع الواجهات
interface AdminUser extends User {
  permissions: string[];
  role: 'admin' | 'super-admin';
}

interface User {
  id: string;
  name: string;
  email: string;
  age: number;
}

// Partial: جعل جميع الخصائص اختيارية
type PartialUser = Partial<User>;
// { id?: string; name?: string; ... }

// Pick: اختيار خصائص محددة
type UserPreview = Pick<User, 'id' | 'name'>;
// { id: string; name: string }

// Omit: استبعاد خصائص محددة
type UserWithoutId = Omit<User, 'id'>;
// { name: string; email: string; age: number }

// Required: جعل جميع الخصائص مطلوبة
type RequiredUser = Required<Partial<User>>;

// Record: إنشاء نوع كائن
type UserMap = Record<string, User>;
// { [key: string]: User }

// دالة عامة
function identity<T>(arg: T): T {
  return arg;
}

// واجهة عامة
interface Repository<T> {
  findById(id: string): Promise<T | null>;
  save(entity: T): Promise<T>;
  delete(id: string): Promise<void>;
}

// مكون عام (React)
function List<T>({ items, render }: {
  items: T[];
  render: (item: T) => React.ReactNode;
}) {
  return (
    <ul>
      {items.map((item, index) => (
        <li key={index}>{render(item)}</li>
      ))}
    </ul>
  );
}

// دالة type guard
function isString(value: unknown): value is string {
  return typeof value === 'string';
}

// الاستخدام
function processValue(value: unknown) {
  if (isString(value)) {
    // TypeScript يعرف أن value هو string هنا
    console.log(value.toUpperCase());
  }
}

// tsconfig.json
{
  "compilerOptions": {
    "target": "ES2020",
    "lib": ["dom", "dom.iterable", "esnext"],
    "allowJs": true,
    "skipLibCheck": true,
    "strict": true,
    "forceConsistentCasingInFileNames": true,
    "noEmit": true,
    "esModuleInterop": true,
    "module": "esnext",
    "moduleResolution": "bundler",
    "resolveJsonModule": true,
    "isolatedModules": true,
    "jsx": "preserve",
    "incremental": true,
    "plugins": [
      {
        "name": "next"
      }
    ],
    "paths": {
      "@/*": ["./*"]
    }
  },
  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
  "exclude": ["node_modules"]
}

// Server Component
interface PageProps {
  params: Promise<{ id: string }>;
  searchParams: Promise<{ [key: string]: string | string[] | undefined }>;
}

export default async function Page({ params, searchParams }: PageProps) {
  const { id } = await params;
  const { query } = await searchParams;
  // ...
}

// Client Component
'use client';

interface ButtonProps {
  children: React.ReactNode;
  onClick?: () => void;
  variant?: 'primary' | 'secondary';
  disabled?: boolean;
}

export function Button({ 
  children, 
  onClick, 
  variant = 'primary',
  disabled = false 
}: ButtonProps) {
  return (
    <button
      onClick={onClick}
      disabled={disabled}
      className={`btn btn-${variant}`}
    >
      {children}
    </button>
  );
}

// app/api/users/route.ts
import { NextRequest, NextResponse } from 'next/server';
import { z } from 'zod';

const userSchema = z.object({
  name: z.string().min(2),
  email: z.string().email(),
});

type UserInput = z.infer<typeof userSchema>;

export async function POST(req: NextRequest) {
  try {
    const body: UserInput = await req.json();
    const validated = userSchema.parse(body);
    // ...
    return NextResponse.json({ success: true });
  } catch (error) {
    return NextResponse.json(
      { error: 'Invalid input' },
      { status: 400 }
    );
  }
}

// tsconfig.json
{
  "compilerOptions": {
    "strict": true,
    "noImplicitAny": true,
    "strictNullChecks": true,
    "strictFunctionTypes": true,
    "strictBindCallApply": true,
    "strictPropertyInitialization": true,
    "noImplicitThis": true,
    "alwaysStrict": true
  }
}

// جيد: Interface لشكل الكائن
interface User {
  id: string;
  name: string;
}

// جيد: Type للاتحادات/البدائيات
type Status = 'active' | 'inactive';

// سيء
function process(data: any) {
  // ...
}

// جيد
function process<T>(data: T): T {
  // ...
}

// أو استخدم unknown
function process(data: unknown) {
  if (typeof data === 'string') {
    // TypeScript يعرف أنه string
  }
}

// فقط عندما تكون متأكداً
const element = document.getElementById('app') as HTMLDivElement;

// أفضل: Type guard
function isHTMLElement(el: Element): el is HTMLElement {
  return el instanceof HTMLElement;
}