ncode TS Generator

Das Tool wandelt eine knappe, hochrangige Spezifikation in TypeScript-Codevorlagen um, um Domänenmodelle, Services und API-Clients zu scaffolden. Zielnutzer sind TypeScript-Ingenieure, Backend-Architekten und Plattform-Teams, die wiederverwendbaren Boilerplate mit konsistenter Struktur suchen. Eine Spezifikation liefert target_ts_version, module_system, Entities mit Feldern und optionale Features wie include_validation, include_tests oder client methods; die Ausgabe besteht aus sofort anpassbaren Vorlagen, die sich an Projektkonventionen und TypeScript-Best-Practices orientieren.
Kernlogik & Funktionen: Erforderliche Features umfassen Spezifikations-Parsing und strikte Validierung, Template-Rendering für Kernartefakte (Modelle/Interfaces, Services, API-Clients und DTOs), Type-Mapping für Primitive- und benutzerdefinierte Typen sowie grundlegende Abhängigkeitsauflösung, um Namenskonflikte zu vermeiden. Optionale Features umfassen bedingte Template-Sektionen, anpassbare Namensstrategien, versionierte Template-Packs und anschließbare Backends für Dateiausgabe oder In-Memory-Auslieferung. Das System erzwingt TypeScript-Syntaxregeln, reservierte Schlüsselwörter und Erkennung zirkulärer Abhängigkeiten. Es unterstützt ESModule- und CommonJS-Modi und kann Ausgaben an eine angegebene TS-Version anpassen.
Eingaben & Ausgaben: Eingaben umfassen target_ts_version (String, z. B. '4.9'), module_system (String, 'ESNext' oder 'CommonJS'), Entities (Array von {name:string, fields:[{name:string, type:string, optional:boolean}]}), include_tests (bool), include_validation (bool). Ausgaben sind Artefakte wie model.ts, service.ts, client.ts, dto.ts, tests.ts, die als Code-Strings oder Dateiausgaben erzeugt werden, mit standardisiertem TypeScript-Format und Import/Export-Konventionen. Die Ausgaben bewahren Typsicherheit, korrekte Nullbarkeit und konsistente Benennung über Artefakte hinweg.
Algorithmen & Berechnungen: Intern verwendet der Template-Engine ein spekbumme Mapping: Entitätsfelder werden zu Interfaces/Klassen, Generatoren erzeugen Konstruktoren oder Fabriken, DTOs werden abgeleitet, wenn include_validation aktiv ist, und API-Client-Vorlagen basieren auf endpoint-ähnlichen Spezifikationen. Abhängigkeitsauflösung vermeidet Doppelbenennungen und verbindet Typen über Importe. Der Ansatz strebt deterministische Ergebnisse über mehrere Durchläufe an.
Fehler & Randfälle: Fehlende Pflichtangaben (z. B. Entity-Name oder Feldtyp) lösen Validierungsfehler aus. Unbekannte Typen, ungeklärte Abhängigkeiten oder Konflikte bei Template-Varianten führen zu klaren Fehlermeldungen und sicheren Defaults. Inkompatible TS-Version oder Modul-Systeme geben eine klare Fehlermeldung mit Anleitung aus.
Industrie/Region & Lokalisierung: Vorgaben standardmäßig auf US-Englisch; Lokalisierungs-Hooks existieren für zukünftige Updates. Annahmen & Ausschlüsse: Dieses Tool generiert Skelettcode und führt keinen Laufzeitcode aus; keine UI-Renderings oder Deploy-Schritte.