@xrmforge/typegen 0.8.4 → 0.8.5

package/docs/architektur/04-cli.md

@@ -1,58 +1,58 @@
-# 4. CLI-Befehle
-
-## 4.1 `xrmforge generate`
-
-Generiert TypeScript-Deklarationen aus einer Dataverse-Umgebung.
-
-| Flag | Typ | Standard | Beschreibung |
-|------|-----|----------|--------------|
-| `--url <url>` | string | erforderlich | Dataverse-Umgebungs-URL |
-| `--auth <method>` | string | erforderlich | Authentifizierungsmethode: client-credentials, interactive, device-code, token |
-| `--tenant-id <id>` | string | variiert | Azure AD Tenant-ID |
-| `--client-id <id>` | string | variiert | Azure AD Application-ID |
-| `--client-secret <s>` | string | variiert | Client Secret (nur client-credentials) |
-| `--token <token>` | string | variiert | Vorab erworbenes Bearer-Token (nur Token-Auth) |
-| `--entities <list>` | string | - | Kommagetrennte logische Entitätsnamen |
-| `--solutions <list>` | string | - | Kommagetrennte eindeutige Lösungsnamen |
-| `--output <dir>` | string | ./generated | Ausgabeverzeichnis |
-| `--label-language <n>` | string | 1033 | Primäre Label-Sprache (LCID) |
-| `--secondary-language <n>` | string | - | Sekundäre Label-Sprache für JSDoc |
-| `--no-forms` | flag | - | Formular-Interface-Generierung überspringen |
-| `--no-optionsets` | flag | - | OptionSet-Enum-Generierung überspringen |
-| `--actions` | flag | false | Custom-API-Executors generieren |
-| `--actions-filter <prefix>` | string | - | Custom APIs nach Uniquename-Präfix filtern |
-| `--cache` | flag | false | Metadaten-Caching für inkrementelle Generierung aktivieren |
-| `--no-cache` | flag | - | Vollständige Metadaten-Aktualisierung erzwingen |
-| `--cache-dir <dir>` | string | .xrmforge/cache | Cache-Verzeichnis |
-| `-v, --verbose` | flag | false | Debug-Logging |
-
-Mindestens eines von `--entities` oder `--solutions` ist erforderlich.
-
-## 4.2 `xrmforge build`
-
-Baut WebResources als IIFE-Bundles mit esbuild (über @xrmforge/devkit).
-
-| Flag | Typ | Standard | Beschreibung |
-|------|-----|----------|--------------|
-| `--watch` | flag | false | Watch-Modus mit inkrementellen Rebuilds |
-| `--minify` | flag | aus Konfiguration | Minifizierungseinstellung überschreiben |
-| `--no-sourcemap` | flag | - | Source Maps deaktivieren |
-| `--out-dir <dir>` | string | aus Konfiguration | Ausgabeverzeichnis überschreiben |
-| `-v, --verbose` | flag | false | Fehlerstacks anzeigen |
-
-Liest die Konfiguration aus `xrmforge.config.json`.
-
-## 4.3 `xrmforge init`
-
-Erstellt ein neues D365-Formularskript-Projekt.
-
-| Flag | Typ | Standard | Beschreibung |
-|------|-----|----------|--------------|
-| `[dir]` | positional | . | Zielverzeichnis |
-| `--name <name>` | string | Verzeichnisname | Projektname für package.json |
-| `--prefix <prefix>` | string | contoso | Publisher-Präfix |
-| `--namespace <ns>` | string | PascalCase(prefix) | Basis-Namespace für Skripte |
-| `--skip-install` | flag | false | npm install überspringen |
-| `--force` | flag | false | Nicht-leere Verzeichnisse erlauben |
-
-Generiert 11 Dateien: package.json, tsconfig.json, xrmforge.config.json, vitest.config.ts, .gitignore, AGENT.md, example-form.ts, example-form.test.ts, generated/.gitkeep, GitHub Actions CI, Azure DevOps Pipeline.
+# 4. CLI-Befehle
+
+## 4.1 `xrmforge generate`
+
+Generiert TypeScript-Deklarationen aus einer Dataverse-Umgebung.
+
+| Flag | Typ | Standard | Beschreibung |
+|------|-----|----------|--------------|
+| `--url <url>` | string | erforderlich | Dataverse-Umgebungs-URL |
+| `--auth <method>` | string | erforderlich | Authentifizierungsmethode: client-credentials, interactive, device-code, token |
+| `--tenant-id <id>` | string | variiert | Azure AD Tenant-ID |
+| `--client-id <id>` | string | variiert | Azure AD Application-ID |
+| `--client-secret <s>` | string | variiert | Client Secret (nur client-credentials) |
+| `--token <token>` | string | variiert | Vorab erworbenes Bearer-Token (nur Token-Auth) |
+| `--entities <list>` | string | - | Kommagetrennte logische Entitätsnamen |
+| `--solutions <list>` | string | - | Kommagetrennte eindeutige Lösungsnamen |
+| `--output <dir>` | string | ./generated | Ausgabeverzeichnis |
+| `--label-language <n>` | string | 1033 | Primäre Label-Sprache (LCID) |
+| `--secondary-language <n>` | string | - | Sekundäre Label-Sprache für JSDoc |
+| `--no-forms` | flag | - | Formular-Interface-Generierung überspringen |
+| `--no-optionsets` | flag | - | OptionSet-Enum-Generierung überspringen |
+| `--actions` | flag | false | Custom-API-Executors generieren |
+| `--actions-filter <prefix>` | string | - | Custom APIs nach Uniquename-Präfix filtern |
+| `--cache` | flag | false | Metadaten-Caching für inkrementelle Generierung aktivieren |
+| `--no-cache` | flag | - | Vollständige Metadaten-Aktualisierung erzwingen |
+| `--cache-dir <dir>` | string | .xrmforge/cache | Cache-Verzeichnis |
+| `-v, --verbose` | flag | false | Debug-Logging |
+
+Mindestens eines von `--entities` oder `--solutions` ist erforderlich.
+
+## 4.2 `xrmforge build`
+
+Baut WebResources als IIFE-Bundles mit esbuild (über @xrmforge/devkit).
+
+| Flag | Typ | Standard | Beschreibung |
+|------|-----|----------|--------------|
+| `--watch` | flag | false | Watch-Modus mit inkrementellen Rebuilds |
+| `--minify` | flag | aus Konfiguration | Minifizierungseinstellung überschreiben |
+| `--no-sourcemap` | flag | - | Source Maps deaktivieren |
+| `--out-dir <dir>` | string | aus Konfiguration | Ausgabeverzeichnis überschreiben |
+| `-v, --verbose` | flag | false | Fehlerstacks anzeigen |
+
+Liest die Konfiguration aus `xrmforge.config.json`.
+
+## 4.3 `xrmforge init`
+
+Erstellt ein neues D365-Formularskript-Projekt.
+
+| Flag | Typ | Standard | Beschreibung |
+|------|-----|----------|--------------|
+| `[dir]` | positional | . | Zielverzeichnis |
+| `--name <name>` | string | Verzeichnisname | Projektname für package.json |
+| `--prefix <prefix>` | string | contoso | Publisher-Präfix |
+| `--namespace <ns>` | string | PascalCase(prefix) | Basis-Namespace für Skripte |
+| `--skip-install` | flag | false | npm install überspringen |
+| `--force` | flag | false | Nicht-leere Verzeichnisse erlauben |
+
+Generiert 11 Dateien: package.json, tsconfig.json, xrmforge.config.json, vitest.config.ts, .gitignore, AGENT.md, example-form.ts, example-form.test.ts, generated/.gitkeep, GitHub Actions CI, Azure DevOps Pipeline.

