مُنسِّق TypeScript

TypeScript مجموعة فائقة من JavaScript، لكن صياغة مستوى الأنواع التي يُضيفها — الواجهات، الأنواع العامة المُقيَّدة بـ`extends`، المُزخرِفات، تأكيدات النوع `as`، والتصريحات المستقلة الخاصة بالأنواع فقط — ليس لها أي معنى في قواعد JavaScript العادية وتجعل مُحلِّلًا يفهم JavaScript فقط يفشل مباشرة في TypeScript صالح تمامًا. استخدام مُحلِّل TypeScript المخصص بدلًا من محاولة إجبار مُحلِّل JavaScript على قبول مجموعة فائقة من قواعده الخاصة هو ما يسمح لملف مليء بالأنواع العامة والواجهات بالتنسيق بشكل صحيح بدلًا من رفضه كخطأ صياغة في اللحظة التي يستخدم فيها ميزة لا يملكها JavaScript نفسه.

ملف `.tsx` يجمع صياغة JSX مع تعليقات أنواع TypeScript غامض حقًا للتحليل عند نقطة معينة: تأكيد نوع بأقواس زاويّة مثل `<Foo>value` يبدو مطابقًا لبداية وسم عنصر JSX لمُحلِّل لم يُخبَر بأي لهجة يقرأ. اختيار وضع تحليل TypeScript-مع-JSX يحل ذلك الغموض بشكل صحيح، لذا اختيار اللهجة الصحيحة مسبقًا — بدلًا من افتراض أن مُحلِّل JavaScript عامًا سيحله — مهم تحديدًا لملفات المكونات التي تمزج الاثنين.

المُزخرِفات — التعليقات التوضيحية على طراز `@Component` الشائعة في Angular وبعض أُطر عمل الخلفية المبنية على TypeScript — مرت بعدة مراحل اقتراح متمايزة في عملية توحيد اللغة، ويمكن لقواعد كود مختلفة استهداف نسخ مختلفة قليلًا من تلك الصياغة حسب متى كُتبت وأي خيارات مُترجم تستخدم. تحليل صياغة المُزخرِفات بشكل صحيح يتطلب تحديدًا مُحلِّل TypeScript الواعي؛ مُحلِّل JavaScript عادي يصادف `@` قبل صنف أو دالة ليس له أي معنى مُعرَّف يلجأ إليه وسيرفض الملف مباشرة.