@exhaustive-ui/mcp 22.4.0 → 22.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (205) hide show
  1. package/README.md +13 -1
  2. package/data/cards/accordion.md +91 -0
  3. package/data/cards/animateonscroll.md +155 -0
  4. package/data/cards/autocomplete.md +109 -0
  5. package/data/cards/autofocus.md +36 -0
  6. package/data/cards/avatar.md +45 -0
  7. package/data/cards/badge.md +44 -0
  8. package/data/cards/blockui.md +51 -0
  9. package/data/cards/breadcrumb.md +56 -0
  10. package/data/cards/button.md +83 -0
  11. package/data/cards/card.md +49 -0
  12. package/data/cards/carousel.md +101 -0
  13. package/data/cards/cascadeselect.md +77 -0
  14. package/data/cards/chart.md +105 -0
  15. package/data/cards/checkbox.md +59 -0
  16. package/data/cards/chip.md +50 -0
  17. package/data/cards/classnames.md +91 -0
  18. package/data/cards/colorpicker.md +52 -0
  19. package/data/cards/confirmdialog.md +119 -0
  20. package/data/cards/confirmpopup.md +96 -0
  21. package/data/cards/contextmenu.md +60 -0
  22. package/data/cards/dataview.md +134 -0
  23. package/data/cards/datepicker.md +103 -0
  24. package/data/cards/dialog.md +89 -0
  25. package/data/cards/divider.md +55 -0
  26. package/data/cards/dock.md +106 -0
  27. package/data/cards/dragdrop.md +106 -0
  28. package/data/cards/drawer.md +62 -0
  29. package/data/cards/dynamicdialog.md +103 -0
  30. package/data/cards/editor.md +55 -0
  31. package/data/cards/fieldset.md +54 -0
  32. package/data/cards/fileinput.md +72 -0
  33. package/data/cards/fileupload.md +88 -0
  34. package/data/cards/floatlabel.md +41 -0
  35. package/data/cards/fluid.md +49 -0
  36. package/data/cards/focustrap.md +64 -0
  37. package/data/cards/galleria.md +94 -0
  38. package/data/cards/iconfield.md +45 -0
  39. package/data/cards/iftalabel.md +38 -0
  40. package/data/cards/image.md +58 -0
  41. package/data/cards/imagecompare.md +45 -0
  42. package/data/cards/inplace.md +56 -0
  43. package/data/cards/inputgroup.md +77 -0
  44. package/data/cards/inputmask.md +71 -0
  45. package/data/cards/inputnumber.md +78 -0
  46. package/data/cards/inputotp.md +60 -0
  47. package/data/cards/inputtext.md +41 -0
  48. package/data/cards/keyfilter.md +49 -0
  49. package/data/cards/knob.md +55 -0
  50. package/data/cards/listbox.md +105 -0
  51. package/data/cards/megamenu.md +96 -0
  52. package/data/cards/menu.md +64 -0
  53. package/data/cards/menubar.md +102 -0
  54. package/data/cards/message.md +51 -0
  55. package/data/cards/metergroup.md +53 -0
  56. package/data/cards/multiselect.md +115 -0
  57. package/data/cards/orderlist.md +96 -0
  58. package/data/cards/organizationchart.md +84 -0
  59. package/data/cards/overlay.md +63 -0
  60. package/data/cards/paginator.md +62 -0
  61. package/data/cards/panel.md +57 -0
  62. package/data/cards/panelmenu.md +94 -0
  63. package/data/cards/password.md +81 -0
  64. package/data/cards/picklist.md +106 -0
  65. package/data/cards/popover.md +53 -0
  66. package/data/cards/progressbar.md +42 -0
  67. package/data/cards/progressspinner.md +38 -0
  68. package/data/cards/radiobutton.md +52 -0
  69. package/data/cards/rating.md +56 -0
  70. package/data/cards/ripple.md +37 -0
  71. package/data/cards/scroller.md +32 -0
  72. package/data/cards/scrollpanel.md +50 -0
  73. package/data/cards/scrolltop.md +48 -0
  74. package/data/cards/select.md +108 -0
  75. package/data/cards/selectbutton.md +64 -0
  76. package/data/cards/skeleton.md +54 -0
  77. package/data/cards/slider.md +52 -0
  78. package/data/cards/speeddial.md +102 -0
  79. package/data/cards/splitbutton.md +96 -0
  80. package/data/cards/splitter.md +52 -0
  81. package/data/cards/stepper.md +125 -0
  82. package/data/cards/styleclass.md +46 -0
  83. package/data/cards/table.md +305 -0
  84. package/data/cards/tabs.md +97 -0
  85. package/data/cards/tag.md +41 -0
  86. package/data/cards/terminal.md +76 -0
  87. package/data/cards/textarea.md +45 -0
  88. package/data/cards/tieredmenu.md +121 -0
  89. package/data/cards/timeline.md +58 -0
  90. package/data/cards/toast.md +58 -0
  91. package/data/cards/togglebutton.md +59 -0
  92. package/data/cards/toggleswitch.md +52 -0
  93. package/data/cards/toolbar.md +74 -0
  94. package/data/cards/tooltip.md +43 -0
  95. package/data/cards/tree.md +93 -0
  96. package/data/cards/treeselect.md +98 -0
  97. package/data/cards/treetable.md +231 -0
  98. package/data/components/accordion.md +31 -23
  99. package/data/components/animateonscroll.md +18 -15
  100. package/data/components/autocomplete.md +162 -93
  101. package/data/components/autofocus.md +9 -7
  102. package/data/components/avatar.md +56 -43
  103. package/data/components/badge.md +27 -18
  104. package/data/components/blockui.md +15 -8
  105. package/data/components/breadcrumb.md +20 -14
  106. package/data/components/button.md +121 -94
  107. package/data/components/card.md +12 -10
  108. package/data/components/carousel.md +75 -53
  109. package/data/components/cascadeselect.md +271 -238
  110. package/data/components/chart.md +88 -74
  111. package/data/components/checkbox.md +107 -97
  112. package/data/components/chip.md +20 -16
  113. package/data/components/classnames.md +22 -4
  114. package/data/components/colorpicker.md +54 -36
  115. package/data/components/confirmdialog.md +146 -43
  116. package/data/components/confirmpopup.md +95 -22
  117. package/data/components/contextmenu.md +110 -39
  118. package/data/components/dataview.md +176 -83
  119. package/data/components/datepicker.md +171 -141
  120. package/data/components/dialog.md +80 -68
  121. package/data/components/divider.md +17 -12
  122. package/data/components/dock.md +65 -29
  123. package/data/components/dragdrop.md +26 -12
  124. package/data/components/drawer.md +67 -48
  125. package/data/components/dynamicdialog.md +22 -13
  126. package/data/components/editor.md +42 -33
  127. package/data/components/fieldset.md +20 -17
  128. package/data/components/fileinput.md +92 -35
  129. package/data/components/fileupload.md +101 -61
  130. package/data/components/floatlabel.md +20 -11
  131. package/data/components/fluid.md +11 -9
  132. package/data/components/focustrap.md +11 -7
  133. package/data/components/galleria.md +231 -90
  134. package/data/components/iconfield.md +23 -15
  135. package/data/components/iftalabel.md +15 -9
  136. package/data/components/image.md +31 -26
  137. package/data/components/imagecompare.md +8 -6
  138. package/data/components/inplace.md +27 -22
  139. package/data/components/inputgroup.md +53 -29
  140. package/data/components/inputmask.md +107 -85
  141. package/data/components/inputnumber.md +128 -90
  142. package/data/components/inputotp.md +55 -42
  143. package/data/components/inputtext.md +72 -50
  144. package/data/components/keyfilter.md +6 -3
  145. package/data/components/knob.md +70 -58
  146. package/data/components/listbox.md +171 -141
  147. package/data/components/llms.md +4 -0
  148. package/data/components/megamenu.md +24 -23
  149. package/data/components/menu.md +37 -34
  150. package/data/components/menubar.md +27 -22
  151. package/data/components/message.md +44 -32
  152. package/data/components/metergroup.md +48 -17
  153. package/data/components/multiselect.md +232 -168
  154. package/data/components/orderlist.md +55 -48
  155. package/data/components/organizationchart.md +182 -13
  156. package/data/components/overlay.md +31 -26
  157. package/data/components/paginator.md +49 -34
  158. package/data/components/panel.md +23 -19
  159. package/data/components/panelmenu.md +51 -25
  160. package/data/components/password.md +104 -91
  161. package/data/components/picklist.md +93 -71
  162. package/data/components/popover.md +68 -46
  163. package/data/components/progressbar.md +28 -22
  164. package/data/components/progressspinner.md +13 -11
  165. package/data/components/radiobutton.md +69 -35
  166. package/data/components/rating.md +48 -40
  167. package/data/components/ripple.md +8 -6
  168. package/data/components/scroller.md +29 -29
  169. package/data/components/scrollpanel.md +9 -7
  170. package/data/components/scrolltop.md +20 -18
  171. package/data/components/select.md +248 -169
  172. package/data/components/selectbutton.md +118 -56
  173. package/data/components/skeleton.md +22 -18
  174. package/data/components/slider.md +73 -49
  175. package/data/components/speeddial.md +77 -59
  176. package/data/components/splitbutton.md +354 -329
  177. package/data/components/splitter.md +22 -18
  178. package/data/components/stepper.md +38 -21
  179. package/data/components/styleclass.md +12 -6
  180. package/data/components/table.md +524 -315
  181. package/data/components/tabs.md +44 -26
  182. package/data/components/tag.md +18 -14
  183. package/data/components/terminal.md +38 -27
  184. package/data/components/textarea.md +82 -47
  185. package/data/components/tieredmenu.md +34 -29
  186. package/data/components/timeline.md +29 -28
  187. package/data/components/toast.md +115 -57
  188. package/data/components/togglebutton.md +53 -39
  189. package/data/components/toggleswitch.md +41 -28
  190. package/data/components/toolbar.md +19 -18
  191. package/data/components/tooltip.md +43 -32
  192. package/data/components/tree.md +114 -81
  193. package/data/components/treeselect.md +176 -174
  194. package/data/components/treetable.md +1250 -1045
  195. package/data/components.json +4134 -4088
  196. package/data/llms-full.txt +8979 -6437
  197. package/data/llms.txt +100 -96
  198. package/data/manifest.json +183 -15
  199. package/data/pages/llms.md +29 -0
  200. package/data/pages/tailwind.md +20 -10
  201. package/data/snapshot.json +2 -2
  202. package/dist/index.d.mts +37 -2
  203. package/dist/index.mjs +1395 -1079
  204. package/dist/index.mjs.map +1 -1
  205. package/package.json +1 -1