package/docs/architektur/05-build.md

@@ -1,50 +1,50 @@
-# 5. Build-Architektur
-
-## 5.1 esbuild IIFE-Bundles
-
-XrmForge verwendet esbuild, um IIFE-Bundles (Immediately Invoked Function Expression) für Dynamics 365 zu erstellen. D365 erfordert, dass Skripte als namespace.function registriert werden (z.B. `Contoso.Account.onLoad`).
-
-**esbuild-Konfiguration pro Eintrag:**
-```
-format: 'iife'
-bundle: true
-globalName: entry.namespace    // z.B. 'Contoso.Account'
-target: config.target          // Standard: 'es2020'
-minify: config.minify
-sourcemap: config.sourcemap
-external: config.external      // z.B. ['fs', 'path'] für Node.js-Abhängigkeiten
-```
-
-Alle Einträge werden parallel mit `Promise.allSettled()` gebaut, was Teilerfolge ermöglicht.
-
-## 5.2 xrmforge.config.json Schema
-
-```json
-{
-  "build": {
-    "outDir": "./dist/prefix_/JS",
-    "target": "es2020",
-    "sourcemap": true,
-    "minify": true,
-    "external": [],
-    "entries": {
-      "entry_name": {
-        "input": "./src/forms/account-form.ts",
-        "namespace": "Contoso.Account",
-        "out": "Account/OnLoad.js"
-      }
-    }
-  }
-}
-```
-
-## 5.3 globalName-Behandlung
-
-esbuild erstellt automatisch verschachtelte Globals aus gepunkteten Namespaces:
-```javascript
-// namespace: "Contoso.Account" erzeugt:
-var Contoso = Contoso || {};
-Contoso.Account = (() => { return { onLoad, onSave }; })();
-```
-
-D365-Event-Registrierung: `Contoso.Account.onLoad`.
+# 5. Build-Architektur
+
+## 5.1 esbuild IIFE-Bundles
+
+XrmForge verwendet esbuild, um IIFE-Bundles (Immediately Invoked Function Expression) für Dynamics 365 zu erstellen. D365 erfordert, dass Skripte als namespace.function registriert werden (z.B. `Contoso.Account.onLoad`).
+
+**esbuild-Konfiguration pro Eintrag:**
+```
+format: 'iife'
+bundle: true
+globalName: entry.namespace    // z.B. 'Contoso.Account'
+target: config.target          // Standard: 'es2020'
+minify: config.minify
+sourcemap: config.sourcemap
+external: config.external      // z.B. ['fs', 'path'] für Node.js-Abhängigkeiten
+```
+
+Alle Einträge werden parallel mit `Promise.allSettled()` gebaut, was Teilerfolge ermöglicht.
+
+## 5.2 xrmforge.config.json Schema
+
+```json
+{
+  "build": {
+    "outDir": "./dist/prefix_/JS",
+    "target": "es2020",
+    "sourcemap": true,
+    "minify": true,
+    "external": [],
+    "entries": {
+      "entry_name": {
+        "input": "./src/forms/account-form.ts",
+        "namespace": "Contoso.Account",
+        "out": "Account/OnLoad.js"
+      }
+    }
+  }
+}
+```
+
+## 5.3 globalName-Behandlung
+
+esbuild erstellt automatisch verschachtelte Globals aus gepunkteten Namespaces:
+```javascript
+// namespace: "Contoso.Account" erzeugt:
+var Contoso = Contoso || {};
+Contoso.Account = (() => { return { onLoad, onSave }; })();
+```
+
+D365-Event-Registrierung: `Contoso.Account.onLoad`.

