@xiriframework/xiri-ng 0.4.8 → 0.4.10

package/package.json

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

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

@@ -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
@@ -204,6 +205,8 @@ tableSettings = {
 
 Öffentliche Methoden: `reload()`, `searchDo(text)`, `startInlineEdit(row, column)`, `cancelInlineEdit()`, `saveInlineEdit(row, column)`, `selection` (SelectionModel), `isAllSelected()`, `masterToggle()`.
 
+**Header-Leiste:** Der graue Streifen über der Kopfzeile trägt `title`, `buttons`, Suche, Reload-Button, Tree-Aktionen und die „Stand HH:mm"-Anzeige — ohne all das wird er nicht gerendert. `search` ist default **true**, für eine nackte Tabelle also `search: false` setzen. Rahmenlos im Panel/in einer Card: `options.flat: true` (Details: `references/table.md`).
+
 **Auto-Refresh:** Liefert die Daten-Response ein `poll` (ms), lädt sich die Tabelle selbsttätig neu + zeigt Header-Indikator mit Countdown; ohne `poll` stoppt es (Backend-gesteuert, `tbl.SetPoll`). Details: `references/table.md`.
 
 ## xiri-raw-table — minimale Tabelle
@@ -312,6 +315,10 @@ stepperSettings = {
 <xiri-divider [settings]="{ text: 'Weitere Optionen', spacing: 'normal' }"/>
 <xiri-tabs [settings]="{ tabs: [{ label: 'Liste', noPadding: true, data: [...] }], lazy: true }"/>  <!-- noPadding: randloser Tab-Body (Tabellen) -->
 <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"/>

package/skills/xiri-ng-expert/evals/evals.json

@@ -83,6 +83,20 @@
         {"name": "no_invented_api", "type": "code_check", "description": "Kein erfundenes Feld wie headerButtons, actions, shadow: false oder compact auf der Card"}
       ],
       "files": []
+    },
+    {
+      "id": 6,
+      "prompt": "Baue mit xiri-ng ein Accordion, das pro Standort ein Panel zeigt (Titel = Standortname, Icon 'place', Beschreibung = Anzahl Geräte). Panel-Inhalt ist eine Tabelle mit Name, IMEI und Status — ohne Pagination, ohne Suche, kompakte Zeilen. Es soll nur ein Standort gleichzeitig offen sein, die Tabelle beim Schließen aus dem DOM verschwinden, und die Tabelle soll keinen eigenen Rahmen im Panel haben.",
+      "expected_output": "XiriExpansionSettings with multi: false and unload: true; one panel per location with title/icon/description and data: [{ type: 'table', data: { data: rows, fields, options: { flat: true, density: 'compact', pagination: false, search: false } } }]. No cols on the table entry, no card wrapped around it.",
+      "assertions": [
+        {"name": "uses_options_flat", "type": "contains_pattern", "description": "Die Tabelle setzt options.flat: true — kein Schatten/Hintergrund/Radius im Panel"},
+        {"name": "search_off", "type": "code_check", "description": "options.search: false ist explizit gesetzt, weil search default true ist (sonst bleibt die Header-Leiste sichtbar)"},
+        {"name": "multi_false_and_unload", "type": "code_check", "description": "multi: false (genau ein Panel offen) und unload: true (Inhalt bei Close aus dem DOM)"},
+        {"name": "table_directly_in_panel_data", "type": "code_check", "description": "Der Tabellen-XiriDynData-Eintrag liegt direkt in panel.data — nicht in eine Card gewrappt"},
+        {"name": "no_cols_on_table", "type": "code_check", "description": "Kein cols: 12 an der Tabelle — xiri-dyncomponent gibt Tabellen schon per Default xcol (volle Breite)"},
+        {"name": "no_invented_api", "type": "code_check", "description": "Kein erfundenes Feld wie elevation: 0, noCard, shadow: false oder noPadding auf der Tabelle — nur options.flat"}
+      ],
+      "files": []
     }
   ]
 }

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).
@@ -635,6 +651,21 @@ interface XiriExpansionPanelSettings {
 }
 ```
 
+Enthält ein Panel eine flache Card (`card.flat`) oder eine flache Tabelle (`table.options.flat`),
+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):
 
@@ -652,6 +683,28 @@ const gps: XiriExpansionSettings = {
 };
 ```
 
+**Tabelle als Panel-Inhalt** (`options.flat`, ein Panel pro Gruppe). `cols` braucht es hier nicht,
+Tabellen sind im Dyncomponent ohnehin volle Breite; `search: false` hält auch die Header-Leiste der
+Tabelle weg (siehe `table.md`):
+
+```ts
+const groups: XiriExpansionSettings = {
+  multi: false, displayMode: 'flat', unload: true,   // ein Panel offen, Tabelle bei Close aus dem DOM
+  panels: [
+    { title: 'Standort Wien', icon: 'place', description: '3 Geräte', expanded: true, data: [ table(wien) ] },
+    { title: 'Standort Graz', icon: 'place', description: '2 Geräte', data: [ table(graz) ] },
+  ],
+};
+
+function table( rows: XiriTableRow[] ): XiriDynData {
+  return { type: 'table', data: {
+    data: rows,
+    fields: [ { id: 'name', name: 'Gerät' }, { id: 'imei', name: 'IMEI' } ],
+    options: { flat: true, density: 'compact', pagination: false, search: false, sort: true },
+  } as XiriTableSettings };
+}
+```
+
 ## Skeleton & Empty-State
 
 ### xiri-skeleton

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;
@@ -141,8 +142,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`                |
@@ -339,6 +340,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,47 @@ 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)
+- `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: `console.warn`.
+- 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/skills/xiri-ng-expert/references/table.md

