@xrmforge/typegen 0.8.4 → 0.8.5

package/docs/architektur/00-README.md

@@ -1,26 +1,26 @@
-# XrmForge Architektur
-
-> **Status:** Lebendes Dokument, das den aktuellen Implementierungsstand beschreibt.
-> **Letztes Update:** 2026-04-04 (Session 10)
-> **Version:** 7 Packages, 666+ Tests über alle Packages.
-
-## Kapitel
-
-1. [Zusammenfassung](01-zusammenfassung.md)
-2. [Package-Architektur](02-packages.md)
-3. [Generierte Typen](03-generierte-typen.md)
-4. [CLI-Befehle](04-cli.md)
-5. [Build-Architektur](05-build.md)
-6. [Inkrementelle Generierung](06-inkrementell.md)
-7. [HTTP-Client](07-http-client.md)
-8. [Authentifizierung](08-authentifizierung.md)
-9. [Test-Framework](09-testing.md)
-10. [ESLint-Plugin](10-eslint-plugin.md)
-11. [AGENT.md-System](11-agent-md.md)
-12. [@types/xrm-Fallstricke](12-xrm-fallstricke.md)
-13. [@xrmforge/helpers Package](13-helpers.md)
-14. [Showcases](14-showcases.md)
-15. [CI/CD](15-ci-cd.md)
-16. [Technische Schulden](16-technische-schulden.md)
-17. [Roadmap](17-roadmap.md)
-18. [Designprinzipien](18-designprinzipien.md)
+# XrmForge Architektur
+
+> **Status:** Lebendes Dokument, das den aktuellen Implementierungsstand beschreibt.
+> **Letztes Update:** 2026-04-04 (Session 10)
+> **Version:** 7 Packages, 666+ Tests über alle Packages.
+
+## Kapitel
+
+1. [Zusammenfassung](01-zusammenfassung.md)
+2. [Package-Architektur](02-packages.md)
+3. [Generierte Typen](03-generierte-typen.md)
+4. [CLI-Befehle](04-cli.md)
+5. [Build-Architektur](05-build.md)
+6. [Inkrementelle Generierung](06-inkrementell.md)
+7. [HTTP-Client](07-http-client.md)
+8. [Authentifizierung](08-authentifizierung.md)
+9. [Test-Framework](09-testing.md)
+10. [ESLint-Plugin](10-eslint-plugin.md)
+11. [AGENT.md-System](11-agent-md.md)
+12. [@types/xrm-Fallstricke](12-xrm-fallstricke.md)
+13. [@xrmforge/helpers Package](13-helpers.md)
+14. [Showcases](14-showcases.md)
+15. [CI/CD](15-ci-cd.md)
+16. [Technische Schulden](16-technische-schulden.md)
+17. [Roadmap](17-roadmap.md)
+18. [Designprinzipien](18-designprinzipien.md)

package/docs/architektur/01-zusammenfassung.md