package/docs/architektur/06-inkrementell.md

@@ -1,42 +1,42 @@
-# 6. Inkrementelle Generierung
-
-## 6.1 Übersicht
-
-Die inkrementelle Generierung verwendet die Dataverse-Funktion `RetrieveMetadataChanges`, um zu erkennen, welche Entitäten sich seit der letzten Generierung geändert haben. Dies reduziert die Generierungszeit von Sekunden auf Millisekunden (gemessen: 4720ms auf 473ms, 10-fache Verbesserung).
-
-## 6.2 Komponenten
-
-**ChangeDetector** (`src/metadata/change-detector.ts`):
-- `getInitialVersionStamp()` - Erster Lauf: holt den initialen ServerVersionStamp
-- `detectChanges(clientVersionStamp)` - Folgeläufe: gibt changedEntityNames, deletedEntityNames, newVersionStamp zurück
-
-**MetadataCache** (`src/metadata/cache.ts`):
-- Dateisystem-basiert: `.xrmforge/cache/metadata.json`
-- Speichert: Manifest (Version, Umgebungs-URL, ServerVersionStamp, letzter Refresh, Entitätsliste) + entityTypeInfos pro Entität
-- Validierung: prüft Cache-Version, Umgebungs-URL-Übereinstimmung, Dateiexistenz
-
-## 6.3 Ablauf
-
-```
-Erster Lauf (kein Cache):
-  1. Alle Entitäts-Metadaten abrufen
-  2. getInitialVersionStamp()
-  3. Cache mit ServerVersionStamp speichern
-
-Folgelauf (Cache vorhanden):
-  1. Cache laden, Umgebungs-URL validieren
-  2. detectChanges(cachedVersionStamp)
-  3. Nur geänderte Entitäten abrufen
-  4. Gelöschte Entitäten aus Cache entfernen
-  5. Cache mit neuem ServerVersionStamp speichern
-
-Abgelaufener Stempel (>90 Tage):
-  Fehlercode 0x80044352 erkannt
-  Rückfall auf vollständigen Refresh
-```
-
-## 6.4 RetrieveMetadataChanges API
-
-- **Typ:** OData-Funktion (GET, nicht POST)
-- **URL:** `/RetrieveMetadataChanges(Query=@q,ClientVersionStamp=@s)?@q={...}&@s='...'`
-- **Antwort:** EntityMetadata[] mit HasChanged-Flag, ServerVersionStamp, DeletedMetadata
+# 6. Inkrementelle Generierung
+
+## 6.1 Übersicht
+
+Die inkrementelle Generierung verwendet die Dataverse-Funktion `RetrieveMetadataChanges`, um zu erkennen, welche Entitäten sich seit der letzten Generierung geändert haben. Dies reduziert die Generierungszeit von Sekunden auf Millisekunden (gemessen: 4720ms auf 473ms, 10-fache Verbesserung).
+
+## 6.2 Komponenten
+
+**ChangeDetector** (`src/metadata/change-detector.ts`):
+- `getInitialVersionStamp()` - Erster Lauf: holt den initialen ServerVersionStamp
+- `detectChanges(clientVersionStamp)` - Folgeläufe: gibt changedEntityNames, deletedEntityNames, newVersionStamp zurück
+
+**MetadataCache** (`src/metadata/cache.ts`):
+- Dateisystem-basiert: `.xrmforge/cache/metadata.json`
+- Speichert: Manifest (Version, Umgebungs-URL, ServerVersionStamp, letzter Refresh, Entitätsliste) + entityTypeInfos pro Entität
+- Validierung: prüft Cache-Version, Umgebungs-URL-Übereinstimmung, Dateiexistenz
+
+## 6.3 Ablauf
+
+```
+Erster Lauf (kein Cache):
+  1. Alle Entitäts-Metadaten abrufen
+  2. getInitialVersionStamp()
+  3. Cache mit ServerVersionStamp speichern
+
+Folgelauf (Cache vorhanden):
+  1. Cache laden, Umgebungs-URL validieren
+  2. detectChanges(cachedVersionStamp)
+  3. Nur geänderte Entitäten abrufen
+  4. Gelöschte Entitäten aus Cache entfernen
+  5. Cache mit neuem ServerVersionStamp speichern
+
+Abgelaufener Stempel (>90 Tage):
+  Fehlercode 0x80044352 erkannt
+  Rückfall auf vollständigen Refresh
+```
+
+## 6.4 RetrieveMetadataChanges API
+
+- **Typ:** OData-Funktion (GET, nicht POST)
+- **URL:** `/RetrieveMetadataChanges(Query=@q,ClientVersionStamp=@s)?@q={...}&@s='...'`
+- **Antwort:** EntityMetadata[] mit HasChanged-Flag, ServerVersionStamp, DeletedMetadata

