أنواع القوالب الحرفية تتيح لك بناء أنواع حرفية نصية جديدة عن طريق إدراج أنواع أخرى في قالب — معالجة النصوص على مستوى النوع.
ts
= ;
: = ;
: = ;
type Color = "red" | "blue";
type Shade = "light" | "dark";
type Variant = `${Shade}-${Color}`;
// "light-red" | "light-blue" | "dark-red" | "dark-blue" — all combinations
يقوم المترجم بتوسيع كل مجموعة من unions — مفيد لإنشاء مفاتيح نصية صحيحة (فئات CSS، أسماء الأحداث، أنماط المسارات) تلقائياً.
type Entity = "user" | "post";
type Event = `${Entity}:${"created" | "deleted"}`;
// "user:created" | "user:deleted" | "post:created" | "post:deleted"
function on(event: Event, cb: () => void) {}
on("user:created", () => {}); // ✅
on("user:updated", () => {}); // ❌ not a valid event
type Getters<T> = {
[K in keyof T & string as `get${Capitalize<K>}`]: () => T[K];
};
// { name: string } → { getName: () => string }
Uppercase، Lowercase، Capitalize، Uncapitalize هي مساعدات جوهرية مدمجة.
أنواع القوالب الحرفية تجعل واجهات برمجية قائمة على النصوص آمنة من حيث الأنواع: معاملات المسار، أنظمة الأحداث، CSS-in-JS، أسماء أعمدة ORM.
بدلاً من قبول أي string، يمكنك تقييد الأمر بمجموعة محددة ومُنشأة من السلاسل الصحيحة — اكتشاف الأخطاء الإملائية في وقت الترجمة في الأماكن التي كانت تستخدم السلاسل من قبل.