كيفية وضع علامة على خاصية أو طريقة كمهملة (deprecated) في TypeScript؟

مرحباً بالجميع! أنا مبتدئ في TypeScript وأعمل على مكتبة للاستخدام الداخلي. لدي بعض الدوال والخصائص القديمة التي أرغب في إيقاف استخدامها تدريجياً للانتقال إلى API جديد. أعلم أن هناك وسم `@deprecated` في JSDoc الذي يسلط الضوء على الطريقة في محررات الأكواد، لكن في TypeScript لست متأكداً من كيفية القيام بذلك بشكل صحيح. إليك مثال على الكود الخاص بي: ```typescript // الطريقة القديمة التي أريد وضع علامة عليها كمهملة function calculateTotal(items: number[]): number { return items.reduce((sum, item) => sum + item, 0); } // الطريقة الجديدة function calculateSum(items: number[]): number { // منطق جديد مع تحقق إضافي if (items.length === 0) { return 0; } return items.reduce((sum, item) => sum + item, 0); } ```