package/docs/architektur/07-http-client.md

@@ -1,59 +1,59 @@
-# 7. HTTP-Client
-
-## 7.1 DataverseHttpClient
-
-Der zentrale HTTP-Client (`src/http/client.ts`) bietet belastbare Kommunikation mit der Dataverse Web API.
-
-**Kernmethoden:**
-- `get<T>(path, signal?)` - Einzelne GET-Anfrage mit Retry
-- `getAll<T>(path, signal?)` - GET mit automatischer @odata.nextLink-Paginierung (max 100 Seiten)
-
-## 7.2 Nur-Lesen-Standard
-
-Der Client ist standardmäßig auf `readOnly: true` eingestellt und blockiert POST/PATCH/PUT/DELETE-Anfragen. Dies verhindert versehentliche Datenänderungen während der Typgenerierung. Schreibzugriff erfordert explizites `readOnly: false`.
-
-## 7.3 Retry mit exponentiellem Backoff
-
-- **Basisverzögerung:** 1000ms (konfigurierbar)
-- **Maximaler Backoff:** 60 Sekunden
-- **Jitter:** Zufällige Verzögerung bis zur Basisverzögerung
-- **Formel:** `min(baseDelay * 2^(attempt-1) + jitter, 60000)`
-- **Maximale Retries:** konfigurierbar (Standard: 3)
-
-## 7.4 Rate Limiting (HTTP 429)
-
-- **Separater Zähler** von Standard-Retries (nicht vermischt)
-- **Retry-After-Header** wird respektiert (Sekunden in Millisekunden umgerechnet)
-- **Maximal 10 aufeinanderfolgende 429-Retries** (DEFAULT_MAX_RATE_LIMIT_RETRIES)
-- 429-Antworten inkrementieren den Standard-Retry-Zähler NICHT
-
-## 7.5 Nebenläufigkeitssteuerung
-
-Nicht-rekursives Semaphor-Muster:
-- **maxConcurrency:** 5 (Standard)
-- Warteschlange mit FIFO-Reihenfolge
-- Alle Retries erfolgen innerhalb eines einzelnen Slots (verhindert Slot-Erschöpfung)
-
-## 7.6 Token-Caching
-
-- Nur im Speicher (wird niemals auf die Festplatte persistiert)
-- 5-Minuten-Puffer vor Ablauf (TOKEN_BUFFER_MS = 300000)
-- Ausstehende Token-Refresh-Promise verhindert gleichzeitige Token-Anfragen
-
-## 7.7 Eingabe-Sanitisierung
-
-OData-Injection-Prävention:
-- `sanitizeIdentifier()` - Regex `[a-zA-Z_][a-zA-Z0-9_]*`
-- `sanitizeGuid()` - GUID-Format-Validierung
-- `escapeODataString()` - Verdopplung einfacher Anführungszeichen
-
-## 7.8 Fehlerbehandlung
-
-| HTTP-Status | Verhalten | Retry |
-|-------------|-----------|-------|
-| 2xx | Erfolg | Nein |
-| 401 | Token-Cache leeren, einmal wiederholen | Ja (1x) |
-| 429 | Retry-After respektieren, separater Zähler | Ja (bis zu 10x) |
-| 5xx | Exponentieller Backoff | Ja (bis zu maxRetries) |
-| 404, 403 | Nicht wiederholbar | Nein |
-| Netzwerkfehler | Exponentieller Backoff | Ja |
+# 7. HTTP-Client
+
+## 7.1 DataverseHttpClient
+
+Der zentrale HTTP-Client (`src/http/client.ts`) bietet belastbare Kommunikation mit der Dataverse Web API.
+
+**Kernmethoden:**
+- `get<T>(path, signal?)` - Einzelne GET-Anfrage mit Retry
+- `getAll<T>(path, signal?)` - GET mit automatischer @odata.nextLink-Paginierung (max 100 Seiten)
+
+## 7.2 Nur-Lesen-Standard
+
+Der Client ist standardmäßig auf `readOnly: true` eingestellt und blockiert POST/PATCH/PUT/DELETE-Anfragen. Dies verhindert versehentliche Datenänderungen während der Typgenerierung. Schreibzugriff erfordert explizites `readOnly: false`.
+
+## 7.3 Retry mit exponentiellem Backoff
+
+- **Basisverzögerung:** 1000ms (konfigurierbar)
+- **Maximaler Backoff:** 60 Sekunden
+- **Jitter:** Zufällige Verzögerung bis zur Basisverzögerung
+- **Formel:** `min(baseDelay * 2^(attempt-1) + jitter, 60000)`
+- **Maximale Retries:** konfigurierbar (Standard: 3)
+
+## 7.4 Rate Limiting (HTTP 429)
+
+- **Separater Zähler** von Standard-Retries (nicht vermischt)
+- **Retry-After-Header** wird respektiert (Sekunden in Millisekunden umgerechnet)
+- **Maximal 10 aufeinanderfolgende 429-Retries** (DEFAULT_MAX_RATE_LIMIT_RETRIES)
+- 429-Antworten inkrementieren den Standard-Retry-Zähler NICHT
+
+## 7.5 Nebenläufigkeitssteuerung
+
+Nicht-rekursives Semaphor-Muster:
+- **maxConcurrency:** 5 (Standard)
+- Warteschlange mit FIFO-Reihenfolge
+- Alle Retries erfolgen innerhalb eines einzelnen Slots (verhindert Slot-Erschöpfung)
+
+## 7.6 Token-Caching
+
+- Nur im Speicher (wird niemals auf die Festplatte persistiert)
+- 5-Minuten-Puffer vor Ablauf (TOKEN_BUFFER_MS = 300000)
+- Ausstehende Token-Refresh-Promise verhindert gleichzeitige Token-Anfragen
+
+## 7.7 Eingabe-Sanitisierung
+
+OData-Injection-Prävention:
+- `sanitizeIdentifier()` - Regex `[a-zA-Z_][a-zA-Z0-9_]*`
+- `sanitizeGuid()` - GUID-Format-Validierung
+- `escapeODataString()` - Verdopplung einfacher Anführungszeichen
+
+## 7.8 Fehlerbehandlung
+
+| HTTP-Status | Verhalten | Retry |
+|-------------|-----------|-------|
+| 2xx | Erfolg | Nein |
+| 401 | Token-Cache leeren, einmal wiederholen | Ja (1x) |
+| 429 | Retry-After respektieren, separater Zähler | Ja (bis zu 10x) |
+| 5xx | Exponentieller Backoff | Ja (bis zu maxRetries) |
+| 404, 403 | Nicht wiederholbar | Nein |
+| Netzwerkfehler | Exponentieller Backoff | Ja |

