ncode TS Generator

הכלי ממיר מפרט תמציתי ברמת-גבוהה לתבניות קוד TypeScript ליצירת מודלים, שירותים Clients API ו-DTOs. המשתמשים הם מהנדסי TypeScript, ארכיטקטים Backend וצוותי פלטפורמה שמבקשים boilerplate שניתן לשכפול עם מבנה עקבי. מפרט מספק target_ts_version, module_system, ישויות עם שדות ותכונות אופציונליות כמו include_validation, include_tests או שיטות לקוח; הפלט כולל תבניות ready-to-customize התואמות לקונבנציות הפרויקט ולשיטות הטובות של TypeScript.
לוגיקה מרכזית ותכונות: דרושות כולל ניתוח מפרט ואימות קשוח, הצגת תבניות עבור Artefakti מרכזיים (מודלים/ממשקים, שירותים, API-Clients ו-DTOs), מיפוי סוגים לבסיסי טיפוס ולטיפוסים שהוגדרו על ידי המשתמש, וכן פתרון תלותים בסיסי כדי למנוע התנגשות שמות. תכונות נוספות כוללות חלקים מותנים בתבנית, אסטרטגיות שם מותאמות, חבילת תבניות בגרסאות שונות ו-backends מחליפים לייצוא לקובצי או מסירה בזיכרון. המערכת מחייבת כללי תחביר TypeScript, בדיקת מילים שמורות וזיהוי תלות מעגלית. תומך ב-ESModule וב-CommonJS ומתאים את ה-output לגרסת TS מסוימת.
קלטים ופלטים: קלטים כוללים target_ts_version (מחרוזת, לדוגמה '4.9'), module_system (מחרוזת, 'ESNext' או 'CommonJS'), ישויות (מערך של {name:string, fields:[{name:string, type:string, optional:boolean}]}), include_tests (bool), include_validation (bool). פלטים הם ארtefactים כמו model.ts, service.ts, client.ts, dto.ts, tests.ts, שנוצרים כמחרוזות קוד או פלט קובץ, עם עיצוב TypeScript תקני ועקרונות ייבוא/ייצוא עקביים. הפלטים שומרים על בטיחות טיפוס, נדרש שוליות ונורמליזציה עקבית.
אלגוריתמים וחישובים: למעשה מנגנון תבניות מיישם מיפוי מושתת על מפרט: שדות ישויות משתלבים בממשקים/מחלקות, Generator-ים יוצרים בונים או factory, DTOs נגזרים כאשר include_validation פעיל, ותבניות Client API מבוססות על מפרטי endpoints. פתרון תלותים למניע כפילויות באמצעות ייבוא. הגישה מכוונת לתוצאות דטרמיניסטיות בכל ריצה.
שגיאות ומצבים קשים: קלטים חסרים או שגויים מפעילים שגיאות אימות. סוגי שדות לא מוכרים, תלותים לא פתורים או וריאנטים של תבניות שמורסות שגיאות מובילות ל הודעות ברורות והחלפות בטוחות. גרסת TS שאינה תואמת או מערכת מודולים שאינה נתמכת תצביע על שגיאה עם הנחיה.
תעשייה/אזור ולוקליזציה: ברירת המחדל היא אנגלית אמריקאית; קיימים הוקים ללוקלי-זציה לעדכונים עתידיים. הנחות והחרגות: כלי זה מייצר תשתיות קוד ואינו מריץ לוגיקה בזמן ריצה; אין_RENDER UI או שלבי פריסה.