@xiriframework/xiri-ng 0.2.43 → 0.2.45

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xiriframework/xiri-ng",
-  "version": "0.2.43",
+  "version": "0.2.45",
   "description": "Angular UI component library for the Xiri Framework",
   "license": "Apache-2.0",
   "repository": {
@@ -20,17 +20,15 @@
     "tslib": "^2.8.1"
   },
   "peerDependencies": {
-    "@angular/animations": "^21.2",
-    "@angular/compiler": "^21.2",
-    "@angular/platform-browser": "^21.2",
-    "@angular/platform-browser-dynamic": "^21.2",
-    "@angular/router": "^21.2",
-    "@angular/common": "^21.2",
-    "@angular/core": "^21.2",
-    "@angular/material": "^21.2",
-    "@angular/cdk": "^21.2",
-    "@angular/forms": "^21.2",
-    "@angular/material-date-fns-adapter": "^21.2",
+    "@angular/compiler": "^22.0",
+    "@angular/platform-browser": "^22.0",
+    "@angular/router": "^22.0",
+    "@angular/common": "^22.0",
+    "@angular/core": "^22.0",
+    "@angular/material": "^22.0",
+    "@angular/cdk": "^22.0",
+    "@angular/forms": "^22.0",
+    "@angular/material-date-fns-adapter": "^22.0",
     "date-fns": "^4.3",
     "@date-fns/tz": "^1.5",
     "material-symbols": ">=0.44",

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

@@ -208,6 +208,8 @@ Keine Pagination, kein Sort, keine API — nur Daten rendern.
 
 Debounce 300ms, ergebnis unter dem Filter als `XiriDynData[]`.
 
+**Auto-Load beim Öffnen:** Mit gesetzter `url` lädt die Query automatisch beim ersten gültigen Filter-Zustand. Nutzt der Filter stattdessen einen `buttonline`-Button zum Nachladen, setze `autoLoad: true` an diesem Button (`action:'api'`) → er feuert einmalig automatisch beim Laden, sobald der Filter gültig ist (siehe xiri-button unten).
+
 ## xiri-dialog — Modal-Dialog
 
 ```typescript
@@ -251,6 +253,8 @@ buttons: XiriButton[] = [
 
 `data?: Record<string, any>` — Custom-Payload, das beim Klick mit `filterData` gemerged in den POST-Body geht (für `action: 'api'` / `'download'`). Der Backend-Builder (`xiri-go`) setzt das via `button.WithData(...)`. Beispiel: CSV-Download-Button hat `data: { _csv: true }`, das Backend liest das Flag in `LoadFilterData` und schaltet auf CSV-Output.
 
+`autoLoad?: boolean` — löst die Button-Aktion **einmalig automatisch beim Laden** aus, sobald der Button nicht mehr disabled ist (`filterData !== null` und nicht via `disabled` gesperrt). Für Filter mit „Suchen"-Button, dessen Ergebnis ohne initialen Klick erscheinen soll. Backend: `button.WithAutoLoad(true)`. Details: `references/components.md`.
+
 ## xiri-stepper — Multi-Step Wizard
 
 ```typescript

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

@@ -195,6 +195,8 @@ interface XiriButtonResult {
 
 **Button am Ende/laufend ändern (`button`-Patch):** Jede vom Button verarbeitete Antwort darf ein `button`-Objekt mitschicken (`{ text?, color?, icon?, type?, hint?, disabled? }`), das auf den Button gemergt und angezeigt wird — z. B. am Worker-Ende `text:'Erledigt ✓'`, `color:'success'`, `disabled:true`. Der Override bleibt, bis die Aktion erneut ausgelöst wird (dann Reset). Backend: `…​.WithButton(response.NewButtonPatch().WithText("Erledigt ✓").WithColor("success").Disable())`.
 
+**Auto-Load (`button.autoLoad`):** Mit `autoLoad: true` löst der Button seine Aktion **einmalig automatisch beim Laden** aus, sobald er nicht mehr disabled ist — d. h. `filterData !== null` **und** nicht via `disabled` gesperrt (in einer `xiri-query` bindet die Query `disabled = !formValid`, also feuert es erst bei gültigem Filter). Typischer Fall: ein Filter mit „Suchen"-Button (`action:'api'`), dessen Ergebnisse ohne initialen Klick erscheinen sollen. Feuert **genau einmal** (One-shot, per `effect` intern); spätere `filterData`-Änderungen lösen kein erneutes Auto-Load aus — dann klickt der Nutzer wie gewohnt. Backend-Setter: `button.WithAutoLoad(true)` (siehe xiri-go-expert). Alternative ohne Button: `XiriQuerySettings.url` setzen → die Query lädt selbst automatisch beim ersten gültigen Filter-Zustand.
+
 JSON-Beispiele:
 ```json
 // läuft (vom Status-Endpoint, vom Button gepollt):
@@ -251,6 +253,7 @@ interface XiriButton {
   tabIndex?: number;
   inline?: boolean;
   disabled?: boolean;
+  autoLoad?: boolean;   // Aktion einmalig automatisch beim Laden auslösen (siehe unten)
 
   data?: any;
   target?: string;

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

@@ -219,10 +219,12 @@ Array = **UND**-Verknüpfung:
 
 ```typescript
 export interface XiriFormFieldSelectOption {
-  id: number;
+  id: number | string;
   name: string;
   disabled?: boolean;
   color?: XiriColor;
+  isGroup?: boolean;                       // markiert einen Gruppen-/Elternknoten (treeselect)
+  children?: XiriFormFieldSelectOption[];  // verschachtelte Optionen → Hierarchie für treeselect
 }
 ```
 
@@ -237,6 +239,19 @@ Inline (statisch):
   ]}
 ```
 
+Hierarchisch (`treeselect` — Optionen über `children` verschachteln; auswählbar sind die Blattknoten, `isGroup` markiert Elternknoten):
+
+```typescript
+{ id: 'region', type: 'treeselect', name: 'Region',
+  list: [
+    { id: 'eu', name: 'Europa', isGroup: true, children: [
+      { id: 'at', name: 'Österreich' },
+      { id: 'de', name: 'Deutschland' },
+    ]},
+    { id: 'us', name: 'USA' },
+  ]}
+```
+
 Per Backend (`model` oder `select` mit `url`):
 
 ```typescript