@xiriframework/xiri-ng 0.4.9 → 0.4.11

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xiriframework/xiri-ng",
-  "version": "0.4.9",
+  "version": "0.4.11",
   "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), 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 oder reloadOn-Abhängigkeiten (Optionen vom Server nachladen), addUrl („+“-Button legt neue Option per Dialog an), oder Server-Side-Tables fragt.
 ---
 
 # xiri-ng Expert
@@ -57,8 +57,9 @@ snackbar.info(msg, duration?, action?)
 snackbar.warning(msg, duration?, action?)
 snackbar.handleResponse(response): boolean   // parst response.message + response.messageType
 
-// Backend-Response-Handler (navigation / page-refresh / table-refresh)
-responseHandler.handle(result, { onTableRefresh?, onTableUpdate? })
+// Backend-Response-Handler (navigation / page-refresh / table-refresh / panel-refresh)
+responseHandler.handle(result, { onTableRefresh?, onTableUpdate?, onPanelRefresh? })
+// refresh:"panel" lädt die nächstgelegene xiri-card mit url neu (DI-Token XIRI_PANEL_HOST, s. setup.md)
 
 // File-Download (tab = Handle aus openTab() → im Tab anzeigen, null → speichern)
 download.openTab(): Window | null            // synchron im Click, sonst blockt der Browser
@@ -152,6 +153,19 @@ Patchbar sind `list`, `name`, `hint`, `class`, `required`, `disabled`, `hide`, `
 `max`, `params` — jeweils nur mit passendem Typ. `value`, `type`, `id` und `url` bewusst nicht.
 Details und Grenzen in `references/form-fields.md`.
 
+**addUrl — neue Option per Dialog anlegen.** `select`, `multiselect`/`treeselect`, `object`/`model`
+und `chips` bekommen mit `addUrl` einen „+“-Button neben dem Feld:
+
+```typescript
+{ id: 'tags', type: 'select', multiple: true, name: 'Tags', list: [...], addUrl: 'Tag/AddDialog' }
+```
+
+Klick lädt `xiri-dialog` per GET auf `addUrl` (ein normaler Form-Dialog vom Backend). Antwortet
+dessen POST mit `{ done: true, created: { id, name } }`, hängt das Feld die Option an seine `list`
+und selektiert sie — bei Mehrfachwerten zusätzlich, ohne Duplikat. `id` muss den Typ der
+vorhandenen Options-IDs haben (chips: Zahl). Go: `f.BaseField.SetAddURL(u)` +
+`response.NewReturnDone().WithCreated(id, name)`.
+
 Zugriff auf die reactive Form:
 
 ```typescript
