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

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