إصلاح · Node وnpm والبناء

أخطاء TypeScript توقف البناء

ما قد تراه

يطبع البناء Type error ويتوقف
يعرض المحرر خطوطاً حمراء بينما بدا أن التطبيق يعمل

السبب الأرجح

يتحقق TypeScript أن البيانات بالشكل الذي تتوقعه الشيفرة؛ وشكل خاطئ واحد يوقف بناء الإنتاج حتى لو بدت الصفحة تعمل.

افحص أولاً (نحو دقيقتين)

اقرأ أول خطأ: يعطي ملفاً ورقم سطر.
شغّل npx tsc --noEmit لتعرض كل الأخطاء دون بناء.

أمر الإصلاح

ما تكتبه هنا لا يغادر متصفحك. البحث يعمل داخل هذه الصفحة ولا يُرسل شيء إلى خادم ولا إلى ذكاء اصطناعي.

نص الخطأ بالضبط أو ما تراه

ما فعلته قبل أن يحدث

يبقى في هذا المتصفح وعلى هذا الجهاز فقط. تُحذف المفاتيح وكلمات المرور قبل أي حفظ.

لغة الأمر

أنت مهندس خبير وصبور يعرف Node.js وnpm وأدوات البناء ويشرحها لأشخاص ليسوا مبرمجين. أنا لست مبرمجاً، لذلك اشرح كل خطوة بكلمات بسيطة وحدّد لي بالضبط أي زر أو قائمة أو أمر تقصد. إذا لم تكن متأكداً من شيء فقل ذلك ولا تخمّن.

المشكلة
أخطاء TypeScript توقف البناء

نص الخطأ كما ظهر لي، أو ما أراه
[الصق هنا نص الخطأ كما ظهر لك]

ما فعلته قبل أن تحدث المشكلة
[اكتب بإيجاز ما فعلته قبل ظهور المشكلة]

السبب الأرجح
يتحقق TypeScript أن البيانات بالشكل الذي تتوقعه الشيفرة؛ وشكل خاطئ واحد يوقف بناء الإنتاج حتى لو بدت الصفحة تعمل.

نفّذ هذه الخطوات بهذا الترتيب
1. شغّل npx tsc --noEmit واعرض القائمة. ابدأ بأول خطأ فقط.
2. اشرح معنى الخطأ بكلمات بسيطة وأصلح السبب الحقيقي (شكل البيانات الخاطئ أو غياب فحص القيم الفارغة) وليس إسكاته فقط.
3. كرر للخطأ التالي. وبعد كل واحد أعد تشغيل npx tsc --noEmit.
4. أنهِ بـ npm run build.
توقف وأخبرني إذا كان ما تراه لا يطابق إحدى الخطوات. لا تتجاوز أي خطوة.

تأكد أن الحل نجح
- لا يطبع npx tsc --noEmit شيئاً وينجح npm run build.
أخبرني بالضبط ماذا يجب أن أرى على الشاشة عندما ينجح.

لا تغيّر
- لا تستخدم "any" أو @ts-ignore ولا توقف الوضع الصارم أو فحص الأخطاء في البناء للتمرير.
- أي شيء لم أطلبه: التصميم أو النصوص أو الصفحات الأخرى أو الإعدادات الأخرى أو البيانات.
- لا تحذف ملفات أو بيانات أو فروعاً، ولا تعِد الضبط ولا تدفع بالقوة (force push)، ولا تعيد كتابة السجل، إلا بعد أن تعرض عليّ بالضبط ما الذي سيضيع وأوافق.
- لا تلصق ولا تطبع ولا تطلب مني لصق كلمة مرور أو مفتاح سري في هذه المحادثة. وإذا لزم أحدها فأخبرني في أي صفحة إعدادات من الخدمة الصحيحة أحفظه.

عند الانتهاء
اشرح بكلمات بسيطة ما الذي غيّرته (ملفاً ملفاً أو إعداداً إعداداً) ولماذا غيّرته وكيف أتراجع عنه.

الصقه في Claude أو ChatGPT أو Gemini أو Cursor ثم اتبع ما يقوله.

بعد أن جرّبته، هل نجح؟

الخطوات

شغّل npx tsc --noEmit واعرض القائمة. ابدأ بأول خطأ فقط.
اشرح معنى الخطأ بكلمات بسيطة وأصلح السبب الحقيقي (شكل البيانات الخاطئ أو غياب فحص القيم الفارغة) وليس إسكاته فقط.
كرر للخطأ التالي. وبعد كل واحد أعد تشغيل npx tsc --noEmit.
أنهِ بـ npm run build.

لا تفعل هذا

لا تحذف الملف أو الميزة الفاشلة.
لا تستخدم "any" أو @ts-ignore ولا توقف الوضع الصارم أو فحص الأخطاء في البناء للتمرير.