@@ -117,12 +117,55 @@ export interface XiriTableOptions {
 
   borders?: boolean;
   bordersHeader?: boolean;
+  flat?: boolean = false;              // rahmenlos — s. u. „Rahmenlose Tabelle"
   footer?: boolean;                    // Footer-Row mit count/sum/static
 
   serverSide?: boolean;                // Paging/Sort/Search serverseitig
 }
 ```
 
+### Rahmenlose Tabelle (`flat`) — Tabelle als Panel- oder Card-Inhalt
+
+Die Tabelle rendert sich in eine eigene `mat-card` mit `mat-elevation-z3` und `margin-bottom:
+var(--xiri-spacing-xl)`. Liegt sie in einem Expansion-Panel oder als Sub-Component in einer Card, ist
+das ein Rahmen im Rahmen. `options.flat: true` lässt Schatten, Hintergrund, Radius und das Margin weg.
+Pendant zu `XiriCardSettings.flat`; Go-Seite `TableBuilder.SetFlat(true)` ab `xiri-go >= 0.3.9`.
+
+Ein Expansion-Panel, das eine flache Card oder eine flache Tabelle enthält, bekommt zusätzlich die
+Klasse `flat-content` und halbiert seinen Seitenabstand (24px → 12px) — das passiert automatisch, dafür
+ist nichts zu setzen.
+
+```ts
+const devices: XiriDynData = {
+	type: 'table',
+	data: {
+		data: rows,
+		fields: [ { id: 'name', name: 'Gerät' }, { id: 'imei', name: 'IMEI' } ],
+		// search ist default true — für eine nackte Tabelle explizit abschalten
+		options: { flat: true, density: 'compact', pagination: false, search: false, sort: true },
+	} as XiriTableSettings,
+};
+
+const acc: XiriExpansionSettings = {
+	multi: false, unload: true,
+	panels: [ { title: 'Standort Wien', icon: 'place', description: '3 Geräte', data: [ devices ] } ],
+};
+```
+
+Anders als bei einer Card braucht die Tabelle **kein** `cols: 12` — `xiri-dyncomponent` gibt Tabellen
+schon per Default `xcol` (volle Breite), Cards dagegen `xcol xcol-md-6 xcol-xl-4`.
+
+### Die Header-Leiste erscheint nur mit Inhalt
+
+Der graue Streifen über der Kopfzeile (51px, `--surface-container`, Trennlinie) trägt `title`,
+`buttons`, die Suche, den Reload-Button, die Tree-Aktionen (alle aus-/einklappen) und die
+„Stand HH:mm"-Anzeige. Ist nichts davon da, wird er gar nicht gerendert.
+
+Praktisch heißt das: eine Tabelle mit Inline-`data` und `search: false` hat keine Header-Leiste (vorher
+stand dort ein leerer grauer Balken). Eine Tabelle mit `url` hat nach der ersten Antwort immer eine,
+weil `lastUpdated` dann gesetzt ist. `reload: true` bringt bei Inline-`data` nichts — `loadData()`
+setzt es dort hart auf `false`, weil es nichts nachzuladen gibt.
+
 ### Row-IDs — nicht konvertieren
 
 Row-IDs (`row.id`, und im Tree-Modus `idField`/`parentIdField`) sind **`string | number`** und

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;
@@ -185,6 +186,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 +205,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 +290,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 +300,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 +475,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 +486,7 @@ declare class XiriTableInlineEditService {
     private onSaved;
     private onDataUpdate;
     private onCallReturn;
+    private isRowLive;
     private get editUrl();
     private get displayedColumns();
     init(config: {
@@ -481,6 +496,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. */
@@ -572,6 +588,7 @@ interface XiriTableOptions {
     saveInputUrl?: string;
     borders?: boolean;
     bordersHeader?: boolean;
+    flat?: boolean;
     footer?: boolean;
     serverSide?: boolean;
     scrollHeight?: string;
@@ -595,6 +612,7 @@ declare class XiriTableComponent implements OnInit, OnDestroy {
     private numberService;
     private snackbar;
     private responseHandler;
+    private panelHost;
     private downloadService;
     inlineEdit: XiriTableInlineEditService;
     tree: XiriTableTreeService;
@@ -670,6 +688,7 @@ declare class XiriTableComponent implements OnInit, OnDestroy {
     private clearAutoRefresh;
     searchDo($event: string): void;
     get treeEnabled(): boolean;
+    get hasHeader(): boolean;
     get treeColumnId(): string;
     get treeShowCounts(): boolean;
     get treeHasAddSub(): boolean;
@@ -708,6 +727,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;
@@ -937,6 +957,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;
@@ -958,16 +998,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>;
@@ -976,6 +1025,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>;
 }
@@ -1337,7 +1388,8 @@ interface XiriExpansionPanelSettings {
     icon?: string;
     disabled?: boolean;
     expanded?: boolean;
-    data: XiriDynData[];
+    url?: string;
+    data?: XiriDynData[];
     buttons?: XiriButtonlineSettings;
     lazy?: boolean;
     unload?: boolean;
@@ -1359,11 +1411,43 @@ declare class XiriExpansionComponent {
     visitedPanels: _angular_core.WritableSignal<Set<number>>;
     onPanelOpened(index: number): void;
     onPanelClosed(index: number): void;
+    hasFlatContent(panel: XiriExpansionPanelSettings): boolean;
     shouldRenderContent(index: number, panel: XiriExpansionPanelSettings): boolean;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<XiriExpansionComponent, never>;
     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;
@@ -2657,15 +2741,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 {
     /**
@@ -2687,6 +2784,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