@xiriframework/xiri-ng 0.4.13 → 0.4.15

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xiriframework/xiri-ng",
-  "version": "0.4.13",
+  "version": "0.4.15",
   "description": "Angular UI component library for the Xiri Framework",
   "license": "Apache-2.0",
   "repository": {

package/skills/xiri-ng-expert/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: xiri-ng-expert
-description: Experte für die xiri-ng Angular-Library. Verwende diesen Skill IMMER wenn Angular-Code geschrieben wird der @xiriframework/xiri-ng importiert, oder wenn der User nach xiri-Komponenten (xiri-dyncomponent, xiri-form-fields, xiri-table, xiri-card usw.), XiriDataService, XiriSnackbarService, provideXiriServices, Form-Feldern mit showWhen-Bedingungen oder reloadOn-Abhängigkeiten (Optionen vom Server nachladen), addUrl („+“-Button legt neue Option per Dialog an), oder Server-Side-Tables fragt.
+description: Experte für die xiri-ng Angular-Library. Verwende diesen Skill IMMER wenn Angular-Code geschrieben wird der @xiriframework/xiri-ng importiert, oder wenn der User nach xiri-Komponenten (xiri-dyncomponent, xiri-form-fields, xiri-table, xiri-card usw.), XiriDataService, XiriSnackbarService, provideXiriServices, Form-Feldern mit showWhen-Bedingungen, reloadOn-Abhängigkeiten oder Textfeld-Vorschlägen (Autocomplete mit Freitext: list/url/searchWith) (Optionen vom Server nachladen), addUrl („+“-Button legt neue Option per Dialog an), oder Server-Side-Tables fragt.
 ---
 
 # xiri-ng Expert
@@ -133,6 +133,7 @@ Verfügbare `type`-Werte: `text`, `email`, `password`, `textarea`, `number`, `bo
 `display` = `'full' | 'line' | 'small'` — Layout-Modus.
 
 **showWhen-Operators:** `equals`, `notEquals`, `contains`, `greaterThan`, `lessThan`, `in`, `notEmpty`.
+Versteckte Felder sind disabled: kein Wert im Submit, keine Validierung (ab 0.4.14; Details `references/form-fields.md`).
 
 **reloadOn — Inhalt vom Server nachladen.** Während `showWhen` ein Feld nur ein- und ausblendet,
 lädt `reloadOn` seinen Inhalt neu, sobald sich ein anderes Feld ändert:
@@ -146,13 +147,30 @@ Beides ist Pflicht. Die Komponente postet **nur die Trigger-Werte** (`{departmen
 entprellt, ein Request pro URL, `switchMap`) und erwartet
 `{ "fields": { "team": { "list": [...], "required": true } } }`. Ein Reload läuft zusätzlich immer
 einmal direkt nach dem Aufbau der Controls. Werte, die die neue `list` noch anbietet, bleiben
-erhalten (rekursiv über `children`), der Rest wird verworfen — außer bei `chips` und Selects mit
-`url`, deren Liste nur ein Vorschlag bzw. der statische Sockel ist.
+erhalten (rekursiv über `children`), der Rest wird verworfen — außer bei `chips`, `text` (Liste sind
+nur Vorschläge) und Selects mit `url`, deren Liste der statische Sockel ist.
 
 Patchbar sind `list`, `name`, `hint`, `class`, `required`, `disabled`, `hide`, `search`, `min`,
-`max`, `params` — jeweils nur mit passendem Typ. `value`, `type`, `id` und `url` bewusst nicht.
+`max`, `params` — jeweils nur mit passendem Typ. `value`, `type`, `id`, `url` und `searchWith` bewusst nicht.
 Details und Grenzen in `references/form-fields.md`.
 
+**Vorschläge am Textfeld (mat-autocomplete, Freitext bleibt).** Ein `text`-Feld mit `list` und/oder
+`url` zeigt beim Tippen ein Vorschlags-Panel; eingetippt werden darf trotzdem alles:
+
+```typescript
+{ id: 'city', type: 'text', name: 'Stadt',
+  list: [ { id: 'Wien', name: 'Wien' }, { id: 'Graz', name: 'Graz' } ],   // lokal gefiltert
+  url: 'City/Suggest', searchWith: [ 'country' ] }                           // beim Tippen nachladen
+```
+
+`list` wird lokal gefiltert (`id === name`), `url` wird 200 ms entprellt per
+`POST { search: 'gr', country: 3 }` gefragt — `searchWith` nennt Feld-IDs derselben Form, deren
+aktueller Wert mitgeht (nur enabled Felder) — und erwartet `[{ id, name }]`; eingesetzt wird `name`,
+Servertreffer hängen hinter den lokalen. Enter/Blur übernehmen nie automatisch, ein `reloadOn`-Patch
+der `list` löscht den Text nicht. Kommen die Vorschläge erst per Reload, initial `list: []` setzen,
+sonst rendert die Komponente ein normales Textfeld und tauscht das Input beim Patch aus. Go:
+`field.NewTextField(...).SetSuggestions(...)` / `.SetSuggestionsURL(u, ids...)` + `builder.BindSuggest`.
+
 **addUrl — neue Option per Dialog anlegen.** `select`, `multiselect`/`treeselect`, `object`/`model`
 und `chips` bekommen mit `addUrl` einen „+“-Button neben dem Feld:
 
@@ -189,6 +207,9 @@ submit() {
 
 Lädt Felder + Buttons vom Backend, submit → POST → response-handler navigiert/refresht.
 
+Fehler: ein 400 mit `{error, fields?: {id: message}}` (xiri-go `response.NewErrorResponseFromError`) zeigt jede
+Feldmeldung als `mat-error` am Feld, der Banner bleibt leer; ohne `fields` erscheint `error` als Banner (`xiri-error`).
+
 ## xiri-table — volle Datentabelle
 
 ```html
@@ -462,5 +483,8 @@ edit(row: any) {
 - Nicht `reloadOn` ohne `reloadUrl` (oder umgekehrt) — eine halbe Deklaration wird ignoriert
 - Nicht `url` **und** `reloadOn` auf demselben treeselect — mit `url` lädt es seinen Baum selbst
   per GET und ignoriert die gepatchte `list`
+- Kein `select` oder `chips`, wenn der Wert frei getippt werden darf und die Liste nur hilft —
+  `type: 'text'` mit `list` und/oder `url` (+ `searchWith`). Ein normales Textfeld ohne beides bleibt
+  ohne Autocomplete-Trigger; Vorschläge, die erst per `reloadOn` kommen, brauchen initial `list: []`
 - Keinen eigenen „Neu anlegen“-Button neben ein Select bauen — `addUrl` am Feld, der Dialog-POST
   antwortet mit `created: { id, name }`

package/skills/xiri-ng-expert/references/components.md

@@ -20,6 +20,11 @@ interface XiriFormSettings {
 
 Outputs: keine.
 
+Fehlerantworten (HTTP 400/403/404/0) landen als `XiriFormServiceError { error: string; fields?: Record<string, string> }`
+im Formular: `fields` (xiri-go `response.NewErrorResponseFromError`, Feld-ID → Meldung) gehen als `serverErrors` an
+`xiri-form-fields` und erscheinen als `mat-error` am Feld, der Fehler-Banner bleibt dann leer. Ohne `fields` steht `error`
+im Banner (`xiri-error`). Signals: `fieldErrors()`, `error()`.
+
 ### xiri-dialog (via MatDialog)
 
 ```typescript

package/skills/xiri-ng-expert/references/dyncomponent.md

@@ -31,19 +31,19 @@ export interface XiriDynData {
   mode?: string;                          // Nur für 'barchart': 'simple' | 'stacked' | 'heatmap'
 }
 
-export type XiriDynDataType =
-  | 'card' | 'buttonline' | 'table' | 'cardlink' | 'links'
-  | 'form' | 'query' | 'stepper' | 'header' | 'list'
-  | 'spacer' | 'container'
-  | 'infopoint' | 'multiprogress' | 'imagetext'
-  | 'tabs' | 'expansion' | 'infotext' | 'html'
-  | 'stat' | 'empty-state' | 'timeline'
-  | 'page-header' | 'section' | 'divider'
-  | 'stat-grid' | 'toolbar' | 'description-list'
-  | 'barchart' | 'linechart' | 'piechart' | 'gaugechart'
-  | 'heatmap' | 'calendar' | 'tree' | 'sankey' | 'gantt';
+// Einzige Quelle aller type-Werte; die Union wird daraus abgeleitet.
+export const XIRI_COMPONENT_TYPES = ['card', 'buttonline', 'table', 'cardlink', /* … */ 'status', 'callout'] as const;
+export type XiriDynDataType = typeof XIRI_COMPONENT_TYPES[number];
+
+// Maschinenlesbarer Katalog (Name, Kategorie, Demo-Route, goBuilder, Keywords) je Typ.
+export const COMPONENT_CATALOG: readonly XiriCatalogEntry[];
 ```
 
+`XIRI_COMPONENT_TYPES`, `COMPONENT_CATALOG` und `XiriCatalogEntry` sind exportiert. Der Katalog ist
+maschinenlesbar: Agenten und Tools können ihn importieren, um zu erfahren, welche `type`-Werte der
+Renderer kennt und welche davon xiri-go ausgibt (`goBuilder`; Gegenstück `core.ComponentTypes()`).
+`catalog-parity.spec.ts` prüft Renderer-`@case`, Vertrag und Katalog gegeneinander.
+
 ## Mapping type → Komponente
 
 | `type`              | Rendered Component     | `data` = Settings-Interface          |

package/skills/xiri-ng-expert/references/form-fields.md

@@ -15,8 +15,14 @@ Renderer für `XiriFormField[]`. Baut intern eine `UntypedFormGroup` mit Reactiv
 @input display: XiriFormFieldDisplay = 'full'       // 'full' | 'line' | 'small'
 @input disabled: boolean = false
 @input check: Observable<void> = null                // Trigger für Revalidierung
+@input serverErrors: Record<string, string> | null = null // Validierungsfehler pro Feld-ID vom Server
 ```
 
+`serverErrors` trägt die `fields` einer 400-Antwort (xiri-go `response.NewErrorResponseFromError`,
+`{id: message}`). Jede Meldung erscheint als `mat-error` am Feld und verschwindet bei der nächsten
+Eingabe; unbekannte IDs werden ignoriert. `xiri-form` setzt den Input automatisch aus
+`XiriFormServiceError.fields` und lässt den Fehler-Banner dann leer.
+
 ### Outputs
 
 ```typescript
@@ -80,7 +86,7 @@ export interface XiriFormField {
   // --- State ---
   hide?: boolean;
   required?: boolean;
-  disabled?: boolean;        // greift beim Aufbau nur bei den zusammengesetzten Feldtypen, s.u.
+  disabled?: boolean;        // Control beim Aufbau disabled, Feld fällt aus formGroup.value (s.u.)
   collapsible?: boolean;     // header
   collapsed?: boolean;       // header initial
 
@@ -109,6 +115,10 @@ export interface XiriFormField {
   // --- Conditional Display ---
   showWhen?: XiriFormFieldCondition | XiriFormFieldCondition[];
 
+  // --- Text: Vorschläge (mat-autocomplete, Freitext bleibt) ---
+  // list (id === name) lokal gefiltert; url beim Tippen: POST {search, <searchWith-Felder>} -> [{id, name}]
+  searchWith?: string[];     // Feld-IDs derselben Form, deren aktueller (enabled) Wert mitgeht
+
   // --- Server-driven content ---
   reloadOn?: string[];       // Feld-IDs, deren Änderung dieses Feld neu lädt
   reloadUrl?: string;        // Endpoint für den Reload (beides oder keins)
@@ -122,22 +132,25 @@ export interface XiriFormField {
 }
 ```
 
-**`disabled` beim Aufbau.** Das Feld deaktiviert beim Formularaufbau **nicht** das äußere
-FormControl — `createControl()` legt es immer `enabled` an. Ausgewertet wird es nur von den
-zusammengesetzten Feldtypen (`date`, `daterange`, `datetimerange`, `yearmonth`, `treeselect`,
-`volume`, `file`), die es in ihrem eigenen `field`-Setter lesen. Bei `text`, `number`, `textarea`,
-`select`, `multiselect` und `bool` bleibt es beim Aufbau wirkungslos, weil das Template
-`field.disabled` nicht auswertet.
+**`disabled` (ab 0.4.14).** Ein Feld mit `disabled: true` bekommt beim Aufbau ein **disabled FormControl** —
+bei allen Feldtypen, auch `text`, `select`, `bool`, `timelimit`. Es fällt damit aus `formGroup.value`
+(kein Wert im Submit-Body) und aus der Validierung; xiri-go bindet für den Key ohnehin nie den
+Request-Wert, sondern den Default. `formGroup.get(id).disable()` von außen, das `disabled`-Input der
+ganzen `xiri-form-fields` und ein `disabled` aus einem `reloadOn`-Patch verhalten sich gleich. Wer einen
+Server-Wert nur anzeigen will, nimmt ein `info`-Feld.
 
-Was zuverlässig wirkt: `formGroup.get(id).disable()` von außen (seit 0.4.4 auf allen Feldtypen),
-der `disabled`-Input der ganzen `xiri-form-fields`, und ein `disabled` aus einem `reloadOn`-Patch —
-letzterer geht über das FormControl, das Feld fällt dann also auch aus `formGroup.value`.
+Eine bewusste Ausnahme vom „kein Wert“: **Reload-Trigger** gehen über `getRawValue()`, ein disabled
+Trigger-Feld steuert also weiterhin abhängige Listen. Eine FormGroup, deren Controls **alle** disabled sind
+(nur gesperrte Felder, oder gesperrte plus per `showWhen` versteckte), ist bei Angular `DISABLED` statt `VALID`
+(`valid === false`, `invalid === false`) und liefert alle Werte als Rohwert; `xiri-form`, `xiri-dialog`,
+`xiri-query` und `xiri-stepper` normalisieren das über `formState()` zu gültig mit Payload `{}` — ein
+Anzeige-Formular bleibt absendbar, und versteckte Werte gehen nie zum Server (der `showWhen` nicht kennt).
 
 ### Feld-Typen
 
 | `type`          | Rendered als                                      | Wichtige Properties                |
 | --------------- | ------------------------------------------------- | ---------------------------------- |
-| `text`          | Mat-Input                                         | `subtype` (email/url), `pattern`   |
+| `text`         | Mat-Input, mit `list`/`url` plus mat-autocomplete | `subtype` (email/url), `pattern`, `list`, `url`, `searchWith` (Vorschläge) |
 | `email`         | Mat-Input type=email                              |                                    |
 | `password`      | Mat-Input type=password                           | `pwdhide`                          |
 | `textarea`      | Mat-Textarea                                      | `rows`                             |
@@ -232,6 +245,44 @@ Array = **UND**-Verknüpfung:
   ]}
 ```
 
+**Laufzeitverhalten (ab 0.4.14):** Ein per `showWhen` verstecktes Feld wird im FormGroup **disabled**.
+Es fehlt damit in `formGroup.value` und im Submit-Body, und seine Validatoren zählen nicht — ein
+verstecktes Pflichtfeld blockiert den Submit nicht. Wird es wieder sichtbar, wird es enabled und
+behält seinen letzten Wert; ein vom Backend gesetztes `disabled: true` oder das globale
+`disabled`-Input bleiben dabei bestehen. Felder in **eingeklappten Sections** gelten nicht als
+versteckt und bleiben enabled. Bedingungen lesen `control.value` direkt, ein disabled Trigger-Feld
+funktioniert also weiterhin als Trigger. Server-seitig bindet xiri-go für den fehlenden Key den
+Konstruktor-Default.
+
+### Vorschläge am Textfeld — `list`, `url`, `searchWith`
+
+Ein `text`-Feld mit `list` und/oder `url` bekommt ein `mat-autocomplete`-Panel (`XiriSuggestDirective`,
+exportiert). Der Wert bleibt ein freier String — die Directive schreibt nie ins Control, eine Auswahl
+setzt `name` ein.
+
+```typescript
+{ id: 'city', type: 'text', name: 'Stadt',
+  list: [ { id: 'Wien', name: 'Wien' }, { id: 'Graz', name: 'Graz' } ],
+  url: 'City/Suggest', searchWith: [ 'country' ] }
+```
+
+- `list` wird lokal case-insensitiv nach `name` gefiltert und ist per `reloadOn` patchbar; der Patch
+  erreicht das offene Panel sofort und löscht den getippten Text nicht.
+- `url`: 200 ms nach der letzten Eingabe `POST url { ...kontext, search }`; eine neue Eingabe bricht
+  Timer und laufenden Request ab, alte Antworten landen nie. Leere Eingabe fragt nicht an. Antwort
+  `[{ id, name }]`, Elemente ohne String-`name` werden verworfen, Treffer hängen hinter den lokalen,
+  Duplikate (nach `name`) fallen weg. Fokus allein löst keine Suche aus.
+- `searchWith`: Feld-IDs derselben Form (flache Schlüssel); mitgeschickt wird der Wert zur Request-Zeit,
+  nur von enabled Controls. `search` ist reserviert. Nicht patchbar (wie `url`).
+- Ohne `list`/`url` bleibt das Textfeld unverändert (DefaultValueAccessor, kein Autocomplete-Trigger).
+  Deshalb: kommen die Vorschläge erst per `reloadOn`, initial `list: []` liefern — sonst wechselt beim
+  Patch der Template-Zweig und das fokussierte Input wird ersetzt.
+- Enter/Blur übernehmen nie automatisch einen Vorschlag (`requireSelection`, `autoActiveFirstOption`,
+  `autoSelectActiveOption` sind explizit `false`, unabhängig von `MAT_AUTOCOMPLETE_DEFAULT_OPTIONS`).
+  Ist das Control disabled, sind die Optionen disabled.
+- Go: `field.NewTextField(...).SetSuggestions("Wien", "Graz")`, `.SetSuggestionsURL(u, "country")`,
+  Handler `builder.BindSuggest(c, country)` (siehe xiri-go-expert).
+
 ### reloadOn — Inhalt vom Server nachladen
 
 `showWhen` blendet ein Feld ein und aus. `reloadOn` lädt seinen **Inhalt** neu, sobald sich ein
@@ -270,7 +321,7 @@ Nach einem `list`-Patch behält das Feld alle Werte, die die neue Liste noch anb
 (rekursiv über `children`), und verwirft die übrigen. Ein `value` im Patch wird ignoriert — der
 Wert gehört dem Client.
 
-Nicht geprunt wird, wo die Liste nicht autoritativ ist: bei `chips` (nur Vorschläge) und bei
+Nicht geprunt wird, wo die Liste nicht autoritativ ist: bei `chips` und `text` (nur Vorschläge) und bei
 Selects mit `url` (dort ist `list` nur der statische Sockel der Server-Suche).
 
 **Patchbare Properties**

package/skills/xiri-ng-expert/references/table.md

@@ -201,6 +201,8 @@ export interface XiriTableField {
 
   buttons?: XiriButton[];       // Action-Buttons in der Zelle
   icons?: { icon: string; color?: string; hint?: string }[];
+                                // format 'icon': row[id] wählt das Icon; row[id + 'Hint'] (xiri-go
+                                // WithRowHint) überschreibt ab 0.4.14 den Icon-hint als Tooltip pro Zeile
 
   display?: string;             // CSS-Klasse auf <td>
   header?: string;              // Custom Header-Text (falls ≠ name)
@@ -385,6 +387,7 @@ tableSettings: XiriTableSettings = {
         { icon: 'check_circle', color: 'success', hint: 'Aktiv' },
         { icon: 'cancel',       color: 'warn',    hint: 'Inaktiv' },
       ]},
+    // Row mit { status: 0, statusHint: 'Aktiv seit 08:12' } zeigt den Row-Hint statt 'Aktiv'
     { id: 'count',  name: 'Anzahl', format: 'number',
       webformat: 'integer', align: 'right', footer: 'sum' },
     { id: 'note',   name: 'Notiz', editable: true, inputType: 'text' },

package/types/xiriframework-xiri-ng.d.ts

@@ -108,6 +108,7 @@ interface XiriFormField {
     url?: string;
     search?: boolean;
     serverSideSearch?: boolean;
+    searchWith?: string[];
     params?: Record<string, unknown>;
     rows?: number;
     accept?: string;
@@ -141,6 +142,7 @@ declare class XiriFormFieldsComponent implements OnInit {
     disabled: _angular_core.InputSignal<boolean>;
     formChange: _angular_core.OutputEmitterRef<UntypedFormGroup>;
     check: _angular_core.InputSignal<Observable<void> | null>;
+    serverErrors: _angular_core.InputSignal<Record<string, string> | null>;
     formGroup: UntypedFormGroup;
     private lastValue;
     private _fields;
@@ -163,6 +165,7 @@ declare class XiriFormFieldsComponent implements OnInit {
     private fetchPatches;
     protected openAdd(id: string): void;
     private addOption;
+    private applyServerError;
     private applyPatch;
     private pruneValue;
     fields: _angular_core.Signal<XiriFormField[] | null>;
@@ -170,12 +173,14 @@ declare class XiriFormFieldsComponent implements OnInit {
     private bindValidations;
     private validateAllFormFields;
     isFieldVisible(field: XiriFormField): boolean;
+    private matchesShowWhen;
+    private syncConditionalControls;
     toggleSection(header: XiriFormField): void;
     isSectionCollapsed(headerId: string): boolean;
     private isInCollapsedSection;
     private evaluateCondition;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<XiriFormFieldsComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<XiriFormFieldsComponent, "xiri-form-fields", never, { "form": { "alias": "form"; "required": false; "isSignal": true; }; "display": { "alias": "display"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "check": { "alias": "check"; "required": false; "isSignal": true; }; }, { "formChange": "formChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<XiriFormFieldsComponent, "xiri-form-fields", never, { "form": { "alias": "form"; "required": false; "isSignal": true; }; "display": { "alias": "display"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "check": { "alias": "check"; "required": false; "isSignal": true; }; "serverErrors": { "alias": "serverErrors"; "required": false; "isSignal": true; }; }, { "formChange": "formChange"; }, never, never, true, never>;
 }
 
 type XiriSelectPredicate = (filter: string, element: XiriFormFieldSelectOption) => boolean;
@@ -221,6 +226,37 @@ declare class XiriSelectDirective implements OnInit, OnDestroy {
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<XiriSelectDirective, "[xiriSelect]", ["xiriSelect"], { "predicate": { "alias": "predicate"; "required": false; "isSignal": true; }; "compare": { "alias": "compare"; "required": false; "isSignal": true; }; "serverSideSearch": { "alias": "serverSideSearch"; "required": false; "isSignal": true; }; "serverUrl": { "alias": "serverUrl"; "required": false; "isSignal": true; }; "serverParams": { "alias": "serverParams"; "required": false; "isSignal": true; }; "values": { "alias": "values"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/**
+ * Vorschläge für ein Textfeld (mat-autocomplete): `field.list` wird lokal gefiltert, bei `field.url`
+ * wird beim Tippen nachgeladen (POST {search, <searchWith-Felder>} -> [{id, name}]). Freie Eingabe
+ * bleibt immer erlaubt - die Directive schreibt nie ins Control, sie liefert nur `options()`.
+ *
+ * Bewusst über DOM-Events statt control.valueChanges: form-fields tauscht Controls bei Formular-
+ * ersetzung aus, die Directive überlebt dank `track field.id` - ein gegriffenes Control wäre alt.
+ */
+declare class XiriSuggestDirective {
+    field: _angular_core.InputSignal<XiriFormField>;
+    private search;
+    private remote;
+    /** Jeder next() startet die Remote-Kette neu und bricht die vorige ab. */
+    private typed$;
+    private dataService;
+    /** Das formGroup von form-fields; optional, damit die Directive auch an einem nackten Input läuft. */
+    private formGroupDir;
+    /** Was das Panel zeigt: lokale Treffer, dann Servertreffer, nach name dedupliziert. */
+    options: _angular_core.Signal<XiriFormFieldSelectOption[]>;
+    constructor();
+    onInput(event: Event): void;
+    /** Fokus richtet den lokalen Filter am sichtbaren Wert aus und verwirft bei geändertem Wert alte
+     *  Servertreffer - ohne Request: form-fields fokussiert auch programmatisch. */
+    onFocus(event: Event): void;
+    private reset;
+    /** Aktuelle Werte der searchWith-Felder (flache Schlüssel, nur enabled), zur Request-Zeit gelesen. */
+    private contextValues;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<XiriSuggestDirective, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<XiriSuggestDirective, "input[xiriSuggest]", ["xiriSuggest"], { "field": { "alias": "xiriSuggest"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
 interface XiriButton {
     text: string;
     type: string;
@@ -353,6 +389,8 @@ interface XiriTableField {
     editableOptionsUrl?: string;
     editableOptionsSearch?: boolean;
     editableSearchUrl?: string;
+    /** Go builder: cells of this column are { d: display, v: raw value } objects (see table/cell.ts); the value names the kind of v. */
+    cellObject?: 'string' | 'number';
 }
 
 /** A single table row: a map of column id → cell value (value shapes vary by column format). */
@@ -373,6 +411,8 @@ declare class XiriRawTableComponent {
     dataSource: MatTableDataSource<XiriRawTableRow, _angular_material_paginator.MatPaginator>;
     tableClass: _angular_core.WritableSignal<string>;
     constructor();
+    cellText(row: XiriRawTableRow, column: XiriTableField): unknown;
+    cellLines(row: XiriRawTableRow, column: XiriTableField): unknown[];
     private loadFields;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<XiriRawTableComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<XiriRawTableComponent, "xiri-raw-table", never, { "settings": { "alias": "settings"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
@@ -412,6 +452,8 @@ interface XiriTreeMeta {
     childCount: number;
     dimmed?: boolean;
 }
+/** Resolves the value a tree column sorts its siblings by (see sortValue in cell.ts). */
+type XiriTreeSortKey = (row: XiriTableRow) => string | number;
 declare class XiriTableTreeService {
     private localStorage;
     private config;
@@ -428,8 +470,8 @@ declare class XiriTableTreeService {
     get hasAddSub(): boolean;
     /** Initialises the service from the table's tree settings. treeColumn falls back to firstColumnId. */
     init(config: XiriTableTreeSettings, firstColumnId: string): void;
-    /** Builds the tree from flat rows and initialises the expand-state. */
-    build(rows: XiriTableRow[]): void;
+    /** Builds the tree from flat rows and initialises the expand-state. keyOf defaults to the raw tree-column value. */
+    build(rows: XiriTableRow[], keyOf?: XiriTreeSortKey): void;
     /** Returns the visible rows: search projection when searching, otherwise the expand-state flatten. */
     visibleRows(matches?: (row: XiriTableRow) => boolean): XiriTableRow[];
     /**
@@ -480,6 +522,9 @@ declare class XiriTableInlineEditService {
     searching: _angular_core.WritableSignal<boolean>;
     displayedOptions: _angular_core.WritableSignal<EditableOption[]>;
     private editingOriginalValue;
+    private editDraft;
+    private editStart;
+    private hasUrl;
     private editSeq;
     private editableOptionsSub;
     private optionCache;
@@ -502,8 +547,14 @@ declare class XiriTableInlineEditService {
         onDataUpdate: () => void;
         onCallReturn: (result: unknown) => void;
         isRowLive: (row: XiriTableRow) => boolean;
+        hasUrl: () => boolean;
     }): void;
     start(row: XiriTableRow, column: XiriTableField, skipSavingCheck?: boolean): void;
+    /** Value the inline editor shows: the draft of a cellObject cell while editing, else v, else the cell. */
+    editValue(row: XiriTableRow, column: XiriTableField): XiriTableCellValue;
+    setEditValue(row: XiriTableRow, column: XiriTableField, value: XiriTableCellValue): void;
+    /** compareWith for mat-select: option values are strings, v of a duration cell is a number. */
+    compareEditValue(a: unknown, b: unknown): boolean;
     /** Sets up the search box + subscription for searchable inline-edit selects. */
     private initSearch;
     /** Runs the search: server-side POST when editableSearchUrl is set, otherwise local label filter. */
@@ -540,7 +591,12 @@ declare class XiriButtonlineComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<XiriButtonlineComponent, "xiri-buttonline", never, { "settings": { "alias": "settings"; "required": true; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "filterData": { "alias": "filterData"; "required": false; "isSignal": true; }; }, { "result": "result"; }, never, never, true, never>;
 }
 
-type XiriDynDataType = 'card' | 'buttonline' | 'table' | 'cardlink' | 'links' | 'form' | 'query' | 'stepper' | 'header' | 'list' | 'spacer' | 'container' | 'infopoint' | 'multiprogress' | 'progress' | 'imagetext' | 'tabs' | 'expansion' | 'infotext' | 'html' | 'stat' | 'empty-state' | 'timeline' | 'page-header' | 'section' | 'divider' | 'stat-grid' | 'multi-stat' | 'toolbar' | 'description-list' | 'barchart' | 'linechart' | 'piechart' | 'gaugechart' | 'bulletchart' | 'heatmap' | 'calendar' | 'tree' | 'sankey' | 'gantt' | 'status' | 'callout';
+/**
+ * Vertrag über alle "type"-Werte, die xiri-dyncomponent rendert. Einzige Quelle für die Union
+ * XiriDynDataType und den COMPONENT_CATALOG; xiri-go führt dieselbe Liste als core.ComponentTypes().
+ */
+declare const XIRI_COMPONENT_TYPES: readonly ["card", "buttonline", "table", "cardlink", "links", "form", "query", "stepper", "header", "list", "spacer", "container", "infopoint", "multiprogress", "progress", "imagetext", "tabs", "expansion", "infotext", "html", "stat", "empty-state", "timeline", "page-header", "section", "divider", "stat-grid", "multi-stat", "toolbar", "description-list", "barchart", "linechart", "piechart", "gaugechart", "bulletchart", "heatmap", "calendar", "tree", "sankey", "gantt", "status", "callout"];
+type XiriDynDataType = typeof XIRI_COMPONENT_TYPES[number];
 interface XiriDynData {
     id?: number;
     type: XiriDynDataType | (string & {});
@@ -733,11 +789,15 @@ declare class XiriTableComponent implements OnInit, OnDestroy {
     private makeApiCall;
     buttonReturn(event: XiriButtonResult): void;
     private callReturn;
+    private onTableUpdate;
     private refreshPanel;
     private getSelectionIDs;
     startInlineEdit(row: XiriTableRow, column: XiriTableField, skipSavingCheck?: boolean): void;
     cancelInlineEdit(): void;
     saveInlineEdit(row: XiriTableRow, column: XiriTableField): void;
+    editValue(row: XiriTableRow, column: XiriTableField): XiriTableCellValue;
+    setEditValue(row: XiriTableRow, column: XiriTableField, value: XiriTableCellValue): void;
+    compareEditValue: (a: unknown, b: unknown) => boolean;
     isEditing(row: XiriTableRow, fieldId: string): boolean;
     isSaving(row: XiriTableRow, fieldId: string): boolean;
     onInlineEditKeydown(event: KeyboardEvent, row: XiriTableRow, column: XiriTableField): void;
@@ -751,6 +811,10 @@ declare class XiriTableComponent implements OnInit, OnDestroy {
     pasteInput($event: ClipboardEvent, row: XiriTableRow, column: XiriTableField): false | null;
     saveInputData(): void;
     private getSortingDataAccessor;
+    /** Display part of a cell (see cell.ts); used by every cell template. */
+    cellText(row: XiriTableRow, column: XiriTableField): XiriTableCellValue;
+    /** Display lines of a text2/textn cell. */
+    cellLines(row: XiriTableRow, column: XiriTableField): XiriTableCellValue[];
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<XiriTableComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<XiriTableComponent, "xiri-table", never, { "dyncomponent": { "alias": "dyncomponent"; "required": false; "isSignal": true; }; "settings": { "alias": "settings"; "required": true; "isSignal": true; }; "filterData": { "alias": "filterData"; "required": false; "isSignal": true; }; }, { "clickedRow": "clickedRow"; }, never, never, true, never>;
 }
@@ -772,6 +836,7 @@ declare class XiriFormComponent implements OnInit {
     loadingButton: _angular_core.WritableSignal<XiriButton | null>;
     done: _angular_core.WritableSignal<boolean>;
     error: _angular_core.WritableSignal<string>;
+    fieldErrors: _angular_core.WritableSignal<Record<string, string> | null>;
     private url;
     buttons: XiriButton[];
     private extra;
@@ -788,6 +853,12 @@ declare class XiriFormComponent implements OnInit {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<XiriFormComponent, "xiri-form", never, { "settings": { "alias": "settings"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+interface XiriFormChangeLike {
+    valid: boolean;
+    disabled?: boolean;
+    value: Record<string, unknown> | null;
+}
+
 type XiriDialogSize = 'sm' | 'md' | 'lg' | 'xl' | 'full';
 interface XiriDialogSettings {
     url?: string;
@@ -849,10 +920,7 @@ declare class XiriDialogComponent implements OnDestroy {
     download(data: unknown, tab?: Window | null): void;
     clickButton(button: XiriButton): void;
     private startSend;
-    formChanged(event: {
-        valid: boolean;
-        value: Record<string, unknown> | null;
-    }): void;
+    formChanged(event: XiriFormChangeLike): void;
     ngOnDestroy(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<XiriDialogComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<XiriDialogComponent, "xiri-dialog", never, {}, {}, never, never, true, never>;
@@ -911,6 +979,7 @@ interface XiriQueryResultCount {
 }
 interface XiriQueryFormChangeEvent {
     valid: boolean;
+    disabled?: boolean;
     value: Record<string, unknown> | null;
     pristine?: boolean;
 }
@@ -1057,6 +1126,18 @@ declare class XiriDynComponentComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<XiriDynComponentComponent, "xiri-dyncomponent", never, { "data": { "alias": "data"; "required": true; "isSignal": true; }; "filterData": { "alias": "filterData"; "required": false; "isSignal": true; }; "dyncomponent": { "alias": "dyncomponent"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+interface XiriCatalogEntry {
+    readonly type: XiriDynDataType;
+    readonly name: string;
+    readonly category: string;
+    readonly angular: boolean;
+    readonly dyncomponent: boolean;
+    readonly goBuilder: boolean;
+    readonly route: string;
+    readonly keywords: readonly string[];
+}
+declare const COMPONENT_CATALOG: readonly XiriCatalogEntry[];
+
 interface XiriCardlinkSettings {
     link: string;
     icon?: string;
@@ -1129,6 +1210,7 @@ interface XiriStepperStep {
 }
 interface XiriStepperFormChangeEvent {
     valid: boolean;
+    disabled?: boolean;
     value: Record<string, unknown> | null;
     pristine?: boolean;
 }
@@ -2606,6 +2688,7 @@ interface XiriFormServiceData {
 }
 interface XiriFormServiceError {
     error: string;
+    fields?: Record<string, string>;
 }
 declare class XiriFormService {
     private dataService;
@@ -2790,6 +2873,6 @@ declare class XiriDownloadService {
 
 declare function provideXiriServices(config: Partial<XiriDataServiceConfig>): EnvironmentProviders;
 
-export { COLOR_CSS_VAR, DEFAULT_COMPARE, DEFAULT_PREDICATE, FALLBACK_COLORS, SafehtmlPipe, ThemeService, XIRI_PANEL_HOST, XiriAlertComponent, XiriBarChartComponent, XiriBreadcrumbComponent, XiriBulletChartComponent, XiriButtonComponent, XiriButtonlineComponent, XiriButtonstyleComponent, XiriCalendarComponent, XiriCalloutComponent, XiriCardComponent, XiriCardlinkComponent, XiriColsDirective, XiriDataService, XiriDataServiceConfig, XiriDescriptionListComponent, XiriDialogComponent, XiriDividerComponent, XiriDoneComponent, XiriDownloadService, XiriDynComponentComponent, XiriEchartsHostComponent, XiriEmptyStateComponent, XiriErrorComponent, XiriExpansionComponent, XiriExpansionPanelDirective, XiriFormComponent, XiriFormFieldsComponent, XiriFormService, XiriGanttComponent, XiriGaugeChartComponent, XiriHeaderComponent, XiriHeatmapComponent, XiriImagetextComponent, XiriInfopointComponent, XiriLineChartComponent, XiriLinksComponent, XiriListComponent, XiriLocalStorageService, XiriLocaleService, XiriMultiStatComponent, XiriMultiprogressComponent, XiriPageHeaderComponent, XiriPieChartComponent, XiriProgressComponent, XiriQueryComponent, XiriRawTableComponent, XiriResponseHandlerService, XiriSankeyComponent, XiriSearchComponent, XiriSectionComponent, XiriSelectDirective, XiriSessionStorageService, XiriSidenavComponent, XiriSidepanelComponent, XiriSidepanelRef, XiriSidepanelService, XiriSkeletonComponent, XiriSnackbarService, XiriStatComponent, XiriStatGridComponent, XiriStatusComponent, XiriStepperComponent, XiriTableComponent, XiriTabsComponent, XiriTimelineComponent, XiriToolbarComponent, XiriTreeComponent, XiriUrlPipe, colsToClasses, createPanelLoader, defaultXiriDataServiceConfig, escapeHtml, notifyThemeChanged, provideXiriServices, resolveColor };
-export type { ThemeMode, XiriAlertConfig, XiriBarChartBar, XiriBarChartMode, XiriBarChartPoint, XiriBarChartSegment, XiriBarChartSettings, XiriBreadcrumbItem, XiriBulletChartSettings, XiriButton, XiriButtonResponse, XiriButtonResult, XiriButtonlineSettings, XiriCalendarCell, XiriCalendarSettings, XiriCalloutSettings, XiriCalloutTone, XiriCardSettings, XiriCardlinkSettings, XiriColor, XiriCols, XiriDescriptionListItem, XiriDescriptionListSettings, XiriDialogResponse, XiriDialogSettings, XiriDialogSize, XiriDividerSettings, XiriDynData, XiriDynDataType, XiriEchartsCallbackParams, XiriEchartsClick, XiriEchartsRenderItemApi, XiriEchartsTooltipParams, XiriEmptyStateSettings, XiriExpansionPanelSettings, XiriExpansionSettings, XiriExtendedColor, XiriFormField, XiriFormFieldCondition, XiriFormFieldConditionOperator, XiriFormFieldDisplay, XiriFormFieldSelectOption, XiriFormServiceData, XiriFormServiceError, XiriFormServiceReturn, XiriFormSettings, XiriFormValidator, XiriGanttSettings, XiriGanttTask, XiriGaugeChartSettings, XiriHeaderSettings, XiriHeatmapCell, XiriHeatmapSettings, XiriImagetextSettings, XiriInfopointSettings, XiriLanguage, XiriLanguageDefinition, XiriLineChartLine, XiriLineChartSettings, XiriLinksSettings, XiriListItem, XiriListSection, XiriListSettings, XiriMultiStatSettings, XiriMultiprogressItem, XiriMultiprogressSettings, XiriNavigationField, XiriPageHeaderSettings, XiriPanelHost, XiriPieChartSettings, XiriPieChartSlice, XiriProgressSettings, XiriQueryActiveFilter, XiriQueryFormChangeEvent, XiriQueryResultCount, XiriQuerySettings, XiriRawTableRow, XiriRawTableSettings, XiriSankeyLink, XiriSankeyNode, XiriSankeySettings, XiriSectionSettings, XiriSelectCompare, XiriSelectPredicate, XiriSidebarSettings, XiriSidepanelConfig, XiriSkeletonType, XiriSnackbarType, XiriStatGridSettings, XiriStatSettings, XiriStatTrend, XiriStatusSettings, XiriStatusTone, XiriStatusVariant, XiriStepperFormChangeEvent, XiriStepperResponse, XiriStepperSettings, XiriStepperStep, XiriTabSettings, XiriTableCellValue, XiriTableEmptyState, XiriTableField, XiriTableOptions, XiriTableResponse, XiriTableRow, XiriTableSettings, XiriTableTreeSettings, XiriTabsSettings, XiriTagChip, XiriThemeColor, XiriTimelineItem, XiriTimelineSettings, XiriToolbarSearchConfig, XiriToolbarSettings, XiriTreeNode, XiriTreeSettings, XiriUrl, XiriValidationMessages };
+export { COLOR_CSS_VAR, COMPONENT_CATALOG, DEFAULT_COMPARE, DEFAULT_PREDICATE, FALLBACK_COLORS, SafehtmlPipe, ThemeService, XIRI_COMPONENT_TYPES, XIRI_PANEL_HOST, XiriAlertComponent, XiriBarChartComponent, XiriBreadcrumbComponent, XiriBulletChartComponent, XiriButtonComponent, XiriButtonlineComponent, XiriButtonstyleComponent, XiriCalendarComponent, XiriCalloutComponent, XiriCardComponent, XiriCardlinkComponent, XiriColsDirective, XiriDataService, XiriDataServiceConfig, XiriDescriptionListComponent, XiriDialogComponent, XiriDividerComponent, XiriDoneComponent, XiriDownloadService, XiriDynComponentComponent, XiriEchartsHostComponent, XiriEmptyStateComponent, XiriErrorComponent, XiriExpansionComponent, XiriExpansionPanelDirective, XiriFormComponent, XiriFormFieldsComponent, XiriFormService, XiriGanttComponent, XiriGaugeChartComponent, XiriHeaderComponent, XiriHeatmapComponent, XiriImagetextComponent, XiriInfopointComponent, XiriLineChartComponent, XiriLinksComponent, XiriListComponent, XiriLocalStorageService, XiriLocaleService, XiriMultiStatComponent, XiriMultiprogressComponent, XiriPageHeaderComponent, XiriPieChartComponent, XiriProgressComponent, XiriQueryComponent, XiriRawTableComponent, XiriResponseHandlerService, XiriSankeyComponent, XiriSearchComponent, XiriSectionComponent, XiriSelectDirective, XiriSessionStorageService, XiriSidenavComponent, XiriSidepanelComponent, XiriSidepanelRef, XiriSidepanelService, XiriSkeletonComponent, XiriSnackbarService, XiriStatComponent, XiriStatGridComponent, XiriStatusComponent, XiriStepperComponent, XiriSuggestDirective, XiriTableComponent, XiriTabsComponent, XiriTimelineComponent, XiriToolbarComponent, XiriTreeComponent, XiriUrlPipe, colsToClasses, createPanelLoader, defaultXiriDataServiceConfig, escapeHtml, notifyThemeChanged, provideXiriServices, resolveColor };
+export type { ThemeMode, XiriAlertConfig, XiriBarChartBar, XiriBarChartMode, XiriBarChartPoint, XiriBarChartSegment, XiriBarChartSettings, XiriBreadcrumbItem, XiriBulletChartSettings, XiriButton, XiriButtonResponse, XiriButtonResult, XiriButtonlineSettings, XiriCalendarCell, XiriCalendarSettings, XiriCalloutSettings, XiriCalloutTone, XiriCardSettings, XiriCardlinkSettings, XiriCatalogEntry, XiriColor, XiriCols, XiriDescriptionListItem, XiriDescriptionListSettings, XiriDialogResponse, XiriDialogSettings, XiriDialogSize, XiriDividerSettings, XiriDynData, XiriDynDataType, XiriEchartsCallbackParams, XiriEchartsClick, XiriEchartsRenderItemApi, XiriEchartsTooltipParams, XiriEmptyStateSettings, XiriExpansionPanelSettings, XiriExpansionSettings, XiriExtendedColor, XiriFormField, XiriFormFieldCondition, XiriFormFieldConditionOperator, XiriFormFieldDisplay, XiriFormFieldSelectOption, XiriFormServiceData, XiriFormServiceError, XiriFormServiceReturn, XiriFormSettings, XiriFormValidator, XiriGanttSettings, XiriGanttTask, XiriGaugeChartSettings, XiriHeaderSettings, XiriHeatmapCell, XiriHeatmapSettings, XiriImagetextSettings, XiriInfopointSettings, XiriLanguage, XiriLanguageDefinition, XiriLineChartLine, XiriLineChartSettings, XiriLinksSettings, XiriListItem, XiriListSection, XiriListSettings, XiriMultiStatSettings, XiriMultiprogressItem, XiriMultiprogressSettings, XiriNavigationField, XiriPageHeaderSettings, XiriPanelHost, XiriPieChartSettings, XiriPieChartSlice, XiriProgressSettings, XiriQueryActiveFilter, XiriQueryFormChangeEvent, XiriQueryResultCount, XiriQuerySettings, XiriRawTableRow, XiriRawTableSettings, XiriSankeyLink, XiriSankeyNode, XiriSankeySettings, XiriSectionSettings, XiriSelectCompare, XiriSelectPredicate, XiriSidebarSettings, XiriSidepanelConfig, XiriSkeletonType, XiriSnackbarType, XiriStatGridSettings, XiriStatSettings, XiriStatTrend, XiriStatusSettings, XiriStatusTone, XiriStatusVariant, XiriStepperFormChangeEvent, XiriStepperResponse, XiriStepperSettings, XiriStepperStep, XiriTabSettings, XiriTableCellValue, XiriTableEmptyState, XiriTableField, XiriTableOptions, XiriTableResponse, XiriTableRow, XiriTableSettings, XiriTableTreeSettings, XiriTabsSettings, XiriTagChip, XiriThemeColor, XiriTimelineItem, XiriTimelineSettings, XiriToolbarSearchConfig, XiriToolbarSettings, XiriTreeNode, XiriTreeSettings, XiriUrl, XiriValidationMessages };
 //# sourceMappingURL=xiriframework-xiri-ng.d.ts.map