package/docs/architektur/08-authentifizierung.md

@@ -1,18 +1,18 @@
-# 8. Authentifizierung
-
-## 8.1 Credential Factory
-
-`createCredential(config: AuthConfig)` gibt ein `TokenCredential` (aus @azure/identity) basierend auf der Authentifizierungsmethode zurück:
-
-## 8.2 Vier Authentifizierungsabläufe
-
-| Methode | Konfiguration | @azure/identity-Klasse | Anwendungsfall |
-|---------|---------------|------------------------|----------------|
-| client-credentials | tenantId, clientId, clientSecret | ClientSecretCredential | CI/CD, automatisierte Pipelines |
-| interactive | tenantId, clientId? | InteractiveBrowserCredential | Entwickler-Arbeitsplatz |
-| device-code | tenantId, clientId? | DeviceCodeCredential | Headless-CLI-Umgebungen |
-| token | token (string) | StaticTokenCredential | Vorab erworbene Tokens (z.B. aus TokenVault) |
-
-## 8.3 Token-Scope
-
-Alle Authentifizierungsabläufe fordern den Scope an: `{environmentUrl}/.default`
+# 8. Authentifizierung
+
+## 8.1 Credential Factory
+
+`createCredential(config: AuthConfig)` gibt ein `TokenCredential` (aus @azure/identity) basierend auf der Authentifizierungsmethode zurück:
+
+## 8.2 Vier Authentifizierungsabläufe
+
+| Methode | Konfiguration | @azure/identity-Klasse | Anwendungsfall |
+|---------|---------------|------------------------|----------------|
+| client-credentials | tenantId, clientId, clientSecret | ClientSecretCredential | CI/CD, automatisierte Pipelines |
+| interactive | tenantId, clientId? | InteractiveBrowserCredential | Entwickler-Arbeitsplatz |
+| device-code | tenantId, clientId? | DeviceCodeCredential | Headless-CLI-Umgebungen |
+| token | token (string) | StaticTokenCredential | Vorab erworbene Tokens (z.B. aus TokenVault) |
+
+## 8.3 Token-Scope
+
+Alle Authentifizierungsabläufe fordern den Scope an: `{environmentUrl}/.default`

