ما هي أنواع القوالب الحرفية؟

Question

Accepted Answer

**أنواع القوالب الحرفية** تتيح لك بناء أنواع حرفية نصية جديدة عن طريق إدراج أنواع أخرى في قالب — معالجة النصوص على مستوى *النوع*. ```ts type Greeting = `Hello, ${string}`; const a: Greeting = "Hello, world"; // ✅ const b: Greeting = "Hi there"; // ❌ doesn't match the pattern ``` ## الجمع بين unions — يتم التوزيع ```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، أسماء الأحداث، أنماط المسارات) تلقائياً. ## نمط من الحياة الواقعية: أسماء الأحداث المكتوبة ```ts 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 ``` ## مع إعادة تعيين المفاتيح والمساعدات الجوهرية ```ts type Getters = { [K in keyof T & string as `get${Capitalize}`]: () => T[K]; }; // { name: string } → { getName: () => string } ``` `Uppercase`، `Lowercase`، `Capitalize`، `Uncapitalize` هي مساعدات جوهرية مدمجة. ## لماذا هذا مهم أنواع القوالب الحرفية تجعل واجهات برمجية قائمة على النصوص آمنة من حيث الأنواع: معاملات المسار، أنظمة الأحداث، CSS-in-JS، أسماء أعمدة ORM. بدلاً من قبول أي `string`، يمكنك تقييد الأمر بمجموعة محددة ومُنشأة من السلاسل الصحيحة — اكتشاف الأخطاء الإملائية في وقت الترجمة في الأماكن التي كانت تستخدم السلاسل من قبل.