ไมโครซอฟท์เปิดตัวภาษา TypeSpec ไม่ได้เป็นภาษาโปรแกรมมิ่งโดยตรง แต่เป็นภาษาระดับสูงสำหรับกำหนดนิยาม API (high-level API definition language) ที่ได้อิทธิพลมาจาก TypeScript และ C#
TypeSpec ถูกสร้างขึ้นเพื่อเป็นภาษากลาง ทำ abstraction ของโมเดล แล้วนำไปแปลงเป็นภาษาหรือสเปกอื่นๆ (ที่ยาวและละเอียดกว่า) อีกที เช่น OpenAPI (YAML), JSON Schema, Protobuf ช่วยอำนวยความสะดวกในการใช้งาน เพราะตัว TypeSpec ออกแบบมาใช้สั้นกระชับ แต่ยังสามารถนิยามโครงสร้างข้อมูลหรือ API ที่ซับซ้อนได้ และเน้นการนำนิยามไปใช้ซ้ำ (reuse) ในโอกาสอื่นๆ ได้
การที่มันเป็นภาษาของไมโครซอฟท์ ทำให้เครื่องมืออย่าง Visual Studio และ VS Code รองรับเป็นอย่างดี ไมโครซอฟท์ยังเปิดเผยว่านำ TypeSpec ไปใช้เองภายใน (dogfooding) กับบริการในเครือ Azure หลายตัว รวมถึง Microsoft Graph แพลตฟอร์ม API ของ Microsoft 365 ด้วย
ที่มา - TypeSpec
ตัวอย่างการแปลง TypeSpec เป็น OpenAPI YAML