package/docs/architektur/09-testing.md

@@ -1,55 +1,55 @@
-# 9. Test-Framework
-
-## 9.1 createFormMock
-
-```typescript
-import { createFormMock } from '@xrmforge/testing';
-import type { AccountMainForm, AccountMainFormMockValues } from '../generated/forms/account';
-
-const mock = createFormMock<AccountMainForm, AccountMainFormMockValues>({
-  name: 'Contoso Ltd',
-  statuscode: 0,
-  revenue: 1000000,
-});
-
-// Verwendung in Tests:
-onLoad(mock.executionContext);
-expect(mock.formContext.getControl('revenue').getVisible()).toBe(true);
-```
-
-**Was gemockt wird:**
-- Attribute: MockAttribute-Instanzen mit getValue/setValue, Dirty-Tracking, onChange-Handlern, Required Level, Submit Mode
-- Steuerelemente: MockControl-Instanzen mit Sichtbarkeits-/Deaktiviert-/Label-/Benachrichtigungszustand
-- UI: Formular-Benachrichtigungen, Tab/Section-Stubs
-- Entität: ID, Entitätsname, Primärattribut
-- Daten: refresh(), save() Stubs, die Promise-ähnliches zurückgeben
-- Navigation: openForm/openAlertDialog Stubs
-
-**Lazy-Initialisierung:** Attribute, die über `getAttribute()` angesprochen werden und nicht in den initialen Werten enthalten waren, werden spontan mit null-Wert erstellt.
-
-## 9.2 fireOnChange
-
-```typescript
-mock.fireOnChange('statuscode');
-// Löst alle über getAttribute('statuscode').addOnChange(handler) registrierten Handler aus
-```
-
-Erstellt einen MockEventContext mit dem Attribut als Eventquelle.
-
-## 9.3 setupXrmMock / teardownXrmMock
-
-```typescript
-import { setupXrmMock, teardownXrmMock } from '@xrmforge/testing';
-
-beforeEach(() => setupXrmMock());
-afterEach(() => teardownXrmMock());
-
-// Mit WebApi-Überschreibungen:
-setupXrmMock({
-  webApiOverrides: {
-    retrieveMultipleRecords: async () => ({ entities: [{ name: 'Test' }] }),
-  },
-});
-```
-
-Richtet ein globales `Xrm`-Objekt auf `globalThis` ein mit minimalen WebApi-, Navigation- und Utility-Stubs.
+# 9. Test-Framework
+
+## 9.1 createFormMock
+
+```typescript
+import { createFormMock } from '@xrmforge/testing';
+import type { AccountMainForm, AccountMainFormMockValues } from '../generated/forms/account';
+
+const mock = createFormMock<AccountMainForm, AccountMainFormMockValues>({
+  name: 'Contoso Ltd',
+  statuscode: 0,
+  revenue: 1000000,
+});
+
+// Verwendung in Tests:
+onLoad(mock.executionContext);
+expect(mock.formContext.getControl('revenue').getVisible()).toBe(true);
+```
+
+**Was gemockt wird:**
+- Attribute: MockAttribute-Instanzen mit getValue/setValue, Dirty-Tracking, onChange-Handlern, Required Level, Submit Mode
+- Steuerelemente: MockControl-Instanzen mit Sichtbarkeits-/Deaktiviert-/Label-/Benachrichtigungszustand
+- UI: Formular-Benachrichtigungen, Tab/Section-Stubs
+- Entität: ID, Entitätsname, Primärattribut
+- Daten: refresh(), save() Stubs, die Promise-ähnliches zurückgeben
+- Navigation: openForm/openAlertDialog Stubs
+
+**Lazy-Initialisierung:** Attribute, die über `getAttribute()` angesprochen werden und nicht in den initialen Werten enthalten waren, werden spontan mit null-Wert erstellt.
+
+## 9.2 fireOnChange
+
+```typescript
+mock.fireOnChange('statuscode');
+// Löst alle über getAttribute('statuscode').addOnChange(handler) registrierten Handler aus
+```
+
+Erstellt einen MockEventContext mit dem Attribut als Eventquelle.
+
+## 9.3 setupXrmMock / teardownXrmMock
+
+```typescript
+import { setupXrmMock, teardownXrmMock } from '@xrmforge/testing';
+
+beforeEach(() => setupXrmMock());
+afterEach(() => teardownXrmMock());
+
+// Mit WebApi-Überschreibungen:
+setupXrmMock({
+  webApiOverrides: {
+    retrieveMultipleRecords: async () => ({ entities: [{ name: 'Test' }] }),
+  },
+});
+```
+
+Richtet ein globales `Xrm`-Objekt auf `globalThis` ein mit minimalen WebApi-, Navigation- und Utility-Stubs.