TypeScript لغتي الأساسية، ومع مرور السنين لم يعد مجرد اختيار للغة، بل أصبح مجموعة من القيم. ليست قواعد دليل أسلوب، بل عادات تحدد ما إذا كان تعديل قاعدة الشيفرة سيظل مريحًا بعد عامين وانضمام ثلاثة مطورين جدد.
الصدق قبل الراحة. يكون الوضع الصارم مفعّلًا منذ أول commit. إن any إشارة إلى خلل، لا نوع؛ وإذا لم أعرف شكل البيانات حقًا أستخدم unknown ثم أضيّق نوعه تدريجيًا. النوع الكاذب —مثل تحويل as لإسكات المترجم— أسوأ من غياب النوع، لأن كل ما يأتي بعده يثق به. عندما يعترض المترجم يكون محقًا غالبًا؛ موضع الإصلاح هو البيانات لا التعليق النوعي.
اجعل الحالات المستحيلة مستحيلة. بدل ثلاثة أعلام isLoading وisError وdata قد تتناقض، أستخدم اتحادًا مميّزًا: idle، وloading، وsuccess مع البيانات، وerror مع السبب. وينطبق ذلك على حالات المجال أيضًا: الطلب المدفوع له paymentId، أما غير المدفوع فلا. يحوّل switch مع فحص شامل باستخدام never حالة «نسينا فرعًا» من حادث إنتاج إلى خط أحمر في المحرر.
ثق داخل التطبيق وتحقق عند الحدود. تختفي الأنواع وقت التشغيل، لذا يُحلّل كل ما يعبر حدًا —جسم HTTP، أو webhook، أو نموذجًا، أو localStorage، أو استجابة LLM— باستخدام Zod أو مخطط مشابه، ويُستنتج النوع من المخطط نفسه. مصدر حقيقة واحد يمنع الاختلاف بين ما نتحقق منه وما نعتقده. وداخل التطبيق تتدفق البيانات محددة الأنواع من دون فحوص دفاعية في كل سطر.
شارك العقود لا التخمينات. في منتج Full-Stack تُولّد أنواع API أو تُشارك عبر OpenAPI أو GraphQL Codegen أو Prisma أو حزمة مشتركة؛ فتؤدي إعادة تسمية حقل إلى فشل البناء لا إلى تعطل الدفع. الوضوح أهم من الاستعراض: واجهة بسيطة يفهمها موظف جديد خلال عشر ثوانٍ أفضل من نوع شرطي من خمس طبقات يثبت أنني قرأت الدليل. الأجيال العامة لإعادة الاستخدام، لا للتباهي.
لا تستبدل الأنواع الاختبارات والمراجعات والتفكير؛ بل تجعل الثلاثة أقل تكلفة. هذه هي قيمة مطور TypeScript فعلًا: ليس حفظ كل utility type، بل ترك شيفرة يستطيع الشخص التالي تعديلها بثقة. إذا امتلأت قاعدة شيفرتك بـ any وخاف الفريق من إعادة الهيكلة، فأرسل الوحدة التي لا يريد أحد لمسها. سأشرح كيف أضيف إليها الأنواع وما الأخطاء التي سيكشفها ذلك.
امنح المنتج القادم شخصاً يبقى معه.
هل أنت مستعد للبدء؟ أرسل لي رسالة؛ أنا متاح للبدء الآن والبقاء. عقود طويلة الأمد، لا تسليم خلال أسبوعين. لنتحدث عن مشروعك ومتطلباته وأفضل طريقة للمضي قدماً.