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

مرحباً بالجميع! أنا مبتدئ في TypeScript وأعمل على مكتبة للاستخدام الداخلي. لدي بعض الدوال والخصائص القديمة التي أريد التخلص منها تدريجياً للانتقال إلى API جديد. أعلم أن في JSDoc هناك وسم `@deprecated` الذي يبرز الطريقة في محررات الأكواد، لكن في 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); } ```