@@ -23,14 +23,15 @@ interface City {
23
23
  @Component({
24
24
  template: `
25
25
  <div class="card flex justify-center">
26
- <p-listbox [options]="cities" [(ngModel)]="selectedCity" optionLabel="name" class="w-full md:w-56" />
26
+ <p-listbox [options]="cities" [(ngModel)]="selectedCity" optionLabel="name" class="w-full md:w-56" ariaLabel="City" />
27
27
  </div>
28
28
  `,
29
29
  standalone: true,
30
- imports: [ListboxModule, FormsModule]
30
+ imports: [FormsModule, ListboxModule]
31
31
  })
32
32
  export class ListboxBasicDemo implements OnInit {
33
33
  cities!: City[];
34
+
34
35
  selectedCity!: City;
35
36
 
36
37
  ngOnInit() {
@@ -62,14 +63,15 @@ interface City {
62
63
  @Component({
63
64
  template: `
64
65
  <div class="card flex justify-center">
65
- <p-listbox [(ngModel)]="selectedCity" [options]="cities" [multiple]="true" [checkbox]="true" optionLabel="name" class="w-full md:w-56" />
66
+ <p-listbox [(ngModel)]="selectedCity" [options]="cities" [multiple]="true" [checkbox]="true" optionLabel="name" class="w-full md:w-56" ariaLabel="City" />
66
67
  </div>
67
68
  `,
68
69
  standalone: true,
69
- imports: [ListboxModule, FormsModule]
70
+ imports: [FormsModule, ListboxModule]
70
71
  })
71
72
  export class ListboxCheckboxDemo implements OnInit {
72
73
  cities!: City[];
74
+
73
75
  selectedCity!: City;
74
76
 
75
77
  ngOnInit() {
@@ -101,14 +103,15 @@ interface City {
101
103
  @Component({
102
104
  template: `
103
105
  <div class="card flex justify-center">
104
- <p-listbox [(ngModel)]="selectedCity" [options]="cities" optionLabel="name" [checkmark]="true" [highlightOnSelect]="false" class="w-full md:w-56" />
106
+ <p-listbox [(ngModel)]="selectedCity" [options]="cities" optionLabel="name" [checkmark]="true" [highlightOnSelect]="false" class="w-full md:w-56" ariaLabel="City" />
105
107
  </div>
106
108
  `,
107
109
  standalone: true,
108
- imports: [ListboxModule, FormsModule]
110
+ imports: [FormsModule, ListboxModule]
109
111
  })
110
112
  export class ListboxCheckmarkDemo implements OnInit {
111
113
  cities!: City[];
114
+
112
115
  selectedCity!: City;
113
116
 
114
117
  ngOnInit() {
@@ -140,14 +143,15 @@ interface City {
140
143
  @Component({
141
144
  template: `
142
145
  <div class="card flex justify-center">
143
- <p-listbox [options]="cities" [(ngModel)]="selectedCity" optionLabel="name" [disabled]="true" class="w-full md:w-56" />
146
+ <p-listbox [options]="cities" [(ngModel)]="selectedCity" optionLabel="name" [disabled]="true" class="w-full md:w-56" ariaLabel="City" />
144
147
  </div>
145
148
  `,
146
149
  standalone: true,
147
- imports: [ListboxModule, FormsModule]
150
+ imports: [FormsModule, ListboxModule]
148
151
  })
149
152
  export class ListboxDisabledDemo implements OnInit {
150
153
  cities!: City[];
154
+
151
155
  selectedCity!: City;
152
156
 
153
157
  ngOnInit() {
@@ -174,11 +178,11 @@ import { ListboxModule } from '@exhaustive-ui/core/listbox';
174
178
  @Component({
175
179
  template: `
176
180
  <div class="card flex justify-center">
177
- <p-listbox [options]="cities" [(ngModel)]="selectedCity" optionLabel="name" [dragdrop]="true" class="w-full md:w-56" />
181
+ <p-listbox [options]="cities" [(ngModel)]="selectedCity" optionLabel="name" [dragdrop]="true" class="w-full md:w-56" ariaLabel="City" />
178
182
  </div>
179
183
  `,
180
184
  standalone: true,
181
- imports: [ListboxModule, FormsModule]
185
+ imports: [FormsModule, ListboxModule]
182
186
  })
183
187
  export class ListboxDragdropDemo implements OnInit {
184
188
  cities!: any[];
@@ -213,14 +217,15 @@ interface City {
213
217
  @Component({
214
218
  template: `
215
219
  <div class="card flex justify-center">
216
- <p-listbox [options]="cities" [(ngModel)]="selectedCity" optionLabel="name" [filter]="true" class="w-full md:w-56" />
220
+ <p-listbox [options]="cities" [(ngModel)]="selectedCity" optionLabel="name" [filter]="true" class="w-full md:w-56" ariaLabel="City" />
217
221
  </div>
218
222
  `,
219
223
  standalone: true,
220
- imports: [ListboxModule, FormsModule]
224
+ imports: [FormsModule, ListboxModule]
221
225
  })
222
226
  export class ListboxFilterDemo implements OnInit {
223
227
  cities!: City[];
228
+
224
229
  selectedCity!: City;
225
230
 
226
231
  ngOnInit() {
@@ -242,9 +247,8 @@ Options can be grouped when a nested data structures is provided.
242
247
  ```typescript
243
248
  import { Component } from '@angular/core';
244
249
  import { FormsModule } from '@angular/forms';
245
- import { ListboxModule } from '@exhaustive-ui/core/listbox';
246
250
  import { SelectItemGroup } from '@exhaustive-ui/core/api';
247
- import { Country } from '@/domain/customer';
251
+ import { ListboxModule } from '@exhaustive-ui/core/listbox';
248
252
 
249
253
  interface Country {
250
254
  name: string;
@@ -254,10 +258,10 @@ interface Country {
254
258
  @Component({
255
259
  template: `
256
260
  <div class="card flex justify-center">
257
- <p-listbox [options]="groupedCities" [group]="true" [(ngModel)]="selectedCountry" class="w-full md:w-56">
261
+ <p-listbox [options]="groupedCities" [group]="true" [(ngModel)]="selectedCountry" class="w-full md:w-56" ariaLabel="City">
258
262
  <ng-template let-group #group>
259
263
  <div class="flex items-center">
260
- <img src="https://exhaustive-ui.com/demo/flag/flag_placeholder.png" [class]="'mr-2 flag flag-' + group.value" style="width: 20px" />
264
+ <img src="https://exhaustive-ui.com/demo/flag/flag_placeholder.png" [class]="'mr-2 flag flag-' + group.value" style="width: 20px" alt="" />
261
265
  <span>{{ group.label }}</span>
262
266
  </div>
263
267
  </ng-template>
@@ -265,45 +269,46 @@ interface Country {
265
269
  </div>
266
270
  `,
267
271
  standalone: true,
268
- imports: [ListboxModule, FormsModule]
272
+ imports: [FormsModule, ListboxModule]
269
273
  })
270
274
  export class ListboxGroupDemo {
271
275
  groupedCities!: SelectItemGroup[];
276
+
272
277
  selectedCountry!: Country;
273
278
 
274
279
  constructor() {
275
280
  this.groupedCities = [
276
- {
277
- label: 'Germany',
278
- value: 'de',
279
- items: [
280
- { label: 'Berlin', value: 'Berlin' },
281
- { label: 'Frankfurt', value: 'Frankfurt' },
282
- { label: 'Hamburg', value: 'Hamburg' },
283
- { label: 'Munich', value: 'Munich' }
284
- ]
285
- },
286
- {
287
- label: 'USA',
288
- value: 'us',
289
- items: [
290
- { label: 'Chicago', value: 'Chicago' },
291
- { label: 'Los Angeles', value: 'Los Angeles' },
292
- { label: 'New York', value: 'New York' },
293
- { label: 'San Francisco', value: 'San Francisco' }
294
- ]
295
- },
296
- {
297
- label: 'Japan',
298
- value: 'jp',
299
- items: [
300
- { label: 'Kyoto', value: 'Kyoto' },
301
- { label: 'Osaka', value: 'Osaka' },
302
- { label: 'Tokyo', value: 'Tokyo' },
303
- { label: 'Yokohama', value: 'Yokohama' }
304
- ]
305
- }
306
- ];
281
+ {
282
+ label: 'Germany',
283
+ value: 'de',
284
+ items: [
285
+ { label: 'Berlin', value: 'Berlin' },
286
+ { label: 'Frankfurt', value: 'Frankfurt' },
287
+ { label: 'Hamburg', value: 'Hamburg' },
288
+ { label: 'Munich', value: 'Munich' }
289
+ ]
290
+ },
291
+ {
292
+ label: 'USA',
293
+ value: 'us',
294
+ items: [
295
+ { label: 'Chicago', value: 'Chicago' },
296
+ { label: 'Los Angeles', value: 'Los Angeles' },
297
+ { label: 'New York', value: 'New York' },
298
+ { label: 'San Francisco', value: 'San Francisco' }
299
+ ]
300
+ },
301
+ {
302
+ label: 'Japan',
303
+ value: 'jp',
304
+ items: [
305
+ { label: 'Kyoto', value: 'Kyoto' },
306
+ { label: 'Osaka', value: 'Osaka' },
307
+ { label: 'Tokyo', value: 'Tokyo' },
308
+ { label: 'Yokohama', value: 'Yokohama' }
309
+ ]
310
+ }
311
+ ];
307
312
  }
308
313
  }
309
314
  ```
@@ -325,14 +330,15 @@ interface City {
325
330
  @Component({
326
331
  template: `
327
332
  <div class="card flex justify-center">
328
- <p-listbox [options]="cities" [(ngModel)]="selectedCity" optionLabel="name" class="w-full md:w-56" [invalid]="selectedCity === undefined" />
333
+ <p-listbox [options]="cities" [(ngModel)]="selectedCity" optionLabel="name" class="w-full md:w-56" [invalid]="selectedCity === undefined" ariaLabel="City" />
329
334
  </div>
330
335
  `,
331
336
  standalone: true,
332
- imports: [ListboxModule, FormsModule]
337
+ imports: [FormsModule, ListboxModule]
333
338
  })
334
339
  export class ListboxInvalidDemo implements OnInit {
335
340
  cities!: City[];
341
+
336
342
  selectedCity!: City;
337
343
 
338
344
  ngOnInit() {
@@ -364,14 +370,15 @@ interface City {
364
370
  @Component({
365
371
  template: `
366
372
  <div class="card flex justify-center">
367
- <p-listbox [options]="cities" [(ngModel)]="selectedCities" optionLabel="name" [multiple]="true" [metaKeySelection]="false" class="w-full md:w-56" />
373
+ <p-listbox [options]="cities" [(ngModel)]="selectedCities" optionLabel="name" [multiple]="true" [metaKeySelection]="false" class="w-full md:w-56" ariaLabel="Cities" />
368
374
  </div>
369
375
  `,
370
376
  standalone: true,
371
- imports: [ListboxModule, FormsModule]
377
+ imports: [FormsModule, ListboxModule]
372
378
  })
373
379
  export class ListboxMultipleDemo implements OnInit {
374
380
  cities!: City[];
381
+
375
382
  selectedCities!: City[];
376
383
 
377
384
  ngOnInit() {
@@ -392,12 +399,12 @@ Listbox can also be used with reactive forms. In this case, the formControlName
392
399
 
393
400
  ```typescript
394
401
  import { Component, inject } from '@angular/core';
395
- import { ReactiveFormsModule } from '@angular/forms';
402
+ import { FormBuilder, FormGroup, Validators, ReactiveFormsModule } from '@angular/forms';
403
+ import { MessageService } from '@exhaustive-ui/core/api';
396
404
  import { ListboxModule } from '@exhaustive-ui/core/listbox';
397
- import { MessageModule } from '@exhaustive-ui/core/message';
398
- import { ToastModule } from '@exhaustive-ui/core/toast';
399
405
  import { ButtonModule } from '@exhaustive-ui/core/button';
400
- import { MessageService } from '@exhaustive-ui/core/api';
406
+ import { ToastModule } from '@exhaustive-ui/core/toast';
407
+ import { MessageModule } from '@exhaustive-ui/core/message';
401
408
 
402
409
  interface City {
403
410
  name: string;
@@ -410,7 +417,7 @@ interface City {
410
417
  <div class="card flex justify-center">
411
418
  <form [formGroup]="exampleForm" (ngSubmit)="onSubmit()" class="flex flex-col gap-4 sm:w-56">
412
419
  <div class="flex flex-col gap-1">
413
- <p-listbox [options]="cities" formControlName="selectedCity" optionLabel="name" class="w-full md:w-56" [invalid]="isInvalid('selectedCity')" />
420
+ <p-listbox [options]="cities" formControlName="selectedCity" optionLabel="name" class="w-full md:w-56" [invalid]="isInvalid('selectedCity')" ariaLabel="City" />
414
421
  @if (isInvalid('selectedCity')) {
415
422
  <p-message severity="error" size="small" variant="simple">City is required.</p-message>
416
423
  }
@@ -420,25 +427,32 @@ interface City {
420
427
  </div>
421
428
  `,
422
429
  standalone: true,
423
- imports: [ListboxModule, MessageModule, ToastModule, ButtonModule, ReactiveFormsModule]
430
+ imports: [ReactiveFormsModule, ListboxModule, ButtonModule, ToastModule, MessageModule],
431
+ providers: [MessageService]
424
432
  })
425
433
  export class ListboxReactiveformsDemo {
434
+ private fb = inject(FormBuilder);
435
+
426
436
  messageService = inject(MessageService);
437
+
427
438
  exampleForm: FormGroup | undefined;
439
+
428
440
  formSubmitted: boolean = false;
441
+
429
442
  cities!: City[];
430
443
 
431
444
  constructor() {
432
445
  this.cities = [
433
- { name: 'New York', code: 'NY' },
434
- { name: 'Rome', code: 'RM' },
435
- { name: 'London', code: 'LDN' },
436
- { name: 'Istanbul', code: 'IST' },
437
- { name: 'Paris', code: 'PRS' }
438
- ];
439
- this.exampleForm = this.fb.group({
440
- selectedCity: ['', Validators.required]
441
- });
446
+ { name: 'New York', code: 'NY' },
447
+ { name: 'Rome', code: 'RM' },
448
+ { name: 'London', code: 'LDN' },
449
+ { name: 'Istanbul', code: 'IST' },
450
+ { name: 'Paris', code: 'PRS' }
451
+ ];
452
+
453
+ this.exampleForm = this.fb.group({
454
+ selectedCity: ['', Validators.required]
455
+ });
442
456
  }
443
457
 
444
458
  onSubmit() {
@@ -464,11 +478,11 @@ Listbox can also be used with Angular Signal Forms , the @angular/forms/signals
464
478
  ```typescript
465
479
  import { Component, inject, signal } from '@angular/core';
466
480
  import { form, FormField, required, submit } from '@angular/forms/signals';
481
+ import { MessageService } from '@exhaustive-ui/core/api';
467
482
  import { ListboxModule } from '@exhaustive-ui/core/listbox';
468
- import { MessageModule } from '@exhaustive-ui/core/message';
469
- import { ToastModule } from '@exhaustive-ui/core/toast';
470
483
  import { ButtonModule } from '@exhaustive-ui/core/button';
471
- import { MessageService } from '@exhaustive-ui/core/api';
484
+ import { ToastModule } from '@exhaustive-ui/core/toast';
485
+ import { MessageModule } from '@exhaustive-ui/core/message';
472
486
 
473
487
  interface City {
474
488
  name: string;
@@ -481,7 +495,7 @@ interface City {
481
495
  <div class="card flex justify-center">
482
496
  <form novalidate (submit)="onSubmit($event)" class="flex flex-col gap-4 sm:w-56">
483
497
  <div class="flex flex-col gap-1">
484
- <p-listbox [options]="cities" [formField]="exampleForm.selectedCity" optionLabel="name" class="w-full md:w-56" />
498
+ <p-listbox [options]="cities" [formField]="exampleForm.selectedCity" optionLabel="name" class="w-full md:w-56" ariaLabel="City" />
485
499
  @let selectedCity = exampleForm.selectedCity();
486
500
  @if (selectedCity.invalid() && selectedCity.touched()) {
487
501
  <p-message severity="error" size="small" variant="simple">City is required.</p-message>
@@ -492,12 +506,22 @@ interface City {
492
506
  </div>
493
507
  `,
494
508
  standalone: true,
495
- imports: [ListboxModule, MessageModule, ToastModule, ButtonModule, FormField]
509
+ imports: [FormField, ListboxModule, ButtonModule, ToastModule, MessageModule],
510
+ providers: [MessageService]
496
511
  })
497
512
  export class ListboxSignalformsDemo {
498
513
  messageService = inject(MessageService);
499
- cities: City[];
514
+
515
+ cities: City[] = [
516
+ { name: 'New York', code: 'NY' },
517
+ { name: 'Rome', code: 'RM' },
518
+ { name: 'London', code: 'LDN' },
519
+ { name: 'Istanbul', code: 'IST' },
520
+ { name: 'Paris', code: 'PRS' }
521
+ ];
522
+
500
523
  model = signal<{ selectedCity: City | null }>({ selectedCity: null });
524
+
501
525
  exampleForm = form(this.model, (f) => {
502
526
  required(f.selectedCity);
503
527
  });
@@ -520,7 +544,6 @@ For custom content support define a template named item where the default local
520
544
  import { Component, OnInit } from '@angular/core';
521
545
  import { FormsModule } from '@angular/forms';
522
546
  import { ListboxModule } from '@exhaustive-ui/core/listbox';
523
- import { Country } from '@/domain/customer';
524
547
 
525
548
  interface Country {
526
549
  name: string;
@@ -530,10 +553,10 @@ interface Country {
530
553
  @Component({
531
554
  template: `
532
555
  <div class="card flex justify-center">
533
- <p-listbox [options]="countries" [(ngModel)]="selectedCountry" optionLabel="name" class="w-full md:w-56">
556
+ <p-listbox [options]="countries" [(ngModel)]="selectedCountry" optionLabel="name" class="w-full md:w-56" ariaLabel="Country">
534
557
  <ng-template #item let-country>
535
558
  <div class="flex items-center gap-2">
536
- <img src="https://exhaustive-ui.com/demo/flag/flag_placeholder.png" [class]="'flag flag-' + country.code.toLowerCase()" style="width: 18px" />
559
+ <img src="https://exhaustive-ui.com/demo/flag/flag_placeholder.png" [class]="'flag flag-' + country.code.toLowerCase()" style="width: 18px" alt="" />
537
560
  <div>{{ country.name }}</div>
538
561
  </div>
539
562
  </ng-template>
@@ -541,10 +564,11 @@ interface Country {
541
564
  </div>
542
565
  `,
543
566
  standalone: true,
544
- imports: [ListboxModule, FormsModule]
567
+ imports: [FormsModule, ListboxModule]
545
568
  })
546
569
  export class ListboxTemplateDemo implements OnInit {
547
570
  countries!: Country[];
571
+
548
572
  selectedCountry!: Country;
549
573
 
550
574
  ngOnInit() {
@@ -567,13 +591,13 @@ export class ListboxTemplateDemo implements OnInit {
567
591
  ## templatedrivenforms-doc
568
592
 
569
593
  ```typescript
570
- import { Component, OnInit, inject } from '@angular/core';
594
+ import { Component, inject, OnInit } from '@angular/core';
571
595
  import { FormsModule } from '@angular/forms';
596
+ import { MessageService } from '@exhaustive-ui/core/api';
572
597
  import { ListboxModule } from '@exhaustive-ui/core/listbox';
573
- import { MessageModule } from '@exhaustive-ui/core/message';
574
- import { ToastModule } from '@exhaustive-ui/core/toast';
575
598
  import { ButtonModule } from '@exhaustive-ui/core/button';
576
- import { MessageService } from '@exhaustive-ui/core/api';
599
+ import { ToastModule } from '@exhaustive-ui/core/toast';
600
+ import { MessageModule } from '@exhaustive-ui/core/message';
577
601
 
578
602
  interface City {
579
603
  name: string;
@@ -586,7 +610,7 @@ interface City {
586
610
  <div class="card flex justify-center">
587
611
  <form #exampleForm="ngForm" (ngSubmit)="onSubmit(exampleForm)" class="flex justify-center flex-col gap-4 md:w-56">
588
612
  <div class="flex flex-col gap-1">
589
- <p-listbox #city="ngModel" [options]="cities" [(ngModel)]="selectedCity" optionLabel="name" class="w-full md:w-56" [invalid]="city.invalid && exampleForm.submitted" name="city" required />
613
+ <p-listbox #city="ngModel" [options]="cities" [(ngModel)]="selectedCity" optionLabel="name" class="w-full md:w-56" [invalid]="city.invalid && exampleForm.submitted" name="city" required ariaLabel="City" />
590
614
  @if (city.invalid && exampleForm.submitted) {
591
615
  <p-message severity="error" size="small" variant="simple">City is required.</p-message>
592
616
  }
@@ -596,11 +620,14 @@ interface City {
596
620
  </div>
597
621
  `,
598
622
  standalone: true,
599
- imports: [ListboxModule, MessageModule, ToastModule, ButtonModule, FormsModule]
623
+ imports: [FormsModule, ListboxModule, ButtonModule, ToastModule, MessageModule],
624
+ providers: [MessageService]
600
625
  })
601
626
  export class ListboxTemplatedrivenformsDemo implements OnInit {
602
627
  messageService = inject(MessageService);
628
+
603
629
  selectedCity!: City;
630
+
604
631
  cities!: City[];
605
632
 
606
633
  ngOnInit() {
@@ -650,15 +677,18 @@ import { ListboxModule } from '@exhaustive-ui/core/listbox';
650
677
  scrollHeight="250px"
651
678
  [striped]="true"
652
679
  class="w-full md:w-56"
680
+ ariaLabel="Item"
653
681
  />
654
682
  </div>
655
683
  `,
656
684
  standalone: true,
657
- imports: [ListboxModule, FormsModule]
685
+ imports: [FormsModule, ListboxModule]
658
686
  })
659
687
  export class ListboxVirtualscrollDemo {
660
- items: any = Array.from({ length: 100000 }, (_, i) => ({ label: `Item #${i}`, value: i }));
688
+ items = Array.from({ length: 100000 }, (_, i) => ({ label: `Item #${i}`, value: i }));
689
+
661
690
  selectedItems!: any[];
691
+
662
692
  selectAll: boolean = false;
663
693
 
664
694
  onSelectAllChange(event) {
@@ -681,62 +711,62 @@ ListBox is used to select one or more values from a list of items.
681
711
 
682
712
  | Name | Type | Default | Description |
683
713
  |------|------|---------|-------------|
684
- | dt | InputSignal<Object> | undefined | Defines scoped design tokens of the component. |
685
- | unstyled | InputSignal<boolean> | undefined | Indicates whether the component should be rendered without styles. |
686
- | pt | InputSignal<ListBoxPassThrough> | undefined | Used to pass attributes to DOM elements inside the component. |
687
- | ptOptions | InputSignal<PassThroughOptions> | undefined | Used to configure passthrough(pt) options of the component. |
688
- | required | InputSignalWithTransform<boolean, unknown> | false | There must be a value (if set). |
689
- | invalid | InputSignalWithTransform<boolean, unknown> | false | When present, it specifies that the component should have invalid state style. |
690
- | disabled | InputSignalWithTransform<boolean, unknown> | false | When present, it specifies that the component should have disabled state style. |
691
- | name | InputSignal<string> | undefined | When present, it specifies that the name of the input. |
692
- | id | InputSignal<string> | ... | Unique identifier of the component. |
693
- | searchMessage | InputSignal<string> | '{0} results are available' | Text to display when the search is active. Defaults to global value in i18n translation configuration. |
694
- | emptySelectionMessage | InputSignal<string> | 'No selected item' | Text to display when filtering does not return any results. Defaults to global value in i18n translation configuration. |
695
- | selectionMessage | InputSignal<string> | '{0} items selected' | Text to be displayed in hidden accessible field when options are selected. Defaults to global value in i18n translation configuration. |
696
- | autoOptionFocus | InputSignalWithTransform<boolean, unknown> | ... | Whether to focus on the first visible or selected element when the overlay panel is shown. |
697
- | ariaLabel | InputSignal<string> | ... | Defines a string that labels the input for accessibility. |
698
- | ariaLabelledBy | InputSignal<string> | ... | Establishes relationships between the component and label(s) where its value should be one or more element IDs. |
699
- | selectOnFocus | InputSignalWithTransform<boolean, unknown> | ... | When enabled, the focused option is selected. |
700
- | focusOnHover | InputSignalWithTransform<boolean, unknown> | ... | When enabled, the hovered option will be focused. |
701
- | filterMessage | InputSignal<string> | ... | Text to display when filtering. |
702
- | filterFields | InputSignal<any[]> | ... | Fields used when filtering the options, defaults to optionLabel. |
703
- | lazy | InputSignalWithTransform<boolean, unknown> | ... | Defines if data is loaded and interacted with in lazy manner. |
704
- | virtualScroll | InputSignalWithTransform<boolean, unknown> | ... | Whether the data should be loaded on demand during scroll. |
705
- | virtualScrollItemSize | InputSignalWithTransform<number, unknown> | ... | Height of an item in the list for VirtualScrolling. |
706
- | virtualScrollOptions | InputSignal<ScrollerOptions> | ... | Whether to use the scroller feature. The properties of scroller component can be used like an object in it. |
707
- | scrollHeight | InputSignal<string> | ... | Height of the viewport in pixels, a scrollbar is defined if height of list exceeds this value. |
708
- | tabindex | InputSignalWithTransform<number, unknown> | ... | Index of the element in tabbing order. |
709
- | multiple | InputSignalWithTransform<boolean, unknown> | ... | When specified, allows selecting multiple values. |
710
- | listStyle | InputSignal<{ [klass: string]: any }> | ... | Inline style of the list element. |
711
- | listStyleClass | InputSignal<string> | ... | Style class of the list element. |
712
- | readonly | InputSignalWithTransform<boolean, unknown> | ... | When present, it specifies that the element value cannot be changed. |
713
- | checkbox | InputSignalWithTransform<boolean, unknown> | ... | When specified, allows selecting items with checkboxes. |
714
- | filter | InputSignalWithTransform<boolean, unknown> | ... | When specified, displays a filter input at header. |
715
- | filterBy | InputSignal<string> | ... | When filtering is enabled, filterBy decides which field or fields (comma separated) to search against. |
716
- | filterMatchMode | InputSignal<string> | ... | Defines how the items are filtered. |
717
- | filterLocale | InputSignal<string> | ... | Locale to use in filtering. The default locale is the host environment's current locale. |
718
- | metaKeySelection | InputSignalWithTransform<boolean, unknown> | ... | Defines how multiple items can be selected, when true metaKey needs to be pressed to select or unselect an item and when set to false selection of each item can be toggled individually. On touch enabled devices, metaKeySelection is turned off automatically. |
719
- | dataKey | InputSignal<string> | ... | A property to uniquely identify a value in options. |
720
- | showToggleAll | InputSignalWithTransform<boolean, unknown> | ... | Whether header checkbox is shown in multiple mode. |
721
- | optionLabel | InputSignal<string> | ... | Name of the label field of an option. |
722
- | optionValue | InputSignal<string> | ... | Name of the value field of an option. |
723
- | optionGroupChildren | InputSignal<string> | ... | Name of the options field of an option group. |
724
- | optionGroupLabel | InputSignal<string> | ... | Name of the label field of an option group. |
725
- | optionDisabled | InputSignal<string \| ((item: any) => boolean)> | ... | Name of the disabled field of an option or function to determine disabled state. |
726
- | ariaFilterLabel | InputSignal<string> | ... | Defines a string that labels the filter input. |
727
- | filterPlaceholder | InputSignal<string> | ... | Defines placeholder of the filter input. |
728
- | emptyFilterMessage | InputSignal<string> | ... | Text to display when filtering does not return any results. |
729
- | emptyMessage | InputSignal<string> | ... | Text to display when there is no data. Defaults to global value in i18n translation configuration. |
730
- | group | InputSignalWithTransform<boolean, unknown> | ... | Whether to display options as grouped when nested options are provided. |
731
- | options | InputSignal<any[]> | ... | An array of selectitems to display as the available options. |
732
- | filterValue | InputSignal<string> | ... | When specified, filter displays with this value. |
733
- | selectAll | InputSignal<boolean> | ... | Whether all data is selected. |
734
- | striped | InputSignalWithTransform<boolean, unknown> | false | Whether to displays rows with alternating colors. |
735
- | highlightOnSelect | InputSignalWithTransform<boolean, unknown> | true | Whether the selected option will be add highlight class. |
736
- | checkmark | InputSignalWithTransform<boolean, unknown> | false | Whether the selected option will be shown with a check mark. |
737
- | dragdrop | InputSignalWithTransform<boolean, unknown> | ... | Whether to enable dragdrop based reordering. |
738
- | dropListData | InputSignal<any[]> | ... | Array to use for CDK drop list data binding. When not provided, uses options array. |
739
- | fluid | InputSignalWithTransform<boolean, unknown> | undefined | Spans 100% width of the container when enabled. |
714
+ | dt | Object | undefined | Defines scoped design tokens of the component. |
715
+ | unstyled | boolean | undefined | Indicates whether the component should be rendered without styles. |
716
+ | pt | ListBoxPassThrough | undefined | Used to pass attributes to DOM elements inside the component. |
717
+ | ptOptions | PassThroughOptions | undefined | Used to configure passthrough(pt) options of the component. |
718
+ | required | boolean | false | There must be a value (if set). |
719
+ | invalid | boolean | false | When present, it specifies that the component should have invalid state style. |
720
+ | disabled | boolean | false | When present, it specifies that the component should have disabled state style. |
721
+ | name | string | undefined | When present, it specifies that the name of the input. |
722
+ | id | string | - | Unique identifier of the component. |
723
+ | searchMessage | string | '{0} results are available' | Text to display when the search is active. Defaults to global value in i18n translation configuration. |
724
+ | emptySelectionMessage | string | 'No selected item' | Text to display when filtering does not return any results. Defaults to global value in i18n translation configuration. |
725
+ | selectionMessage | string | '{0} items selected' | Text to be displayed in hidden accessible field when options are selected. Defaults to global value in i18n translation configuration. |
726
+ | autoOptionFocus | boolean | true | Whether to focus on the first visible or selected element when the overlay panel is shown. |
727
+ | ariaLabel | string | - | Defines a string that labels the input for accessibility. |
728
+ | ariaLabelledBy | string | - | Establishes relationships between the component and label(s) where its value should be one or more element IDs. |
729
+ | selectOnFocus | boolean | - | When enabled, the focused option is selected. |
730
+ | focusOnHover | boolean | true | When enabled, the hovered option will be focused. |
731
+ | filterMessage | string | - | Text to display when filtering. |
732
+ | filterFields | any[] | - | Fields used when filtering the options, defaults to optionLabel. |
733
+ | lazy | boolean | false | Defines if data is loaded and interacted with in lazy manner. |
734
+ | virtualScroll | boolean | - | Whether the data should be loaded on demand during scroll. |
735
+ | virtualScrollItemSize | number | - | Height of an item in the list for VirtualScrolling. |
736
+ | virtualScrollOptions | ScrollerOptions | - | Whether to use the scroller feature. The properties of scroller component can be used like an object in it. |
737
+ | scrollHeight | string | '14rem' | Height of the viewport in pixels, a scrollbar is defined if height of list exceeds this value. |
738
+ | tabindex | number | 0 | Index of the element in tabbing order. |
739
+ | multiple | boolean | - | When specified, allows selecting multiple values. |
740
+ | listStyle | { [klass: string]: any } | - | Inline style of the list element. |
741
+ | listStyleClass | string | - | Style class of the list element. |
742
+ | readonly | boolean | - | When present, it specifies that the element value cannot be changed. |
743
+ | checkbox | boolean | false | When specified, allows selecting items with checkboxes. |
744
+ | filter | boolean | false | When specified, displays a filter input at header. |
745
+ | filterBy | string | - | When filtering is enabled, filterBy decides which field or fields (comma separated) to search against. |
746
+ | filterMatchMode | string | 'contains' | Defines how the items are filtered. |
747
+ | filterLocale | string | - | Locale to use in filtering. The default locale is the host environment's current locale. |
748
+ | metaKeySelection | boolean | false | Defines how multiple items can be selected, when true metaKey needs to be pressed to select or unselect an item and when set to false selection of each item can be toggled individually. On touch enabled devices, metaKeySelection is turned off automatically. |
749
+ | dataKey | string | - | A property to uniquely identify a value in options. |
750
+ | showToggleAll | boolean | true | Whether header checkbox is shown in multiple mode. |
751
+ | optionLabel | string | - | Name of the label field of an option. |
752
+ | optionValue | string | - | Name of the value field of an option. |
753
+ | optionGroupChildren | string | 'items' | Name of the options field of an option group. |
754
+ | optionGroupLabel | string | 'label' | Name of the label field of an option group. |
755
+ | optionDisabled | string \| ((item: any) => boolean) | - | Name of the disabled field of an option or function to determine disabled state. |
756
+ | ariaFilterLabel | string | - | Defines a string that labels the filter input. |
757
+ | filterPlaceholder | string | - | Defines placeholder of the filter input. |
758
+ | emptyFilterMessage | string | - | Text to display when filtering does not return any results. |
759
+ | emptyMessage | string | - | Text to display when there is no data. Defaults to global value in i18n translation configuration. |
760
+ | group | boolean | - | Whether to display options as grouped when nested options are provided. |
761
+ | options | any[] | - | An array of selectitems to display as the available options. |
762
+ | filterValue | string | - | When specified, filter displays with this value. |
763
+ | selectAll | boolean | - | Whether all data is selected. |
764
+ | striped | boolean | false | Whether to displays rows with alternating colors. |
765
+ | highlightOnSelect | boolean | true | Whether the selected option will be add highlight class. |
766
+ | checkmark | boolean | false | Whether the selected option will be shown with a check mark. |
767
+ | dragdrop | boolean | false | Whether to enable dragdrop based reordering. |
768
+ | dropListData | any[] | - | Array to use for CDK drop list data binding. When not provided, uses options array. |
769
+ | fluid | boolean | undefined | Spans 100% width of the container when enabled. |
740
770
 
741
771
  ### Emits
742
772
 
@@ -2,6 +2,10 @@
2
2
 
3
3
  LLM-optimized documentation endpoints for ExhaustiveUI components.
4
4
 
5
+ ## AI coding agents
6
+
7
+ @exhaustive-ui/core ships its own guide for AI coding agents: node_modules/@exhaustive-ui/core/AGENTS.md gives the rules that matter when writing code with the library (imports, canonical tags, templates, signals, OnPush), the PrimeNG habits to drop, and links to a card per component in llms/cards/ . Coding agents read node_modules , so this works without any setup, and always matches the installed version. To make sure your agent reads it first, add one line to the AGENTS.md or CLAUDE.md of your project. A component card is a 2 to 16 KB summary: the import, the tag, the inputs the examples use with their type and default, the outputs, every template with the context it receives, and one complete example. The same cards are published at /llms/cards/&lt;name&gt;.md , returned first by the get_component tool of the MCP server, and bundled in the Agent Skill. The site version of the guide is /llms/AGENTS.md . After writing templates, an agent (or you) can check them against the API with the check command of the MCP package. It reads the .html files and the inline templates under src , and reports, with file and line: PrimeNG tags and imports with their replacement, unknown or miscased inputs, invalid values, inputs removed in v22, and template names that the component does not have. It exits with 1 on errors, so it also fits in a CI pipeline or a pre-commit hook.
8
+
5
9
  ## Agent Skill
6
10
 
7
11
  The markdown files above are also bundled as an Agent Skill , the SKILL.md format supported by coding agents such as Claude Code, Codex, Cursor and OpenCode. Once installed, the agent reads the component docs, API tables and guides from disk whenever it works on ExhaustiveUI code, instead of fetching them from this site each time. Install it with the skills CLI , which asks which agents to set it up for. By default the skill is installed into the current project, so your team gets it too. Add -g to install it for your user instead. You can also download the zip and extract it into a folder named exhaustive-ui in your agent's skills directory.