@@ -1,11 +1,11 @@
-# 1. Zusammenfassung
-
-XrmForge ist ein quelloffenes TypeScript-Toolkit für typsichere Dynamics 365 / Dataverse WebResource-Entwicklung. Es generiert TypeScript-Deklarationen aus Live-Dataverse-Metadaten und verwandelt Laufzeit-String-Fehler in Kompilierzeit-Typfehler.
-
-**Kernnutzenversprechen:** Jeder Feldname, OptionSet-Wert, Tab-Name, Entitätsname und Subgrid-Name wird zu einer typisierten Konstante mit IDE-Autovervollständigung und Kompilierzeit-Validierung.
-
-**Zielgruppe:** D365-Entwickler, die Formularskripte (WebResources) in JavaScript/TypeScript schreiben und Kompilierzeit-Sicherheit, null Magic Strings und moderne Werkzeuge (esbuild, vitest, ESLint) wollen.
-
-**Technologie-Stack:** TypeScript, pnpm-Monorepo mit Turborepo, esbuild für IIFE-Bundles, vitest für Tests, @azure/identity für Authentifizierung, fast-xml-parser für FormXml-Parsing.
-
-**npm-Organisation:** [@xrmforge](https://www.npmjs.com/org/xrmforge)
+# 1. Zusammenfassung
+
+XrmForge ist ein quelloffenes TypeScript-Toolkit für typsichere Dynamics 365 / Dataverse WebResource-Entwicklung. Es generiert TypeScript-Deklarationen aus Live-Dataverse-Metadaten und verwandelt Laufzeit-String-Fehler in Kompilierzeit-Typfehler.
+
+**Kernnutzenversprechen:** Jeder Feldname, OptionSet-Wert, Tab-Name, Entitätsname und Subgrid-Name wird zu einer typisierten Konstante mit IDE-Autovervollständigung und Kompilierzeit-Validierung.
+
+**Zielgruppe:** D365-Entwickler, die Formularskripte (WebResources) in JavaScript/TypeScript schreiben und Kompilierzeit-Sicherheit, null Magic Strings und moderne Werkzeuge (esbuild, vitest, ESLint) wollen.
+
+**Technologie-Stack:** TypeScript, pnpm-Monorepo mit Turborepo, esbuild für IIFE-Bundles, vitest für Tests, @azure/identity für Authentifizierung, fast-xml-parser für FormXml-Parsing.
+
+**npm-Organisation:** [@xrmforge](https://www.npmjs.com/org/xrmforge)

package/docs/architektur/02-packages.md

@@ -1,110 +1,110 @@
-# 2. Package-Architektur
-
-## 2.1 Package-Übersicht
-
-| Package | Version | Tests | Beschreibung |
-|---------|---------|-------|--------------|
-| @xrmforge/typegen | 0.8.0 | 444 | Kern: Typgenerierungs-Engine, Metadaten-Client, HTTP-Client, Hilfsfunktionen |
-| @xrmforge/cli | 0.4.2 | 10 | CLI: generate-, build-, init-Befehle |
-| @xrmforge/testing | 0.2.0 | 76 | Test-Hilfsmittel: createFormMock, fireOnChange, setupXrmMock |
-| @xrmforge/helpers | 0.1.0 | 59 | Browsersichere Laufzeit: select(), parseLookup(), typedForm(), Xrm-Konstanten, Action-Executors |
-| @xrmforge/webapi | 0.1.0 | 45 | Typsicherer Xrm.WebApi-Client mit QueryBuilder |
-| @xrmforge/devkit | 0.4.0 | 42 | Build-Orchestrierung, Scaffolding, AGENT.md-Generierung |
-| @xrmforge/eslint-plugin | 0.2.0 | 32 | 5 D365-spezifische ESLint-Regeln |
-
-**Gesamt:** 708 Tests über 7 Packages.
-
-## 2.2 Abhängigkeitsgraph
-
-```
-@xrmforge/cli
-  |-- @xrmforge/typegen (generate-Befehl)
-  |-- @xrmforge/devkit  (build- + init-Befehle)
-  '-- commander (CLI-Framework)
-
-@xrmforge/typegen
-  |-- @azure/identity  (Authentifizierung)
-  '-- fast-xml-parser  (FormXml-Parsing)
-
-@xrmforge/devkit
-  '-- esbuild (IIFE-Bundling)
-
-@xrmforge/testing     (keine Laufzeit-Abhängigkeiten)
-@xrmforge/helpers     (keine Laufzeit-Abhängigkeiten)
-@xrmforge/webapi      (keine Laufzeit-Abhängigkeiten)
-@xrmforge/eslint-plugin (ESLint Peer-Abhängigkeit)
-```
-
-## 2.3 Package-Details
-
-### @xrmforge/typegen
-
-Das Kern-Package. Enthält:
-
-- **TypeGenerationOrchestrator** - Koordiniert die gesamte Generierungs-Pipeline
-- **MetadataClient** - Fragt Dataverse-Metadaten ab (Entitäten, Formulare, OptionSets, Custom APIs)
-- **DataverseHttpClient** - Belastbarer REST-Client mit Retry, Rate Limiting, Nebenläufigkeitssteuerung
-- **ChangeDetector** - Inkrementelle Generierung über RetrieveMetadataChanges
-- **MetadataCache** - Dateisystem-basiertes Caching mit Versionsstempeln
-- **Generators** - Entitäts-Interfaces, Formular-Interfaces, OptionSet-Enums, Fields-Enums, EntityNames, Navigations-Properties, Action/Function-Executors
-- **Helpers** - select(), parseLookup(), parseFormattedValue() (verschoben nach @xrmforge/helpers)
-- **Xrm-Konstanten** - DisplayState, FormNotificationLevel, RequiredLevel, SubmitMode, SaveMode, ClientType, ClientState (verschoben nach @xrmforge/helpers)
-- **Authentifizierung** - createCredential()-Factory für 4 Authentifizierungsmethoden
-- **Logging** - Scope-basierte Logger mit austauschbaren Senken (Console, JSON, Silent)
-- **Fehler** - Strukturierte Fehlerhierarchie mit ErrorCode-Enum (AUTH_1xxx, API_2xxx, META_3xxx, GEN_4xxx, CONFIG_5xxx)
-
-### @xrmforge/cli
-
-Kommandozeilen-Interface basierend auf commander.js. Drei Befehle:
-- `xrmforge generate` - Orchestriert den TypeGenerationOrchestrator
-- `xrmforge build` - Delegiert an devkit build()
-- `xrmforge init` - Delegiert an devkit scaffoldProject()
-
-### @xrmforge/testing
-
-FormContext-Mocking für Unit-Tests:
-- `createFormMock<TForm>(values)` - Erstellt einen vollständigen Mock aus einfachen Schlüssel-Wert-Paaren
-- `MockAttribute` - getValue/setValue, Dirty-Tracking, onChange-Handler, Required Level, Submit Mode
-- `MockControl` - Sichtbar, Deaktiviert, Label, Benachrichtigungen
-- `MockUi` - Formular-Benachrichtigungen, Tab/Section-Stubs
-- `MockEntity` - Entitäts-ID, Name, Primärattribut
-- `fireOnChange(fieldName)` - Löst registrierte onChange-Handler aus
-- `setupXrmMock(options)` / `teardownXrmMock()` - Globaler Xrm-Mock mit WebApi/Navigation-Stubs
-
-### @xrmforge/helpers
-
-Bündelt allen browsersicheren Laufzeitcode. Keine Node.js-Abhängigkeiten. Enthält:
-- **Web-API-Helpers** - select(), parseLookup(), parseFormattedValue()
-- **Xrm-Konstanten** - DisplayState, SubmitMode, RequiredLevel, SaveMode, ClientType, ClientState, FormNotificationLevel, OperationType
-- **Action/Function-Executors** - createBoundAction(), executeRequest(), withProgress()
-- **typedForm()-Proxy** - Proxy-basierter FormContext-Wrapper, bei dem `form.name` an `getAttribute('name')` delegiert
-
-### @xrmforge/webapi
-
-Typsicherer Wrapper um Xrm.WebApi:
-- `retrieve<T>(entityName, id, query)` - Einzelner Datensatz
-- `retrieveMultiple<T>(entityName, query, options)` - Mit Paginierung (maxPages)
-- `create(entityName, data)` - Gibt Datensatz-ID zurück
-- `update(entityName, id, data)` - Void
-- `remove(entityName, id)` - Void
-- `QueryBuilder` - Fluent API: `.select().filter().orderBy().top().expand().build()`
-- `WebApiError` - Strukturierte Fehler mit statusCode, errorCode, innerMessage
-
-### @xrmforge/devkit
-
-Build-Orchestrierung und Projekt-Scaffolding:
-- `build(config)` - Parallele esbuild-IIFE-Builds über Promise.allSettled
-- `watch(config)` - esbuild-Watch-Modus mit Rebuild-Callbacks
-- `scaffoldProject(config)` - Generiert 11 Projektdateien aus Vorlagen
-- `validateBuildConfig(config)` / `resolveBuildConfig(config)` - Konfigurationsvalidierung
-- `BuildError` mit Codes: CONFIG_INVALID, ENTRY_NOT_FOUND, BUILD_FAILED, WATCH_ERROR
-- Vorlagensystem: 7 Textvorlagen in `src/scaffold/templates/`, geladen über `template-loader.ts`
-
-### @xrmforge/eslint-plugin
-
-5 Regeln für D365-Formularskripte (ESLint v9 Flat Config):
-- `no-xrm-page` (error) - Verbietet die veraltete Xrm.Page-API
-- `no-magic-optionset` (warn) - Verbietet Magic Numbers in OptionSet-Vergleichen
-- `no-sync-webapi` (error) - Verbietet synchrone XMLHttpRequest
-- `require-error-handling` (warn) - Verlangt try/catch in asynchronen on*-Event-Handlern
-- `require-namespace` (warn) - Verbietet window/globalThis-Zuweisungen
+# 2. Package-Architektur
+
+## 2.1 Package-Übersicht
+
+| Package | Version | Tests | Beschreibung |
+|---------|---------|-------|--------------|
+| @xrmforge/typegen | 0.8.0 | 444 | Kern: Typgenerierungs-Engine, Metadaten-Client, HTTP-Client, Hilfsfunktionen |
+| @xrmforge/cli | 0.4.2 | 10 | CLI: generate-, build-, init-Befehle |
+| @xrmforge/testing | 0.2.0 | 76 | Test-Hilfsmittel: createFormMock, fireOnChange, setupXrmMock |
+| @xrmforge/helpers | 0.1.0 | 59 | Browsersichere Laufzeit: select(), parseLookup(), typedForm(), Xrm-Konstanten, Action-Executors |
+| @xrmforge/webapi | 0.1.0 | 45 | Typsicherer Xrm.WebApi-Client mit QueryBuilder |
+| @xrmforge/devkit | 0.4.0 | 42 | Build-Orchestrierung, Scaffolding, AGENT.md-Generierung |
+| @xrmforge/eslint-plugin | 0.2.0 | 32 | 5 D365-spezifische ESLint-Regeln |
+
+**Gesamt:** 708 Tests über 7 Packages.
+
+## 2.2 Abhängigkeitsgraph
+
+```
+@xrmforge/cli
+  |-- @xrmforge/typegen (generate-Befehl)
+  |-- @xrmforge/devkit  (build- + init-Befehle)
+  '-- commander (CLI-Framework)
+
+@xrmforge/typegen
+  |-- @azure/identity  (Authentifizierung)
+  '-- fast-xml-parser  (FormXml-Parsing)
+
+@xrmforge/devkit
+  '-- esbuild (IIFE-Bundling)
+
+@xrmforge/testing     (keine Laufzeit-Abhängigkeiten)
+@xrmforge/helpers     (keine Laufzeit-Abhängigkeiten)
+@xrmforge/webapi      (keine Laufzeit-Abhängigkeiten)
+@xrmforge/eslint-plugin (ESLint Peer-Abhängigkeit)
+```
+
+## 2.3 Package-Details
+
+### @xrmforge/typegen
+
+Das Kern-Package. Enthält:
+
+- **TypeGenerationOrchestrator** - Koordiniert die gesamte Generierungs-Pipeline
+- **MetadataClient** - Fragt Dataverse-Metadaten ab (Entitäten, Formulare, OptionSets, Custom APIs)
+- **DataverseHttpClient** - Belastbarer REST-Client mit Retry, Rate Limiting, Nebenläufigkeitssteuerung
+- **ChangeDetector** - Inkrementelle Generierung über RetrieveMetadataChanges
+- **MetadataCache** - Dateisystem-basiertes Caching mit Versionsstempeln
+- **Generators** - Entitäts-Interfaces, Formular-Interfaces, OptionSet-Enums, Fields-Enums, EntityNames, Navigations-Properties, Action/Function-Executors
+- **Helpers** - select(), parseLookup(), parseFormattedValue() (verschoben nach @xrmforge/helpers)
+- **Xrm-Konstanten** - DisplayState, FormNotificationLevel, RequiredLevel, SubmitMode, SaveMode, ClientType, ClientState (verschoben nach @xrmforge/helpers)
+- **Authentifizierung** - createCredential()-Factory für 4 Authentifizierungsmethoden
+- **Logging** - Scope-basierte Logger mit austauschbaren Senken (Console, JSON, Silent)
+- **Fehler** - Strukturierte Fehlerhierarchie mit ErrorCode-Enum (AUTH_1xxx, API_2xxx, META_3xxx, GEN_4xxx, CONFIG_5xxx)
+
+### @xrmforge/cli
+
+Kommandozeilen-Interface basierend auf commander.js. Drei Befehle:
+- `xrmforge generate` - Orchestriert den TypeGenerationOrchestrator
+- `xrmforge build` - Delegiert an devkit build()
+- `xrmforge init` - Delegiert an devkit scaffoldProject()
+
+### @xrmforge/testing
+
+FormContext-Mocking für Unit-Tests:
+- `createFormMock<TForm>(values)` - Erstellt einen vollständigen Mock aus einfachen Schlüssel-Wert-Paaren
+- `MockAttribute` - getValue/setValue, Dirty-Tracking, onChange-Handler, Required Level, Submit Mode
+- `MockControl` - Sichtbar, Deaktiviert, Label, Benachrichtigungen
+- `MockUi` - Formular-Benachrichtigungen, Tab/Section-Stubs
+- `MockEntity` - Entitäts-ID, Name, Primärattribut
+- `fireOnChange(fieldName)` - Löst registrierte onChange-Handler aus
+- `setupXrmMock(options)` / `teardownXrmMock()` - Globaler Xrm-Mock mit WebApi/Navigation-Stubs
+
+### @xrmforge/helpers
+
+Bündelt allen browsersicheren Laufzeitcode. Keine Node.js-Abhängigkeiten. Enthält:
+- **Web-API-Helpers** - select(), parseLookup(), parseFormattedValue()
+- **Xrm-Konstanten** - DisplayState, SubmitMode, RequiredLevel, SaveMode, ClientType, ClientState, FormNotificationLevel, OperationType
+- **Action/Function-Executors** - createBoundAction(), executeRequest(), withProgress()
+- **typedForm()-Proxy** - Proxy-basierter FormContext-Wrapper, bei dem `form.name` an `getAttribute('name')` delegiert
+
+### @xrmforge/webapi
+
+Typsicherer Wrapper um Xrm.WebApi:
+- `retrieve<T>(entityName, id, query)` - Einzelner Datensatz
+- `retrieveMultiple<T>(entityName, query, options)` - Mit Paginierung (maxPages)
+- `create(entityName, data)` - Gibt Datensatz-ID zurück
+- `update(entityName, id, data)` - Void
+- `remove(entityName, id)` - Void
+- `QueryBuilder` - Fluent API: `.select().filter().orderBy().top().expand().build()`
+- `WebApiError` - Strukturierte Fehler mit statusCode, errorCode, innerMessage
+
+### @xrmforge/devkit
+
+Build-Orchestrierung und Projekt-Scaffolding:
+- `build(config)` - Parallele esbuild-IIFE-Builds über Promise.allSettled
+- `watch(config)` - esbuild-Watch-Modus mit Rebuild-Callbacks
+- `scaffoldProject(config)` - Generiert 11 Projektdateien aus Vorlagen
+- `validateBuildConfig(config)` / `resolveBuildConfig(config)` - Konfigurationsvalidierung
+- `BuildError` mit Codes: CONFIG_INVALID, ENTRY_NOT_FOUND, BUILD_FAILED, WATCH_ERROR
+- Vorlagensystem: 7 Textvorlagen in `src/scaffold/templates/`, geladen über `template-loader.ts`
+
+### @xrmforge/eslint-plugin
+
+5 Regeln für D365-Formularskripte (ESLint v9 Flat Config):
+- `no-xrm-page` (error) - Verbietet die veraltete Xrm.Page-API
+- `no-magic-optionset` (warn) - Verbietet Magic Numbers in OptionSet-Vergleichen
+- `no-sync-webapi` (error) - Verbietet synchrone XMLHttpRequest
+- `require-error-handling` (warn) - Verlangt try/catch in asynchronen on*-Event-Handlern
+- `require-namespace` (warn) - Verbietet window/globalThis-Zuweisungen

package/docs/architektur/03-generierte-typen.md

@@ -1,172 +1,172 @@
-# 3. Generierte Typen
-
-Die Ausführung von `xrmforge generate` erzeugt die folgenden TypeScript-ES-Module:
-
-## 3.1 Entitäts-Interfaces (`entities/{entity}.ts`)
-
-```typescript
-// generated/entities/account.ts
-/** Account | Konto */
-export interface Account {
-  /** Account Name | Kontoname */
-  name: string | null;
-  accountid: string | null;
-  revenue: number | null;
-  _parentaccountid_value: string | null;  // Lookup GUID
-  // ...
-}
-```
-
-**Typ-Zuordnung:** String/Memo/EntityName zu `string`, Integer/BigInt/Decimal/Double/Money zu `number`, Boolean zu `boolean`, DateTime/Uniqueidentifier/Lookup zu `string`, Picklist/State/Status zu `number`.
-
-## 3.2 Entity Fields Enums (`fields/{entity}.ts`)
-
-```typescript
-// generated/fields/account.ts
-export const enum AccountFields {
-  /** Account Name | Kontoname */
-  Name = 'name',
-  Telephone1 = 'telephone1',
-  Revenue = 'revenue',
-  // alle Entitätsattribute für $select-Abfragen
-}
-
-export const enum AccountNavigationProperties {
-  PrimaryContact = 'primarycontactid',
-  ContactCustomerAccounts = 'contact_customer_accounts',
-  // alle Lookup-Navigations-Properties
-}
-```
-
-Verwendet für Web API `$select`: `select(AccountFields.Name, AccountFields.Revenue)`.
-
-## 3.3 Navigations-Properties (`fields/{entity}.ts`)
-
-Navigations-Property-Enums befinden sich zusammen mit den Fields-Enums in derselben Datei (siehe 3.2 oben). Beispielverwendung:
-
-```typescript
-import { AccountNavigationProperties } from '../generated/fields/account';
-// verwendet für $expand-Abfragen
-```
-
-## 3.4 Formular-Interfaces (`forms/{entity}.ts`)
-
-```typescript
-// generated/forms/account.ts
-
-// Union-Typ, der gültige Feldnamen einschränkt
-export type AccountMainFormFields = 'name' | 'telephone1' | 'revenue';
-
-// Gemappter Typ: Feldname zu Xrm-Attributtyp
-export type AccountMainFormAttributeMap = {
-  name: Xrm.Attributes.StringAttribute;
-  telephone1: Xrm.Attributes.StringAttribute;
-  revenue: Xrm.Attributes.NumberAttribute;
-};
-
-// Gemappter Typ: Feldname zu Xrm-Steuerelementtyp
-export type AccountMainFormControlMap = {
-  name: Xrm.Controls.StringControl;
-  telephone1: Xrm.Controls.StringControl;
-  revenue: Xrm.Controls.NumberControl;
-};
-
-// Fields-Enum für Autovervollständigung
-export const enum AccountMainFormFieldsEnum {
-  /** Account Name | Kontoname */
-  AccountName = 'name',
-  Telephone1 = 'telephone1',
-  Revenue = 'revenue',
-}
-
-// Typsicherer FormContext mit überladenen getAttribute/getControl
-export interface AccountMainForm extends Omit<Xrm.FormContext, 'getAttribute' | 'getControl'> {
-  getAttribute<K extends AccountMainFormFields>(name: K): AccountMainFormAttributeMap[K];
-  getAttribute(index: number): Xrm.Attributes.Attribute;
-  getAttribute(): Xrm.Attributes.Attribute[];
-
-  getControl<K extends AccountMainFormFields>(name: K): AccountMainFormControlMap[K];
-  getControl(index: number): Xrm.Controls.Control;
-  getControl(): Xrm.Controls.Control[];
-}
-```
-
-**Spezielle Steuerelemente** werden anhand ihrer FormXml-ClassID typisiert:
-- Subgrid: `Xrm.Controls.GridControl`
-- Editierbares Grid: `Xrm.Controls.GridControl`
-- Quick View: `Xrm.Controls.QuickFormControl`
-- Web Resource / iFrame: `Xrm.Controls.IframeControl`
-
-## 3.5 Tabs/Sections/Subgrids/QuickViews Enums
-
-```typescript
-const enum AccountMainFormTabs { Summary = 'SUMMARY_TAB', Details = 'DETAILS_TAB' }
-const enum AccountMainFormSections { General = 'GENERAL', Address = 'ADDRESS' }
-const enum AccountMainFormSubgrids { Contacts = 'Contacts_Subgrid' }
-const enum AccountMainFormQuickViews { ContactPreview = 'ContactQuickView' }
-```
-
-## 3.6 OptionSet Enums (`optionsets/{entity}.ts`)
-
-```typescript
-// generated/optionsets/account.ts
-/** Account Category Code | Kontokategoriecode */
-export const enum AccountCategoryCode {
-  /** Preferred Customer | Bevorzugter Kunde */
-  PreferredCustomer = 1,
-  Standard = 2,
-}
-```
-
-Umfasst Picklist-, Status-, State- und MultiSelectPicklist-Attribute. Doppelte Labels werden mit dem Suffix `_{Value}` disambiguiert.
-
-## 3.7 EntityNames Enum (`entity-names.ts`)
-
-```typescript
-// generated/entity-names.ts
-export const enum EntityNames {
-  Account = 'account',
-  Contact = 'contact',
-  // alle Entitäten im Scope
-}
-```
-
-## 3.8 MockValues-Typen (in Formular-Interfaces)
-
-```typescript
-type AccountMainFormMockValues = {
-  name?: string | null;
-  telephone1?: string | null;
-  revenue?: number | null;
-};
-```
-
-Verwendet mit `createFormMock<AccountMainForm, AccountMainFormMockValues>({ name: 'Test' })`.
-
-## 3.9 Action/Function Executors (`actions/{entity|global}.ts`)
-
-```typescript
-// generated/actions/global.ts
-import { createUnboundAction } from '@xrmforge/helpers';
-
-export interface NormalizePhoneParams { Input: string; AllowSuspicious?: boolean; }
-export interface NormalizePhoneResult { Normalized: string; Status: number; }
-
-export const NormalizePhone = createUnboundAction<NormalizePhoneParams, NormalizePhoneResult>(
-  'markant_NormalizePhone',
-  { Input: { typeName: 'String', structuralProperty: 1 } }
-);
-// Verwendung: const result = await NormalizePhone.execute({ Input: '123' });
-```
-
-Factory-Funktionen: `createBoundAction`, `createUnboundAction`, `createBoundFunction`, `createUnboundFunction`. Batch-Ausführung über `executeMultiple()`, Fortschritts-UI über `withProgress()`.
-
-## 3.10 Zweisprachige Labels
-
-Alle generierten JSDoc-Kommentare unterstützen zweisprachige Labels:
-```typescript
-/** Account Name | Kontoname */
-Name = 'name',
-```
-
-Deutsche Umlaute werden in Bezeichnern transliteriert: ae, oe, ue, ss (z.B. "Übergeordnet" wird zu `Uebergeordnet`).
+# 3. Generierte Typen
+
+Die Ausführung von `xrmforge generate` erzeugt die folgenden TypeScript-ES-Module:
+
+## 3.1 Entitäts-Interfaces (`entities/{entity}.ts`)
+
+```typescript
+// generated/entities/account.ts
+/** Account | Konto */
+export interface Account {
+  /** Account Name | Kontoname */
+  name: string | null;
+  accountid: string | null;
+  revenue: number | null;
+  _parentaccountid_value: string | null;  // Lookup GUID
+  // ...
+}
+```
+
+**Typ-Zuordnung:** String/Memo/EntityName zu `string`, Integer/BigInt/Decimal/Double/Money zu `number`, Boolean zu `boolean`, DateTime/Uniqueidentifier/Lookup zu `string`, Picklist/State/Status zu `number`.
+
+## 3.2 Entity Fields Enums (`fields/{entity}.ts`)
+
+```typescript
+// generated/fields/account.ts
+export const enum AccountFields {
+  /** Account Name | Kontoname */
+  Name = 'name',
+  Telephone1 = 'telephone1',
+  Revenue = 'revenue',
+  // alle Entitätsattribute für $select-Abfragen
+}
+
+export const enum AccountNavigationProperties {
+  PrimaryContact = 'primarycontactid',
+  ContactCustomerAccounts = 'contact_customer_accounts',
+  // alle Lookup-Navigations-Properties
+}
+```
+
+Verwendet für Web API `$select`: `select(AccountFields.Name, AccountFields.Revenue)`.
+
+## 3.3 Navigations-Properties (`fields/{entity}.ts`)
+
+Navigations-Property-Enums befinden sich zusammen mit den Fields-Enums in derselben Datei (siehe 3.2 oben). Beispielverwendung:
+
+```typescript
+import { AccountNavigationProperties } from '../generated/fields/account';
+// verwendet für $expand-Abfragen
+```
+
+## 3.4 Formular-Interfaces (`forms/{entity}.ts`)
+
+```typescript
+// generated/forms/account.ts
+
+// Union-Typ, der gültige Feldnamen einschränkt
+export type AccountMainFormFields = 'name' | 'telephone1' | 'revenue';
+
+// Gemappter Typ: Feldname zu Xrm-Attributtyp
+export type AccountMainFormAttributeMap = {
+  name: Xrm.Attributes.StringAttribute;
+  telephone1: Xrm.Attributes.StringAttribute;
+  revenue: Xrm.Attributes.NumberAttribute;
+};
+
+// Gemappter Typ: Feldname zu Xrm-Steuerelementtyp
+export type AccountMainFormControlMap = {
+  name: Xrm.Controls.StringControl;
+  telephone1: Xrm.Controls.StringControl;
+  revenue: Xrm.Controls.NumberControl;
+};
+
+// Fields-Enum für Autovervollständigung
+export const enum AccountMainFormFieldsEnum {
+  /** Account Name | Kontoname */
+  AccountName = 'name',
+  Telephone1 = 'telephone1',
+  Revenue = 'revenue',
+}
+
+// Typsicherer FormContext mit überladenen getAttribute/getControl
+export interface AccountMainForm extends Omit<Xrm.FormContext, 'getAttribute' | 'getControl'> {
+  getAttribute<K extends AccountMainFormFields>(name: K): AccountMainFormAttributeMap[K];
+  getAttribute(index: number): Xrm.Attributes.Attribute;
+  getAttribute(): Xrm.Attributes.Attribute[];
+
+  getControl<K extends AccountMainFormFields>(name: K): AccountMainFormControlMap[K];
+  getControl(index: number): Xrm.Controls.Control;
+  getControl(): Xrm.Controls.Control[];
+}
+```
+
+**Spezielle Steuerelemente** werden anhand ihrer FormXml-ClassID typisiert:
+- Subgrid: `Xrm.Controls.GridControl`
+- Editierbares Grid: `Xrm.Controls.GridControl`
+- Quick View: `Xrm.Controls.QuickFormControl`
+- Web Resource / iFrame: `Xrm.Controls.IframeControl`
+
+## 3.5 Tabs/Sections/Subgrids/QuickViews Enums
+
+```typescript
+const enum AccountMainFormTabs { Summary = 'SUMMARY_TAB', Details = 'DETAILS_TAB' }
+const enum AccountMainFormSections { General = 'GENERAL', Address = 'ADDRESS' }
+const enum AccountMainFormSubgrids { Contacts = 'Contacts_Subgrid' }
+const enum AccountMainFormQuickViews { ContactPreview = 'ContactQuickView' }
+```
+
+## 3.6 OptionSet Enums (`optionsets/{entity}.ts`)
+
+```typescript
+// generated/optionsets/account.ts
+/** Account Category Code | Kontokategoriecode */
+export const enum AccountCategoryCode {
+  /** Preferred Customer | Bevorzugter Kunde */
+  PreferredCustomer = 1,
+  Standard = 2,
+}
+```
+
+Umfasst Picklist-, Status-, State- und MultiSelectPicklist-Attribute. Doppelte Labels werden mit dem Suffix `_{Value}` disambiguiert.
+
+## 3.7 EntityNames Enum (`entity-names.ts`)
+
+```typescript
+// generated/entity-names.ts
+export const enum EntityNames {
+  Account = 'account',
+  Contact = 'contact',
+  // alle Entitäten im Scope
+}
+```
+
+## 3.8 MockValues-Typen (in Formular-Interfaces)
+
+```typescript
+type AccountMainFormMockValues = {
+  name?: string | null;
+  telephone1?: string | null;
+  revenue?: number | null;
+};
+```
+
+Verwendet mit `createFormMock<AccountMainForm, AccountMainFormMockValues>({ name: 'Test' })`.
+
+## 3.9 Action/Function Executors (`actions/{entity|global}.ts`)
+
+```typescript
+// generated/actions/global.ts
+import { createUnboundAction } from '@xrmforge/helpers';
+
+export interface NormalizePhoneParams { Input: string; AllowSuspicious?: boolean; }
+export interface NormalizePhoneResult { Normalized: string; Status: number; }
+
+export const NormalizePhone = createUnboundAction<NormalizePhoneParams, NormalizePhoneResult>(
+  'markant_NormalizePhone',
+  { Input: { typeName: 'String', structuralProperty: 1 } }
+);
+// Verwendung: const result = await NormalizePhone.execute({ Input: '123' });
+```
+
+Factory-Funktionen: `createBoundAction`, `createUnboundAction`, `createBoundFunction`, `createUnboundFunction`. Batch-Ausführung über `executeMultiple()`, Fortschritts-UI über `withProgress()`.
+
+## 3.10 Zweisprachige Labels
+
+Alle generierten JSDoc-Kommentare unterstützen zweisprachige Labels:
+```typescript
+/** Account Name | Kontoname */
+Name = 'name',
+```
+
+Deutsche Umlaute werden in Bezeichnern transliteriert: ae, oe, ue, ss (z.B. "Übergeordnet" wird zu `Uebergeordnet`).