@@ -316,6 +330,8 @@ stepperSettings = {
 <xiri-expansion [settings]="{ panels: [{ title: 'GPS', buttons: {...}, data: [{ type: 'card', cols: 12, data: { flat: true, data: {...} } }] }] }"/>  <!-- buttons: Header-Buttons; flat: Card ohne Schatten -->
 <!-- Tabelle im Panel: options.flat statt Rahmen im Rahmen, kein cols nötig. Panel halbiert dann automatisch seinen Seitenabstand. -->
 <xiri-expansion [settings]="{ multi: false, unload: true, panels: [{ title: 'Standort Wien', icon: 'place', data: [{ type: 'table', data: { data: rows, fields, options: { flat: true, pagination: false, search: false } } }] }] }"/>
+<!-- Nachladbares Panel: url → POST null → { panel: { title, buttons, data, … } }; refresh:'panel' aus Header-Button/Inhalt lädt nur dieses Panel neu (auch xiri-card mit url). -->
+<xiri-expansion [settings]="{ panels: [{ title: 'lädt …', expanded: true, url: 'Vehicle/7/Panel/Insurance', data: [] }] }"/>
 <xiri-sidenav [settings]="{ prefix: '/app/', fields: navItems }"/>
 <xiri-breadcrumb [settings]="breadcrumbItems"/>
 <xiri-skeleton type="table-row" [lines]="5" [columns]="4"/>
@@ -446,3 +462,5 @@ 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`
+- 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

@@ -96,7 +96,7 @@ dialog.open(XiriAlertComponent, {
 @input.required settings: XiriCardSettings;
 
 interface XiriCardSettings {
-  url?: string;                    // POST mit null → Load
+  url?: string;                    // POST mit null → Load; Antwort {card: …} oder {data: rows}, s. u.
   reload?: boolean;
   data?: any;
   fields?: XiriTableField[];       // Card als Mini-Table
@@ -127,6 +127,21 @@ interface XiriCardSettings {
 }
 ```
 
+**Antwort des `url`-Endpoints** (POST, Body `null`), Modus wird an der rohen Antwort entschieden:
+
+- `{ card: { type, header, headerSub, headerIcon, buttonsTop, buttonsBottom, fields, data, components, … } }` —
+  komplette Card (so liefert es `Card.DataResponse(ctx)` in xiri-go ab 0.3.10). Header-Felder überlagern
+  `settings`; die Inhaltsfelder `fields`, `data`, `dense`, `components`, `showHeader`, `forceMinWidth` kommen
+  ausschließlich aus der Antwort. Bei einem Reload bleibt der bisherige Inhalt stehen (kein Skeleton); schlägt der
+  Reload fehl, bleiben Titel und Buttons der letzten Antwort, nur der Inhalt zeigt die Fehlermeldung.
+- `{ data: rows }` oder `rows` direkt — nur Inhaltszeilen, Header bleibt aus `settings` (Legacy-Form). Was
+  innerhalb von `data` steht, wird nie als Card gedeutet.
+
+**Nachladbares Panel (`refresh: "panel"`):** Gibt ein Button oder eine Tabellenaktion in der Card
+`{ done: true, refresh: 'panel' }` zurück, lädt die Card ihre `url` erneut. Die Card ist dafür `XIRI_PANEL_HOST`
+(siehe setup.md → XiriResponseHandlerService). Typischer Einsatz: Detailseiten mit mehreren Panels
+(Versicherung, Leasing, Preise), deren Bearbeiten-Dialog nur das eigene Panel aktualisieren soll.
+
 **Card als Panel-Inhalt (`flat`):** Card ohne `header` mit `flat: true` in `panel.data` legen; Titel und
 Buttons gehören dann in den Panel-Header (`XiriExpansionPanelSettings.buttons`, siehe xiri-expansion).
 `cols: 12` auf dem `XiriDynData`-Eintrag nicht vergessen — `xiri-dyncomponent` rendert Cards sonst nur
@@ -625,7 +640,8 @@ interface XiriExpansionPanelSettings {
   icon?: string;
   disabled?: boolean;                // sperrt nur den Toggle, nicht die Header-Buttons
   expanded?: boolean;
-  data: XiriDynData[];
+  url?: string;                      // Nachladbares Panel: POST null → {panel: …}, s. u. Shell hat data: []
+  data?: XiriDynData[];
   lazy?: boolean;
   unload?: boolean;
   buttons?: XiriButtonlineSettings;  // Aktions-Buttons rechts im Panel-Header (wie section.buttons).
@@ -639,6 +655,17 @@ Enthält ein Panel eine flache Card (`card.flat`) oder eine flache Tabelle (`tab
 bekommt das Panel die Klasse `flat-content` und halbiert seinen Seitenabstand (24px → 12px) — die
 flache Komponente bringt Rahmen und Innenabstand selbst mit.
 
+**Nachladbares Panel (`url` + `refresh: "panel"`):** Jedes `mat-expansion-panel` trägt die Directive
+`xiriExpansionPanel` und ist damit `XIRI_PANEL_HOST` (siehe setup.md). Mit `url` lädt sich das Panel per POST
+(Body `null`); die Antwort `{ panel: { title, description?, icon?, buttons?, data } }` (Go:
+`Panel.DataResponse(ctx)` ab xiri-go 0.3.10) ersetzt Titel, Beschreibung, Icon, Header-Buttons und Inhalt —
+`expanded`, `disabled`, `lazy`, `unload` bleiben aus der Page, ein Reload klappt nichts zu. Gibt ein Header-Button,
+ein Button im Inhalt oder eine Tabellenaktion `{ done: true, refresh: 'panel' }` zurück, lädt genau dieses Panel
+neu. Eine flache Card ohne `url` im Inhalt reicht an das Panel weiter. Lade-, Fehler- und Puffer-Verhalten wie bei
+`xiri-card` (Skeleton nur beim ersten Laden, Inhalt bleibt beim Reload stehen, bei Reload-Fehler bleibt der Header).
+Der Inhalt wird mit `ngTemplateOutletInjector` = Element-Injector des Panels gerendert; ohne das fänden Buttons im
+Inhalt (eingebettete View) das Panel nicht.
+
 **Panel mit Header-Buttons + rahmenloser Card** (statt Card mit `buttonsTop` im Panel, die doppelten
 Titel und Schatten erzeugt):
 

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

@@ -91,6 +91,7 @@ export interface XiriFormField {
 
   // --- Select / Model / Treeselect ---
   multiple?: boolean;
+  selectAll?: boolean;       // select + multiple: „Alle / Keine“-Toggle über der Optionsliste
   url?: string;              // load options von Backend
   search?: boolean;
   serverSideSearch?: boolean;
@@ -111,6 +112,7 @@ export interface XiriFormField {
   // --- Server-driven content ---
   reloadOn?: string[];       // Feld-IDs, deren Änderung dieses Feld neu lädt
   reloadUrl?: string;        // Endpoint für den Reload (beides oder keins)
+  addUrl?: string;           // „+“-Button: Dialog (GET) legt eine neue Option an, POST → {done, created:{id,name}}
 
   // --- Weitere ---
   rows?: number;             // textarea
@@ -141,8 +143,8 @@ letzterer geht über das FormControl, das Feld fällt dann also auch aus `formGr
 | `textarea`      | Mat-Textarea                                      | `rows`                             |
 | `number`        | Mat-Input type=number                             | `min`, `max`, `textSuffix`         |
 | `bool`          | Mat-Checkbox / Slide-Toggle                       | `placeholder` für Begleittext      |
-| `select`        | Mat-Select mit `list`                             | `multiple`, `search`               |
-| `multiselect`   | Mat-Select mit `multiple: true`                   | `list` oder `url`                  |
+| `select`        | Mat-Select mit `list`                             | `multiple`, `search`, `selectAll`  |
+| `multiselect`   | Checkbox-Liste (flacher Treeselect)               | `list` oder `url`, `min`, `max`    |
 | `model`         | Mat-Select mit Backend-Load                       | `url`, `serverSideSearch`          |
 | `object`        | Komplexes Objekt-Select (JSON-Value)              | `url`, `list`                      |
 | `treeselect`    | Tree-Picker                                       | `url`, `tree: true`                |
@@ -309,6 +311,46 @@ Fenster gespeicherter Filter verlöre das Feld.
 Ketten funktionieren: hängt C an B und wird Bs Wert durch einen Patch verworfen, lädt C nach. Das
 terminiert, weil Pruning nur entfernt.
 
+### addUrl — neue Option per Dialog anlegen
+
+Für `select` (single und `multiple`), `multiselect`/`treeselect`, `object`/`model` und `chips`.
+Mit `addUrl` rendert die Komponente neben dem Control einen `mat-icon-button` „+“ (`button.add-option`,
+`aria-label="Neu anlegen"`); Control und Button liegen in einem Flex-Wrapper `.add-wrap`, der
+`field.class` und `[hidden]` trägt.
+
+```typescript
+{ id: 'tags', type: 'select', multiple: true, name: 'Tags', search: false,
+  list: [ { id: 1, name: 'Produktion' } ], addUrl: 'Tag/AddDialog' }
+```
+
+Ablauf:
+
+1. Klick öffnet `XiriDialogComponent` mit `{ type: 'load', url: addUrl }` — also ein GET, das einen
+   normalen Form-Dialog liefert (`header`, `type: 'form'`, `url`, `fields`, `buttons`).
+2. Der Dialog postet das Formular an seine `url`. Antwortet der Server mit
+   `{ done: true, created: { id, name } }` (Go: `response.NewReturnDone().WithCreated(id, name)`),
+   zeigt der Dialog kurz die Erfolgsanzeige und schließt mit der Antwort. Während dieser Anzeige sind
+   Escape, Backdrop und das Kreuz gesperrt, damit das Ergebnis nicht verloren geht.
+3. Die Komponente hängt `{ id, name }` an `field.list` (falls noch nicht enthalten) und setzt den Wert:
+   Einzelwert → `id`; Mehrfachwert (`multiple`, `treeselect`, `chips`) → bestehende Werte plus `id`,
+   ohne Duplikat. Das Feld wird wie bei einem `reloadOn`-Patch als Kopie neu gerendert.
+
+Verworfen wird das Ergebnis, wenn der Dialog ohne `created` schließt (Abbrechen), das Formular
+inzwischen gewechselt hat (die Control-Identität entscheidet, nicht die Feld-ID), das Control
+deaktiviert ist oder `created` ungültig ist (`id` muss String oder endliche Zahl sein, `name` ein
+String; `0` ist gültig). Der Button ist deaktiviert, solange die Form oder das Control deaktiviert ist.
+
+Grenzen:
+
+- `id` muss den JSON-Typ der vorhandenen Options-IDs haben; der Vergleich ist strikt. `chips` löst
+  Labels nur für numerische IDs auf (Strings sind dort Freitext).
+- Ein `treeselect` mit `url` ignoriert `list` und lädt seinen Baum nach dem Anlegen selbst neu — der
+  Server muss die neue Entität dann sofort liefern.
+- Ein späterer `reloadOn`-Patch ersetzt die Liste; liefert der Server die neue Option nicht mit, wird
+  der Wert verworfen. Serverseitig validieren `SelectField` und Chips beim Submit gegen ihre
+  Optionsliste — die neue Entität muss dort enthalten sein; `ModelField`/`ModelListField` prüfen nur
+  Typ und Anzahl.
+
 ### Select-Optionen
 
 ```typescript
@@ -339,6 +381,16 @@ Inline (statisch):
   ]}
 ```
 
+Mehrfachauswahl mit „Alle / Keine“-Toggle (`selectAll` — Checkbox von `ngx-mat-select-search` über der Liste; wirkt auf die
+aktuell sichtbaren, also bei aktiver Suche nur die gefilterten Optionen, lässt `disabled`-Optionen unangetastet und wird
+ausgeblendet, wenn kein Treffer wählbar ist. Mit `selectAll` wird immer der Such-Zweig gerendert, auch bei `search: false`.
+Go-Seite: `SelectField.SetMultiple(true).SetSelectAll(true)`):
+
+```typescript
+{ id: 'tags', type: 'select', name: 'Tags', multiple: true, selectAll: true, value: [],
+  list: [ { id: 1, name: 'Produktion' }, { id: 2, name: 'Logistik' }, { id: 3, name: 'Archiv', disabled: true } ] }
+```
+
 Hierarchisch (`treeselect` — Optionen über `children` verschachteln; auswählbar sind die Blattknoten, `isGroup` markiert Elternknoten):
 
 ```typescript

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

@@ -65,20 +65,50 @@ Wird von `XiriDataService` intern aufgerufen — du musst `handleResponse` nur s
 
 ## XiriResponseHandlerService
 
-Zentrale Logik für Backend-Responses aus `xiri-go` (`ReturnGoto`, `ReturnRefreshPage`, `ReturnRefreshTable`, `ReturnUpdateTableField`).
+Zentrale Logik für Backend-Responses aus `xiri-go` (`ReturnGoto`, `ReturnRefreshPage`, `ReturnRefreshTable`,
+`ReturnRefreshPanel`, Table-Update).
 
 ```typescript
-handle(result: any, callbacks?: {
+handle(result: unknown, callbacks?: {
   onTableRefresh?: () => void;
-  onTableUpdate?: (id: any, field: string, content: any) => void;
+  onTableUpdate?: (id: unknown, field: string, content: unknown) => void;
+  onPanelRefresh?: () => void;
 }): void
 ```
 
-Verhalten je nach `result.refreshType` / `result.gotoUrl`:
-- Navigation → `Router.navigateByUrl`
-- Page-Refresh → `window.location.reload()`
-- Table-Refresh → ruft `onTableRefresh()` wenn gesetzt
-- Table-Update → ruft `onTableUpdate(id, field, content)` wenn gesetzt
+Verhalten je nach Response:
+- `goto: url` → `router.navigate([url])`
+- `refresh: "page"` → `router.navigate([router.url])` — braucht `onSameUrlNavigation: 'reload'` (siehe dyncomponent.md)
+- `refresh: "table"` → `onTableRefresh()` wenn gesetzt, sonst wie `refresh: "page"`
+- `refresh: "panel"` → `onPanelRefresh()` wenn gesetzt, sonst nichts (kein Router-Fallback im Handler; `xiri-button` und
+  `xiri-table` liefern ohne Panel-Host selbst `{ refresh: "page" }` nach, siehe unten)
+- `update: "table"` → `onTableUpdate(id, field, content)` wenn gesetzt
+
+### Nachladbare Panels: `XIRI_PANEL_HOST`
+
+`refresh: "panel"` lädt genau eine `xiri-card` mit `url` neu (Titel, Buttons, Inhalt), die restliche Seite bleibt
+stehen. Die Verdrahtung läuft über DI, nicht über Outputs:
+
+```typescript
+export interface XiriPanelHost { reloadPanel(): void; }
+export const XIRI_PANEL_HOST: InjectionToken<XiriPanelHost>;
+```
+
+- `xiri-card` und jedes `mat-expansion-panel` in `xiri-expansion` (Directive `xiriExpansionPanel`) stellen sich als
+  `XIRI_PANEL_HOST` bereit (`providers: [{ provide: XIRI_PANEL_HOST, useExisting: … }]`).
+- `xiri-button` und `xiri-table` injizieren den Token optional und rufen bei `refresh: "panel"` `reloadPanel()` der
+  nächstgelegenen Card — egal ob der Button im Card-Header, unten oder in einer verschachtelten Komponente liegt.
+  Ohne umschließende Card: `refresh: "page"` (ab 0.4.11; 0.4.10 warnte nur in der Konsole) — braucht wie
+  `refresh: "page"` `onSameUrlNavigation: 'reload'`. Nur diese beiden Auslöser kennen `refresh: "panel"`;
+  `xiri-links` und der `addUrl`-Dialog der Formularfelder ignorieren es.
+- Eine Card ohne `url` reicht per `skipSelf` an die nächste äußere Card weiter; ohne solche → `refresh: "page"`.
+- Eigene Komponenten, die als Panel gelten sollen, implementieren `XiriPanelHost` und providen den Token genauso;
+  `createPanelLoader({ url, key })` aus `services/panel-loader.ts` liefert Laden, Envelope-Auspacken, Puffer und
+  Reload-Queue fertig (so nutzen es Card und Expansion-Panel).
+- Rendert die Komponente Inhalt über `ngTemplateOutlet`, muss sie `injector` (ihren Element-Injector) mitgeben —
+  eingebettete Views lösen DI sonst über die deklarierende View auf, und Buttons im Inhalt finden den Host nicht.
+
+Antwortformat des Card-Endpoints siehe `components.md` → xiri-card. Ab xiri-ng 0.4.10 / xiri-go 0.3.10.
 
 ## XiriFormService
 

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

@@ -1,8 +1,8 @@
 import * as _angular_core from '@angular/core';
-import { PipeTransform, OnInit, OnDestroy, ChangeDetectorRef, TemplateRef, Type, Signal, WritableSignal, AfterViewInit, ElementRef, EnvironmentProviders } from '@angular/core';
+import { PipeTransform, OnInit, OnDestroy, ChangeDetectorRef, TemplateRef, Type, InjectionToken, Signal, WritableSignal, Injector, AfterViewInit, ElementRef, EnvironmentProviders } from '@angular/core';
 import { Params } from '@angular/router';
 import * as _angular_forms from '@angular/forms';
-import { ValidatorFn, FormControl, UntypedFormGroup, UntypedFormControl } from '@angular/forms';
+import { ValidatorFn, FormControl, UntypedFormGroup, UntypedFormControl, AbstractControl } from '@angular/forms';
 import * as rxjs from 'rxjs';
 import { Observable, Subject } from 'rxjs';
 import * as _angular_material_paginator from '@angular/material/paginator';
@@ -104,6 +104,7 @@ interface XiriFormField {
     max?: number;
     pattern?: string;
     multiple?: boolean;
+    selectAll?: boolean;
     url?: string;
     search?: boolean;
     serverSideSearch?: boolean;
@@ -118,6 +119,7 @@ interface XiriFormField {
     showWhen?: XiriFormFieldCondition | XiriFormFieldCondition[];
     reloadOn?: string[];
     reloadUrl?: string;
+    addUrl?: string;
     control?: FormControl;
     placeholder?: string;
     array?: (string | number)[];
@@ -128,6 +130,8 @@ type XiriFormFieldDisplay = 'full' | 'line' | 'small';
 declare class XiriFormFieldsComponent implements OnInit {
     private formBuilder;
     private destroyRef;
+    private dialog;
+    private destroyed;
     private elementRef;
     private readonly localeService;
     private dataService;
@@ -157,6 +161,8 @@ declare class XiriFormFieldsComponent implements OnInit {
     private dependentFields;
     private triggerValues;
     private fetchPatches;
+    protected openAdd(id: string): void;
+    private addOption;
     private applyPatch;
     private pruneValue;
     fields: _angular_core.Signal<XiriFormField[] | null>;
@@ -185,6 +191,9 @@ declare class XiriSelectDirective implements OnInit, OnDestroy {
     private _filterFormControl;
     /** list of _allValues filtered by search keyword */
     private _filteredValuesSubject;
+    /** what the panel currently shows — the basis for the select-all toggle */
+    private _filtered;
+    private emit;
     /** indicate search operation is in progress */
     searching: boolean;
     /** Subject that emits when the component has been destroyed. */
@@ -201,6 +210,13 @@ declare class XiriSelectDirective implements OnInit, OnDestroy {
     ngOnInit(): void;
     ngOnDestroy(): void;
     private applyFilter;
+    private selectableIds;
+    private static ids;
+    /** false when nothing is selectable — the checkbox is hidden then, otherwise MatCheckbox would stay checked after a no-op click */
+    hasSelectable(): boolean;
+    allSelected(value: unknown): boolean;
+    someSelected(value: unknown): boolean;
+    toggleSelectAll(selectAll: boolean, control: AbstractControl | null): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<XiriSelectDirective, never>;
     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>;
 }
@@ -279,6 +295,7 @@ declare class XiriButtonComponent implements OnDestroy {
     private dialog;
     private downloadService;
     private responseHandler;
+    private panelHost;
     _disabled: _angular_core.Signal<boolean>;
     _url: _angular_core.Signal<string | undefined>;
     constructor();
@@ -288,6 +305,7 @@ declare class XiriButtonComponent implements OnDestroy {
     openMenuDialog(event: MouseEvent, item: Record<string, unknown>): void;
     private actionApi;
     private processResult;
+    private refreshPanel;
     private startPolling;
     private pollTick;
     private cancelPollTimers;
@@ -462,6 +480,7 @@ declare class XiriTableInlineEditService {
     searching: _angular_core.WritableSignal<boolean>;
     displayedOptions: _angular_core.WritableSignal<EditableOption[]>;
     private editingOriginalValue;
+    private editSeq;
     private editableOptionsSub;
     private optionCache;
     private searchSub;
@@ -472,6 +491,7 @@ declare class XiriTableInlineEditService {
     private onSaved;
     private onDataUpdate;
     private onCallReturn;
+    private isRowLive;
     private get editUrl();
     private get displayedColumns();
     init(config: {
@@ -481,6 +501,7 @@ declare class XiriTableInlineEditService {
         onSaved: (row: XiriTableRow, fieldId: string) => void;
         onDataUpdate: () => void;
         onCallReturn: (result: unknown) => void;
+        isRowLive: (row: XiriTableRow) => boolean;
     }): void;
     start(row: XiriTableRow, column: XiriTableField, skipSavingCheck?: boolean): void;
     /** Sets up the search box + subscription for searchable inline-edit selects. */
@@ -596,6 +617,7 @@ declare class XiriTableComponent implements OnInit, OnDestroy {
     private numberService;
     private snackbar;
     private responseHandler;
+    private panelHost;
     private downloadService;
     inlineEdit: XiriTableInlineEditService;
     tree: XiriTableTreeService;
@@ -710,6 +732,7 @@ declare class XiriTableComponent implements OnInit, OnDestroy {
     private makeApiCall;
     buttonReturn(event: XiriButtonResult): void;
     private callReturn;
+    private refreshPanel;
     private getSelectionIDs;
     startInlineEdit(row: XiriTableRow, column: XiriTableField, skipSavingCheck?: boolean): void;
     cancelInlineEdit(): void;
@@ -768,7 +791,7 @@ type XiriDialogSize = 'sm' | 'md' | 'lg' | 'xl' | 'full';
 interface XiriDialogSettings {
     url?: string;
     size?: XiriDialogSize | string;
-    type: "form" | "data" | "question" | "waiting" | "table" | "component";
+    type: "form" | "data" | "question" | "waiting" | "table" | "component" | "load";
     data?: unknown;
     filter?: Record<string, unknown> | null;
 }
@@ -939,6 +962,26 @@ declare class XiriQueryComponent implements OnInit {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<XiriQueryComponent, "xiri-query", never, { "settings": { "alias": "settings"; "required": true; "isSignal": true; }; "dyncomponent": { "alias": "dyncomponent"; "required": false; "isSignal": true; }; "count": { "alias": "count"; "required": false; "isSignal": true; }; }, { "filterChange": "filterChange"; }, never, never, true, never>;
 }
 
+/**
+ * Nächstgelegener Panel-Container eines Auslösers: eine xiri-card oder ein mat-expansion-panel (Directive
+ * xiriExpansionPanel). Beide stellen sich per Provider bereit; Button und Tabelle injizieren den Token optional
+ * und rufen bei refresh:'panel' reloadPanel().
+ */
+interface XiriPanelHost {
+    reloadPanel(): void;
+}
+declare const XIRI_PANEL_HOST: InjectionToken<XiriPanelHost>;
+declare class XiriResponseHandlerService {
+    private router;
+    handle(result: unknown, callbacks?: {
+        onTableRefresh?: () => void;
+        onTableUpdate?: (id: unknown, field: string, content: unknown) => void;
+        onPanelRefresh?: () => void;
+    }): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<XiriResponseHandlerService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<XiriResponseHandlerService>;
+}
+
 interface XiriCardSettings {
     url?: string;
     reload?: boolean;
@@ -960,16 +1003,25 @@ interface XiriCardSettings {
     flat?: boolean;
     padding?: string;
 }
-declare class XiriCardComponent {
-    private dataService;
+declare class XiriCardComponent implements XiriPanelHost {
+    private responseHandler;
+    private parentPanel;
     settings: _angular_core.InputSignal<XiriCardSettings>;
+    private loader;
     showHeader: Signal<boolean>;
     isCollapsed: _angular_core.WritableSignal<boolean>;
-    private cardResource;
     loading: Signal<boolean>;
     errorMsg: Signal<string>;
+    private _raw;
+    /** Zuletzt erfolgreich geladene komplette Card ({card: …}); null bei Zeilen-Antworten. */
+    private loadedCard;
+    /** Inhaltszeilen aus einer Nicht-Card-Antwort: {data: rows} → rows, sonst die Antwort selbst. */
     private _loaded;
+    /** settings(), überlagert von einer nachgeladenen kompletten Card. Inhaltsfelder kommen dann nur aus der Antwort. */
+    card: Signal<XiriCardSettings>;
     cardData: Signal<unknown>;
+    /** Skeleton nur, solange noch nie etwas geladen wurde (auch nicht gepuffert) und kein statischer Inhalt da ist. */
+    showSkeleton: Signal<boolean>;
     hasComponents: Signal<boolean>;
     /** Resolves padding setting (token or free CSS value) into a CSS length string. */
     componentsPadding: Signal<string>;
@@ -978,6 +1030,8 @@ declare class XiriCardComponent {
     /** Klick irgendwo im Header toggelt; Buttons/Links (Collapse, Reload, buttonsTop) behalten ihre eigene Aktion. */
     onHeaderClick(event: MouseEvent): void;
     reload(): void;
+    /** refresh:'panel' aus Button/Tabelle in dieser Card. Ohne url: äußere Card, sonst Page-Reload. */
+    reloadPanel(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<XiriCardComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<XiriCardComponent, "xiri-card", never, { "settings": { "alias": "settings"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
 }
@@ -1339,7 +1393,8 @@ interface XiriExpansionPanelSettings {
     icon?: string;
     disabled?: boolean;
     expanded?: boolean;
-    data: XiriDynData[];
+    url?: string;
+    data?: XiriDynData[];
     buttons?: XiriButtonlineSettings;
     lazy?: boolean;
     unload?: boolean;
@@ -1367,6 +1422,37 @@ declare class XiriExpansionComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<XiriExpansionComponent, "xiri-expansion", never, { "settings": { "alias": "settings"; "required": true; "isSignal": true; }; "filterData": { "alias": "filterData"; "required": false; "isSignal": true; }; "dyncomponent": { "alias": "dyncomponent"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/**
+ * Macht ein mat-expansion-panel zum Panel-Host für refresh:'panel' und lädt es bei gesetzter url nach.
+ * Sitzt als Directive direkt auf dem Material-Panel, damit der Element-Injector des Panels den Token trägt:
+ * Header-Buttons und (über ngTemplateOutletInjector) der Inhalt finden so genau dieses Panel.
+ */
+declare class XiriExpansionPanelDirective implements XiriPanelHost {
+    /**
+     * Shell-Settings des Panels aus XiriExpansionSettings.panels. Nicht `required`: der Loader-Effect einer Directive
+     * läuft in der Host-View und kann vor dem ersten Setzen der Inputs feuern (NG0950) – der leere Default hat keine url.
+     */
+    settings: _angular_core.InputSignal<XiriExpansionPanelSettings>;
+    /** Element-Injector des Panels – als ngTemplateOutletInjector für den Inhalt, sonst löst der über die deklarierende View auf. */
+    injector: Injector;
+    private responseHandler;
+    private parentPanel;
+    private loader;
+    loading: _angular_core.Signal<boolean>;
+    errorMsg: _angular_core.Signal<string>;
+    /**
+     * Shell, überlagert von title/description/icon/buttons/data der letzten Antwort.
+     * expanded/disabled/lazy/unload bleiben Shell-Werte – sonst klappte ein Reload ohne `expanded` das Panel zu.
+     */
+    panel: _angular_core.Signal<XiriExpansionPanelSettings>;
+    /** Skeleton nur, solange noch nie etwas geladen wurde (auch nicht gepuffert) und die Shell keinen Inhalt hat. */
+    showSkeleton: _angular_core.Signal<boolean>;
+    /** refresh:'panel' aus Header-Button, Inhalt oder Tabelle in diesem Panel. Ohne url: äußerer Host, sonst Page-Reload. */
+    reloadPanel(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<XiriExpansionPanelDirective, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<XiriExpansionPanelDirective, "mat-expansion-panel[xiriExpansionPanel]", ["xiriExpansionPanel"], { "settings": { "alias": "xiriExpansionPanel"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
 interface XiriBreadcrumbItem {
     label: string;
     link?: string;
@@ -2660,15 +2746,28 @@ declare class XiriSnackbarService {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<XiriSnackbarService>;
 }
 
-declare class XiriResponseHandlerService {
-    private router;
-    handle(result: unknown, callbacks?: {
-        onTableRefresh?: () => void;
-        onTableUpdate?: (id: unknown, field: string, content: unknown) => void;
-    }): void;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<XiriResponseHandlerService, never>;
-    static ɵprov: _angular_core.ɵɵInjectableDeclaration<XiriResponseHandlerService>;
-}
+/**
+ * Lädt ein Panel (Card, Expansion-Panel) von einer URL und puffert die letzte erfolgreiche Antwort.
+ * Gemeinsame Logik der XIRI_PANEL_HOST-Implementierungen; muss im Injection-Context aufgerufen werden.
+ *
+ * - `raw`: rohe Antwort, nur gelesen, wenn die Resource einen Wert hat (value() wirft im Fehlerzustand).
+ * - `loaded`: das Objekt unter `opts.key` der letzten erfolgreichen Antwort. Bleibt bei Reload-Fehler
+ *   stehen, wird bei url-Wechsel und bei einer erfolgreichen Antwort ohne `opts.key` geleert.
+ * - `reloadOrQueue`: lädt neu; läuft der erste Load noch, wird der Reload nachgeholt, sobald er fertig ist.
+ */
+declare function createPanelLoader<T extends object>(opts: {
+    url: () => string | undefined;
+    key: string;
+}): {
+    loading: _angular_core.Signal<boolean>;
+    errorMsg: _angular_core.Signal<string>;
+    raw: _angular_core.Signal<unknown>;
+    loaded: _angular_core.WritableSignal<T | null>;
+    /** Manueller Reload (Reload-Button): kein Doppelstart, solange geladen wird. */
+    reload: () => void;
+    /** refresh:'panel': reload() gibt false zurück, solange der erste Load läuft – dann nachholen. */
+    reloadOrQueue: () => void;
+};
 
 declare class XiriDownloadService {
     /**
@@ -2690,6 +2789,6 @@ declare class XiriDownloadService {
 
 declare function provideXiriServices(config: Partial<XiriDataServiceConfig>): EnvironmentProviders;
 
-export { COLOR_CSS_VAR, DEFAULT_COMPARE, DEFAULT_PREDICATE, FALLBACK_COLORS, SafehtmlPipe, ThemeService, XiriAlertComponent, XiriBarChartComponent, XiriBreadcrumbComponent, XiriBulletChartComponent, XiriButtonComponent, XiriButtonlineComponent, XiriButtonstyleComponent, XiriCalendarComponent, XiriCalloutComponent, XiriCardComponent, XiriCardlinkComponent, XiriColsDirective, XiriDataService, XiriDataServiceConfig, XiriDescriptionListComponent, XiriDialogComponent, XiriDividerComponent, XiriDoneComponent, XiriDownloadService, XiriDynComponentComponent, XiriEchartsHostComponent, XiriEmptyStateComponent, XiriErrorComponent, XiriExpansionComponent, 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, 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, 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, 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 };
 //# sourceMappingURL=xiriframework-xiri-ng.d.ts.map