const{Fragment:e,jsx:n,jsxs:i}=arguments[0];function _createMdxContent(c){const r={a:"a",code:"code",h1:"h1",h2:"h2",h3:"h3",li:"li",p:"p",strong:"strong",ul:"ul",...c.components},{MyCode:a}=r;return a||function(e,n){throw new Error("Expected "+(n?"component":"object")+" `"+e+"` to be defined: you likely forgot to import, pass, or provide it.")}("MyCode",!0),i(e,{children:[n(r.h1,{id:"تسهيل-أنواع-تايب-سكريبت-باستخدام-الأدوات-المساعدة-utility-types",children:n(r.a,{className:"subheading-anchor","aria-label":"link to section",href:"#تسهيل-أنواع-تايب-سكريبت-باستخدام-الأدوات-المساعدة-utility-types",children:"تسهيل أنواع تايب سكريبت باستخدام الأدوات المساعدة (Utility Types)"})}),"\n",n(r.p,{children:"تايب سكريبت (TypeScript) هي لغة قوية تضيف نظام أنواع ثابت إلى جافاسكريبت، مما يساعد في اكتشاف الأخطاء مبكرًا وتحسين قابلية صيانة الكود. أحد الجوانب الرائعة في تايب سكريبت هو مجموعة الأدوات المساعدة (Utility Types) التي تأتي معها. هذه الأدوات هي أنواع جاهزة الصنع تساعدك على إجراء تحويلات شائعة على الأنواع، مما يجعل تعريفات الأنواع الخاصة بك أكثر اختصارًا ووضوحًا وقوة."}),"\n",n(r.p,{children:"في هذا المقال، سنستكشف بعضًا من أهم وأكثر أدوات تايب سكريبت المساعدة استخدامًا وكيف يمكنها أن تبسط عملك مع الأنواع."}),"\n",n(r.h2,{id:"ما-هي-الأدوات-المساعدة-في-تايب-سكريبت",children:n(r.a,{className:"subheading-anchor","aria-label":"link to section",href:"#ما-هي-الأدوات-المساعدة-في-تايب-سكريبت",children:"ما هي الأدوات المساعدة في تايب سكريبت؟"})}),"\n",n(r.p,{children:"الأدوات المساعدة في تايب سكريبت هي أنواع مُعرّفة مسبقًا تأخذ نوعًا موجودًا كمدخل وتُرجع نوعًا جديدًا مُحوّلًا. فكر فيها كدوال للأنواع! هذه الأدوات مبنية في لغة تايب سكريبت نفسها، مما يعني أنها متاحة للاستخدام مباشرة دون الحاجة إلى تثبيت أي شيء إضافي."}),"\n",n(r.h2,{id:"بعض-الأدوات-المساعدة-الأساسية",children:n(r.a,{className:"subheading-anchor","aria-label":"link to section",href:"#بعض-الأدوات-المساعدة-الأساسية",children:"بعض الأدوات المساعدة الأساسية"})}),"\n",n(r.p,{children:"لنستعرض بعضًا من الأدوات المساعدة الأكثر استخدامًا مع أمثلة بسيطة:"}),"\n",n(r.h3,{id:"1-partialtype",children:i(r.a,{className:"subheading-anchor","aria-label":"link to section",href:"#1-partialtype",children:["1. ",n(r.code,{children:"Partial"})]})}),"\n",i(r.p,{children:["يجعل ",n(r.code,{children:"Partial"})," جميع الخصائص في النوع ",n(r.code,{children:"Type"})," اختيارية. هذا مفيد جدًا عندما تريد إنشاء نوع يمثل جزءًا من كائن، على سبيل المثال، عند تحديث كائن حيث قد لا يتم توفير جميع الخصائص."]}),"\n",n(a,{codeblock:{value:'interface User {\n id: number;\n name: string;\n email: string;\n}\n\n// جميع الخصائص في UpdatedUser اختيارية\ntype UpdatedUser = Partial;\n\nconst updateUserInfo: UpdatedUser = {\n name: "اسم جديد",\n email: "newemail@example.com"\n // id غير مطلوب هنا\n};',lang:"typescript",meta:""}}),"\n",n(r.h3,{id:"2-requiredtype",children:i(r.a,{className:"subheading-anchor","aria-label":"link to section",href:"#2-requiredtype",children:["2. ",n(r.code,{children:"Required"})]})}),"\n",i(r.p,{children:["على عكس ",n(r.code,{children:"Partial"}),"، يجعل ",n(r.code,{children:"Required"})," جميع الخصائص في النوع ",n(r.code,{children:"Type"})," مطلوبة. هذا مفيد عندما تريد التأكد من أن جميع الخصائص موجودة، خاصةً بعد استخدام ",n(r.code,{children:"Partial"})," أو أنواع أخرى قد تجعل الخصائص اختيارية."]}),"\n",n(a,{codeblock:{value:'interface Config {\n apiKey?: string;\n timeout?: number;\n}\n\n// جميع الخصائص في FullConfig مطلوبة\ntype FullConfig = Required;\n\nconst appConfig: FullConfig = {\n apiKey: "your_api_key",\n timeout: 3000 // الآن مطلوب\n};',lang:"typescript",meta:""}}),"\n",n(r.h3,{id:"3-readonlytype",children:i(r.a,{className:"subheading-anchor","aria-label":"link to section",href:"#3-readonlytype",children:["3. ",n(r.code,{children:"Readonly"})]})}),"\n",i(r.p,{children:["يجعل ",n(r.code,{children:"Readonly"})," جميع الخصائص في النوع ",n(r.code,{children:"Type"})," للقراءة فقط. هذا يحمي الكائنات من التعديل غير المقصود بعد إنشائها."]}),"\n",n(a,{codeblock:{value:"interface Point {\n x: number;\n y: number;\n}\n\n// خصائص ReadonlyPoint لا يمكن تغييرها بعد الإنشاء\ntype ReadonlyPoint = Readonly;\n\nconst initialPoint: ReadonlyPoint = { x: 10, y: 20 };\n// initialPoint.x = 30; // خطأ! لا يمكن تعيين خاصية للقراءة فقط 'x'.",lang:"typescript",meta:""}}),"\n",n(r.h3,{id:"4-picktype-keys",children:i(r.a,{className:"subheading-anchor","aria-label":"link to section",href:"#4-picktype-keys",children:["4. ",n(r.code,{children:"Pick"})]})}),"\n",i(r.p,{children:["يختار ",n(r.code,{children:"Pick"})," مجموعة من الخصائص (المحددة بواسطة ",n(r.code,{children:"Keys"}),") من النوع ",n(r.code,{children:"Type"})," لإنشاء نوع جديد. هذا مفيد عندما تحتاج فقط إلى جزء من النوع الأصلي."]}),"\n",n(a,{codeblock:{value:"interface Product {\n id: number;\n name: string;\n price: number;\n description: string;\n}\n\n// ProductSummary يحتوي فقط على 'name' و 'price'\ntype ProductSummary = Pick;\n\nconst summary: ProductSummary = {\n name: \"اسم المنتج\",\n price: 99.99\n // 'id' و 'description' ليسا موجودين هنا\n};",lang:"typescript",meta:""}}),"\n",n(r.h3,{id:"5-omittype-keys",children:i(r.a,{className:"subheading-anchor","aria-label":"link to section",href:"#5-omittype-keys",children:["5. ",n(r.code,{children:"Omit"})]})}),"\n",i(r.p,{children:["على عكس ",n(r.code,{children:"Pick"}),"، يقوم ",n(r.code,{children:"Omit"})," بإزالة مجموعة من الخصائص (المحددة بواسطة ",n(r.code,{children:"Keys"}),") من النوع ",n(r.code,{children:"Type"})," لإنشاء نوع جديد. هذا مفيد عندما تريد استبعاد خصائص معينة من النوع الأصلي."]}),"\n",n(a,{codeblock:{value:"interface Event {\n id: string;\n timestamp: Date;\n type: 'click' | 'mouseover' | 'submit';\n payload: any;\n}\n\n// EventMetadata لا يحتوي على 'payload'\ntype EventMetadata = Omit;\n\nconst eventInfo: EventMetadata = {\n id: \"event123\",\n timestamp: new Date(),\n type: 'click'\n // 'payload' غير موجود هنا\n};",lang:"typescript",meta:""}}),"\n",n(r.h3,{id:"6-recordkeys-type",children:i(r.a,{className:"subheading-anchor","aria-label":"link to section",href:"#6-recordkeys-type",children:["6. ",n(r.code,{children:"Record"})]})}),"\n",i(r.p,{children:["ينشئ ",n(r.code,{children:"Record"})," نوعًا كائنيًا حيث تكون مفاتيح الخصائص من النوع ",n(r.code,{children:"Keys"})," وقيم الخصائص من النوع ",n(r.code,{children:"Type"}),". غالبًا ما يستخدم لإنشاء قواميس أو خرائط بيانات."]}),"\n",n(a,{codeblock:{value:'type Status = \'pending\' | \'processing\' | \'completed\';\n\n// StatusMessages هو كائن حيث تكون المفاتيح هي قيم Status والقيم هي سلاسل نصية\ntype StatusMessages = Record;\n\nconst messages: StatusMessages = {\n pending: "قيد الانتظار...",\n processing: "جاري المعالجة...",\n completed: "اكتمل!"\n};\n\nconsole.log(messages.processing); // "جاري المعالجة..."',lang:"typescript",meta:""}}),"\n",n(r.h2,{id:"فوائد-استخدام-الأدوات-المساعدة",children:n(r.a,{className:"subheading-anchor","aria-label":"link to section",href:"#فوائد-استخدام-الأدوات-المساعدة",children:"فوائد استخدام الأدوات المساعدة"})}),"\n",n(r.p,{children:"استخدام الأدوات المساعدة في تايب سكريبت يوفر العديد من الفوائد:"}),"\n",i(r.ul,{children:["\n",i(r.li,{children:[n(r.strong,{children:"قابلية القراءة:"})," تجعل تعريفات الأنواع أكثر وضوحًا وموجزة. بدلاً من كتابة أنواع معقدة يدويًا، يمكنك استخدام الأدوات المساعدة للتعبير عن التحويلات بشكل واضح."]}),"\n",i(r.li,{children:[n(r.strong,{children:"قابلية الصيانة:"})," عند تغيير النوع الأصلي، يتم تحديث الأنواع المشتقة تلقائيًا إذا تم استخدام الأدوات المساعدة بشكل صحيح."]}),"\n",i(r.li,{children:[n(r.strong,{children:"تقليل التكرار:"})," تجنب تكرار تعريفات الأنواع المشابهة. الأدوات المساعدة تسمح لك بإعادة استخدام الأنواع الموجودة وتعديلها حسب الحاجة."]}),"\n",i(r.li,{children:[n(r.strong,{children:"قوة التعبير:"})," تسمح لك الأدوات المساعدة بالتعبير عن علاقات معقدة بين الأنواع بطريقة بسيطة وقوية."]}),"\n"]}),"\n",n(r.h2,{id:"الخلاصة",children:n(r.a,{className:"subheading-anchor","aria-label":"link to section",href:"#الخلاصة",children:"الخلاصة"})}),"\n",n(r.p,{children:"الأدوات المساعدة في تايب سكريبت هي مجموعة قوية من الأدوات التي يمكن أن تجعل عملك مع الأنواع أكثر كفاءة وفعالية. من خلال فهم واستخدام هذه الأدوات، يمكنك كتابة كود تايب سكريبت أكثر وضوحًا وقابلية للصيانة وأقل عرضة للأخطاء. استكشف المزيد من الأدوات المساعدة المتاحة في وثائق تايب سكريبت لتوسيع ترسانتك في تطوير أنواع قوية!"}),"\n",n(r.p,{children:"أتمنى أن يكون هذا المقال قد قدم لك نظرة عامة مفيدة على الأدوات المساعدة في تايب سكريبت. لا تتردد في تجربتها في مشاريعك القادمة!"})]})}return{default:function(e={}){const{wrapper:i}=e.components||{};return i?n(i,{...e,children:n(_createMdxContent,{...e})}):_createMdxContent(e)}};

Pydantic 101: Data Validation and Parsing Made Easy