@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
@@ -0,0 +1,78 @@
1
+ # InputNumber
2
+
3
+ InputNumber is an input component to provide numerical input.
4
+
5
+ ```typescript
6
+ import { InputNumber } from '@exhaustive-ui/core/inputnumber'; // standalone; or InputNumberModule for all its parts
7
+ ```
8
+
9
+ ## `p-input-number` (also `p-inputNumber`, `p-inputnumber`, legacy): InputNumber
10
+
11
+ Form control: use `[(ngModel)]`, `formControlName` or `[formControl]`.
12
+
13
+ Inputs:
14
+ - `ariaLabel`: `string | undefined`: Used to define a string that labels the input element.
15
+ - `buttonLayout`: `string` = `'stacked'`: Layout of the buttons, valid values are "stacked" (default), "horizontal" and "vertical".
16
+ - `currency`: `string | undefined`: The currency to use in currency formatting.
17
+ - `currencyDisplay`: `any`: How to display the currency in currency formatting.
18
+ - `disabled`: `boolean | undefined`: When present, it specifies that the component should have disabled state style.
19
+ - `fluid`: `boolean | undefined`: Spans 100% width of the container when enabled.
20
+ - `inputId`: `string | undefined`: Identifier of the focus input to match a label defined for the component.
21
+ - `inputStyle`: `any`: Inline style of the input field.
22
+ - `inputStyleClass`: `string | undefined`: Style class of the input field.
23
+ - `invalid`: `boolean | undefined`: When present, it specifies that the component should have invalid state style.
24
+ - `locale`: `string | undefined`: Locale to be used in formatting.
25
+ - `max`: `number | null | undefined`: The value must be less than or equal to the value.
26
+ - `maxFractionDigits`: `number | undefined`: The maximum number of fraction digits to use.
27
+ - `min`: `number | null | undefined`: The value must be greater than or equal to the value.
28
+ - `minFractionDigits`: `number | undefined`: The minimum number of fraction digits to use.
29
+ - `mode`: `any` = `'decimal'`: Defines the behavior of the component, valid values are "decimal" and "currency".
30
+ - `name`: `string | undefined`: When present, it specifies that the name of the input.
31
+ - `placeholder`: `string | undefined`: Advisory information to display on input.
32
+ - `prefix`: `string | undefined`: Text to display before the value.
33
+ - `required`: `boolean | undefined`: There must be a value (if set).
34
+ - `showButtons`: `boolean` = `false`: Displays spinner buttons.
35
+ - `showClear`: `boolean` = `false`: When enabled, a clear icon is displayed to clear the value.
36
+ - `size`: `"large" | "small" | undefined`: Specifies the size of the component.
37
+ - `step`: `number | null | undefined`: Unless the step is set to the any literal, the value must be min + an integral multiple of the step.
38
+ - `suffix`: `string | undefined`: Text to display after the value.
39
+ - `useGrouping`: `boolean` = `true`: Whether to use grouping separators, such as thousands separators or thousand/lakh/crore separators.
40
+ - `variant`: `"filled" | "outlined" | undefined` = `'outlined'`: Specifies the input variant of the component.
41
+ - Other inputs: `allowEmpty`, `ariaDescribedBy`, `ariaLabelledBy`, `ariaRequired`, `autocomplete`, `autofocus`, `decrementButtonClass`, `decrementButtonIcon`, `format`, `incrementButtonClass`, `incrementButtonIcon`, `inputSize`, `localeMatcher`, `maxlength`, `minlength`, `pattern`, `readonly`, `tabindex`, `title`.
42
+
43
+ Outputs:
44
+ - `(onBlur)`: `Event`
45
+ - `(onClear)`: `void`
46
+ - `(onFocus)`: `Event`
47
+ - `(onInput)`: `InputNumberInputEvent`
48
+ - `(onKeyDown)`: `KeyboardEvent`
49
+
50
+ Templates (`<ng-template #name let-…>` inside the element):
51
+ - `#clearicon`: no context. Custom clear icon template.
52
+ - `#incrementbuttonicon`: no context. Custom increment button icon template.
53
+ - `#decrementbuttonicon`: no context. Custom decrement button icon template.
54
+
55
+ ## Example: Filled
56
+
57
+ ```typescript
58
+ import { Component } from '@angular/core';
59
+ import { FormsModule } from '@angular/forms';
60
+ import { InputNumberModule } from '@exhaustive-ui/core/inputnumber';
61
+
62
+ @Component({
63
+ template: `
64
+ <div class="card flex justify-center">
65
+ <p-input-number variant="filled" [(ngModel)]="value1" ariaLabel="Quantity" />
66
+ </div>
67
+ `,
68
+ standalone: true,
69
+ imports: [FormsModule, InputNumberModule]
70
+ })
71
+ export class InputnumberFilledDemo {
72
+ value1!: number;
73
+ }
74
+ ```
75
+
76
+ Every component and directive also accepts `pt` (pass through attributes), `ptOptions`, `dt` (design tokens) and `unstyled`.
77
+
78
+ Full documentation (every input, pass through, styling, all examples): https://exhaustive-ui.com/llms/components/inputnumber.md
@@ -0,0 +1,60 @@
1
+ # Otp Input
2
+
3
+ Input Otp is used to enter one time passwords.
4
+
5
+ ```typescript
6
+ import { InputOtp } from '@exhaustive-ui/core/inputotp'; // standalone; or InputOtpModule for all its parts
7
+ ```
8
+
9
+ ## `p-input-otp` (also `p-inputOtp`, `p-inputotp`, legacy): InputOtp
10
+
11
+ Form control: use `[(ngModel)]`, `formControlName` or `[formControl]`.
12
+
13
+ Inputs:
14
+ - `integerOnly`: `boolean` = `false`: When present, it specifies that an input field is integer-only.
15
+ - `invalid`: `boolean | undefined`: When present, it specifies that the component should have invalid state style.
16
+ - `length`: `number` = `4`: Number of characters to initiate.
17
+ - `mask`: `boolean` = `false`: Mask pattern.
18
+ - `name`: `string | undefined`: When present, it specifies that the name of the input.
19
+ - `required`: `boolean | undefined`: There must be a value (if set).
20
+ - `size`: `"large" | "small" | undefined`: Specifies the size of the component.
21
+ - `variant`: `"filled" | "outlined" | undefined`: Specifies the input variant of the component.
22
+ - Other inputs: `autofocus`, `disabled`, `readonly`, `styleClass`, `tabindex`.
23
+
24
+ Outputs:
25
+ - `(onBlur)`: `Event`
26
+ - `(onChange)`: `InputOtpChangeEvent`
27
+ - `(onFocus)`: `Event`
28
+
29
+ Templates (`<ng-template #name let-…>` inside the element):
30
+ - `#input`: context { $implicit: string | number, events: InputOtpTemplateEvents, index: number, ariaLabel?: string | undefined }. Custom input template.
31
+
32
+ Read a context with `let-`: `<ng-template #input let-item let-events="events" let-index="index">` (`$implicit` is the bare `let-x`).
33
+
34
+ Types used in the contexts:
35
+ - `InputOtpTemplateEvents`: { input: (event: Event, index: number) => void, keydown: (event: Event) => void, focus: (event: Event) => void, blur: (event: Event) => void, paste: (event: Event) => void }
36
+
37
+ ## Example: Basic
38
+
39
+ ```typescript
40
+ import { Component } from '@angular/core';
41
+ import { FormsModule } from '@angular/forms';
42
+ import { InputOtpModule } from '@exhaustive-ui/core/inputotp';
43
+
44
+ @Component({
45
+ template: `
46
+ <div class="card flex justify-center">
47
+ <p-input-otp [(ngModel)]="value" />
48
+ </div>
49
+ `,
50
+ standalone: true,
51
+ imports: [FormsModule, InputOtpModule]
52
+ })
53
+ export class InputotpBasicDemo {
54
+ value: any;
55
+ }
56
+ ```
57
+
58
+ Every component and directive also accepts `pt` (pass through attributes), `ptOptions`, `dt` (design tokens) and `unstyled`.
59
+
60
+ Full documentation (every input, pass through, styling, all examples): https://exhaustive-ui.com/llms/components/inputotp.md
@@ -0,0 +1,41 @@
1
+ # InputText
2
+
3
+ InputText directive is an extension to standard input element with theming.
4
+
5
+ ```typescript
6
+ import { InputText } from '@exhaustive-ui/core/inputtext'; // standalone; or InputTextModule for all its parts
7
+ ```
8
+
9
+ ## `[pInputText]`: InputText
10
+
11
+ Inputs:
12
+ - `fluid`: `boolean | undefined`: Spans 100% width of the container when enabled.
13
+ - `invalid`: `boolean | undefined`: When present, it specifies that the component should have invalid state style.
14
+ - `pSize`: `"large" | "small" | undefined`: Defines the size of the component.
15
+ - `variant`: `"filled" | "outlined" | undefined`: Specifies the input variant of the component.
16
+ - Other inputs: `hostName`, `pInputTextPT`, `pInputTextUnstyled`.
17
+
18
+ ## Example: Basic
19
+
20
+ ```typescript
21
+ import { Component } from '@angular/core';
22
+ import { FormsModule } from '@angular/forms';
23
+ import { InputTextModule } from '@exhaustive-ui/core/inputtext';
24
+
25
+ @Component({
26
+ template: `
27
+ <div class="card flex justify-center">
28
+ <input type="text" pInputText [(ngModel)]="value" aria-label="Name" />
29
+ </div>
30
+ `,
31
+ standalone: true,
32
+ imports: [FormsModule, InputTextModule]
33
+ })
34
+ export class InputtextBasicDemo {
35
+ value: string;
36
+ }
37
+ ```
38
+
39
+ Every component and directive also accepts `pt` (pass through attributes), `ptOptions`, `dt` (design tokens) and `unstyled`.
40
+
41
+ Full documentation (every input, pass through, styling, all examples): https://exhaustive-ui.com/llms/components/inputtext.md
@@ -0,0 +1,49 @@
1
+ # KeyFilter
2
+
3
+ KeyFilter Directive is a built-in feature of InputText to restrict user input based on a regular expression.
4
+
5
+ ```typescript
6
+ import { KeyFilter } from '@exhaustive-ui/core/keyfilter'; // standalone; or KeyFilterModule for all its parts
7
+ ```
8
+
9
+ ## `[pKeyFilter]`: KeyFilter
10
+
11
+ Inputs:
12
+ - `pKeyFilter`: `RegExp | KeyFilterPattern | null | undefined`: Sets the pattern for key filtering.
13
+ - Other inputs: `pValidateOnly`.
14
+
15
+ Outputs:
16
+ - `(ngModelChange)`: `string | number`
17
+
18
+ ## Example: Regex
19
+
20
+ ```typescript
21
+ import { Component } from '@angular/core';
22
+ import { InputTextModule } from '@exhaustive-ui/core/inputtext';
23
+ import { KeyFilterModule } from '@exhaustive-ui/core/keyfilter';
24
+
25
+ @Component({
26
+ template: `
27
+ <div class="card flex flex-wrap gap-4">
28
+ <div class="flex-auto">
29
+ <label for="blockspace" class="font-bold block mb-2"> Block Space </label>
30
+ <input pInputText id="blockspace" [pKeyFilter]="blockSpace" class="w-full" />
31
+ </div>
32
+ <div class="flex-auto">
33
+ <label for="block" class="font-bold block mb-2"> Block < > * ! </label>
34
+ <input pInputText id="block" [pKeyFilter]="blockChars" class="w-full" />
35
+ </div>
36
+ </div>
37
+ `,
38
+ standalone: true,
39
+ imports: [InputTextModule, KeyFilterModule]
40
+ })
41
+ export class KeyfilterRegexDemo {
42
+ blockSpace: RegExp = /^[^\s]+$/;
43
+ blockChars: RegExp = /^[^<>*!]+$/;
44
+ }
45
+ ```
46
+
47
+ Every component and directive also accepts `pt` (pass through attributes), `ptOptions`, `dt` (design tokens) and `unstyled`.
48
+
49
+ Full documentation (every input, pass through, styling, all examples): https://exhaustive-ui.com/llms/components/keyfilter.md
@@ -0,0 +1,55 @@
1
+ # Knob
2
+
3
+ Knob is a form component to define number inputs with a dial.
4
+
5
+ ```typescript
6
+ import { Knob } from '@exhaustive-ui/core/knob'; // standalone; or KnobModule for all its parts
7
+ ```
8
+
9
+ ## `p-knob`: Knob
10
+
11
+ Form control: use `[(ngModel)]`, `formControlName` or `[formControl]`.
12
+
13
+ Inputs:
14
+ - `ariaLabel`: `string | undefined`: Defines a string that labels the input for accessibility.
15
+ - `disabled`: `boolean | undefined`: When present, it specifies that the component should have disabled state style.
16
+ - `invalid`: `boolean | undefined`: When present, it specifies that the component should have invalid state style.
17
+ - `max`: `number` = `100`: Maximum boundary value.
18
+ - `min`: `number` = `0`: Mininum boundary value.
19
+ - `name`: `string | undefined`: When present, it specifies that the name of the input.
20
+ - `rangeColor`: `string` = `$dt('knob.range.background').variable`: Background color of the range.
21
+ - `readonly`: `boolean` = `false`: When present, it specifies that the component value cannot be edited.
22
+ - `size`: `number` = `100`: Size of the component in pixels.
23
+ - `step`: `number` = `1`: Step factor to increment/decrement the value.
24
+ - `strokeWidth`: `number` = `14`: Width of the knob stroke.
25
+ - `valueColor`: `string` = `$dt('knob.value.background').variable`: Background of the value.
26
+ - `valueTemplate`: `string` = `'{value}'`: Template string of the value.
27
+ - Other inputs: `ariaLabelledBy`, `required`, `showValue`, `tabindex`, `textColor`.
28
+
29
+ Outputs:
30
+ - `(onChange)`: `number`
31
+
32
+ ## Example: Basic
33
+
34
+ ```typescript
35
+ import { Component } from '@angular/core';
36
+ import { FormsModule } from '@angular/forms';
37
+ import { KnobModule } from '@exhaustive-ui/core/knob';
38
+
39
+ @Component({
40
+ template: `
41
+ <div class="card flex justify-center">
42
+ <p-knob [(ngModel)]="value" />
43
+ </div>
44
+ `,
45
+ standalone: true,
46
+ imports: [FormsModule, KnobModule]
47
+ })
48
+ export class KnobBasicDemo {
49
+ value!: number;
50
+ }
51
+ ```
52
+
53
+ Every component and directive also accepts `pt` (pass through attributes), `ptOptions`, `dt` (design tokens) and `unstyled`.
54
+
55
+ Full documentation (every input, pass through, styling, all examples): https://exhaustive-ui.com/llms/components/knob.md
@@ -0,0 +1,105 @@
1
+ # Listbox
2
+
3
+ ListBox is used to select one or more values from a list of items.
4
+
5
+ ```typescript
6
+ import { Listbox } from '@exhaustive-ui/core/listbox'; // standalone; or ListboxModule for all its parts
7
+ ```
8
+
9
+ ## `p-listbox` (also `p-listBox`, `p-list-box`, legacy): Listbox
10
+
11
+ Form control: use `[(ngModel)]`, `formControlName` or `[formControl]`.
12
+
13
+ Inputs:
14
+ - `ariaLabel`: `string | undefined`: Defines a string that labels the input for accessibility.
15
+ - `checkbox`: `boolean` = `false`: When specified, allows selecting items with checkboxes.
16
+ - `checkmark`: `boolean` = `false`: Whether the selected option will be shown with a check mark.
17
+ - `disabled`: `boolean | undefined`: When present, it specifies that the component should have disabled state style.
18
+ - `dragdrop`: `boolean` = `false`: Whether to enable dragdrop based reordering.
19
+ - `filter`: `boolean` = `false`: When specified, displays a filter input at header.
20
+ - `group`: `boolean | undefined`: Whether to display options as grouped when nested options are provided.
21
+ - `highlightOnSelect`: `boolean` = `true`: Whether the selected option will be add highlight class.
22
+ - `invalid`: `boolean | undefined`: When present, it specifies that the component should have invalid state style.
23
+ - `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.
24
+ - `multiple`: `boolean | undefined`: When specified, allows selecting multiple values.
25
+ - `name`: `string | undefined`: When present, it specifies that the name of the input.
26
+ - `optionLabel`: `string | undefined`: Name of the label field of an option.
27
+ - `options`: `any[] | undefined`: An array of selectitems to display as the available options.
28
+ - `required`: `boolean | undefined`: There must be a value (if set).
29
+ - `scrollHeight`: `string` = `'14rem'`: Height of the viewport in pixels, a scrollbar is defined if height of list exceeds this value.
30
+ - `selectAll`: `boolean | null | undefined`: Whether all data is selected.
31
+ - `striped`: `boolean | undefined` = `false`: Whether to displays rows with alternating colors.
32
+ - `virtualScroll`: `boolean | undefined`: Whether the data should be loaded on demand during scroll.
33
+ - `virtualScrollItemSize`: `number | undefined`: Height of an item in the list for VirtualScrolling.
34
+ - Other inputs: `ariaFilterLabel`, `ariaLabelledBy`, `autoOptionFocus`, `dataKey`, `dropListData`, `emptyFilterMessage`, `emptyMessage`, `emptySelectionMessage`, `filterBy`, `filterFields`, `filterLocale`, `filterMatchMode`, `filterMessage`, `filterPlaceholder`, `filterValue`, `fluid`, `focusOnHover`, `hostName`, `id`, `lazy`, `listStyle`, `listStyleClass`, `optionDisabled`, `optionGroupChildren`, `optionGroupLabel`, `optionValue`, `readonly`, `searchMessage`, `selectionMessage`, `selectOnFocus`, `showToggleAll`, `tabindex`, `virtualScrollOptions`.
35
+
36
+ Outputs:
37
+ - `(onBlur)`: `FocusEvent`
38
+ - `(onChange)`: `ListboxChangeEvent`
39
+ - `(onClick)`: `ListboxClickEvent`
40
+ - `(onDblClick)`: `ListboxDoubleClickEvent`
41
+ - `(onDrop)`: `CdkDragDrop<string[], string[], any>`
42
+ - `(onFilter)`: `ListboxFilterEvent`
43
+ - `(onFocus)`: `FocusEvent`
44
+ - `(onLazyLoad)`: `ScrollerLazyLoadEvent`
45
+ - `(onSelectAllChange)`: `ListboxSelectAllChangeEvent`
46
+
47
+ Templates (`<ng-template #name let-…>` inside the element):
48
+ - `#item`: context { $implicit: T, index: number, selected: boolean, disabled: boolean }. Custom item template.
49
+ - `#group`: context { $implicit: T }. Custom group template.
50
+ - `#header`: context { $implicit: T, options: any[] }. Custom header template.
51
+ - `#filter`: context { options: ListboxFilterOptions }. Custom filter template.
52
+ - `#footer`: context { $implicit: T, options: any[] }. Custom footer template.
53
+ - `#emptyfilter`: no context. Custom empty filter message template.
54
+ - `#empty`: no context. Custom empty message template.
55
+ - `#filtericon`: no context. Custom filter icon template.
56
+ - `#checkicon`: context { $implicit: boolean }. Custom check icon template.
57
+ - `#checkmark`: context { implicit: boolean }. Custom checkmark icon template.
58
+ - `#loader`: context { options: ScrollerOptions }. Custom loader template.
59
+
60
+ Read a context with `let-`: `<ng-template #item let-item let-index="index" let-selected="selected">` (`$implicit` is the bare `let-x`).
61
+
62
+ Types used in the contexts:
63
+ - `ListboxFilterOptions`: { filter?: ((value?: any) => void) | undefined, reset?: (() => void) | undefined }
64
+
65
+ ## Example: Basic
66
+
67
+ ```typescript
68
+ import { Component, OnInit } from '@angular/core';
69
+ import { FormsModule } from '@angular/forms';
70
+ import { ListboxModule } from '@exhaustive-ui/core/listbox';
71
+
72
+ interface City {
73
+ name: string;
74
+ code: string;
75
+ }
76
+
77
+ @Component({
78
+ template: `
79
+ <div class="card flex justify-center">
80
+ <p-listbox [options]="cities" [(ngModel)]="selectedCity" optionLabel="name" class="w-full md:w-56" ariaLabel="City" />
81
+ </div>
82
+ `,
83
+ standalone: true,
84
+ imports: [FormsModule, ListboxModule]
85
+ })
86
+ export class ListboxBasicDemo implements OnInit {
87
+ cities!: City[];
88
+
89
+ selectedCity!: City;
90
+
91
+ ngOnInit() {
92
+ this.cities = [
93
+ { name: 'New York', code: 'NY' },
94
+ { name: 'Rome', code: 'RM' },
95
+ { name: 'London', code: 'LDN' },
96
+ { name: 'Istanbul', code: 'IST' },
97
+ { name: 'Paris', code: 'PRS' }
98
+ ];
99
+ }
100
+ }
101
+ ```
102
+
103
+ Every component and directive also accepts `pt` (pass through attributes), `ptOptions`, `dt` (design tokens) and `unstyled`.
104
+
105
+ Full documentation (every input, pass through, styling, all examples): https://exhaustive-ui.com/llms/components/listbox.md
@@ -0,0 +1,96 @@
1
+ # MegaMenu
2
+
3
+ MegaMenu is navigation component that displays submenus together.
4
+
5
+ ```typescript
6
+ import { MegaMenu } from '@exhaustive-ui/core/megamenu'; // standalone; or MegaMenuModule for all its parts
7
+ ```
8
+
9
+ ## `p-mega-menu` (also `p-megaMenu`, `p-megamenu`, legacy): MegaMenu
10
+
11
+ Inputs:
12
+ - `ariaLabel`: `string | undefined`: Defines a string value that labels an interactive element.
13
+ - `id`: `string | undefined`: Current id state as a string.
14
+ - `model`: `MegaMenuItem[] | undefined`: An array of menuitems.
15
+ - `orientation`: `string` = `'horizontal'`: Defines the orientation.
16
+ - Other inputs: `ariaLabelledBy`, `breakpoint`, `disabled`, `scrollHeight`, `tabindex`.
17
+
18
+ Templates (`<ng-template #name let-…>` inside the element):
19
+ - `#start`: no context. Defines template option for start.
20
+ - `#end`: no context. Defines template option for end.
21
+ - `#submenuicon`: no context. Defines template option for submenu icon.
22
+ - `#item`: context { $implicit: MenuItem }. Custom item template.
23
+ - `#button`: no context. Custom menu button template on responsive mode.
24
+ - `#buttonicon`: no context. Custom menu button icon template on responsive mode.
25
+
26
+ Read a context with `let-`: `<ng-template #item let-item>` (`$implicit` is the bare `let-x`).
27
+
28
+ ## Example: Router
29
+
30
+ ```typescript
31
+ import { Component, OnInit, inject } from '@angular/core';
32
+ import { Router } from '@angular/router';
33
+ import { MegaMenuItem } from '@exhaustive-ui/core/api';
34
+ import { MegaMenuModule } from '@exhaustive-ui/core/megamenu';
35
+
36
+ @Component({
37
+ template: `
38
+ <div class="card">
39
+ <p-mega-menu [model]="items" />
40
+ </div>
41
+ `,
42
+ standalone: true,
43
+ imports: [MegaMenuModule]
44
+ })
45
+ export class MegamenuRouterDemo implements OnInit {
46
+ private router = inject(Router);
47
+
48
+ items: MegaMenuItem[] | undefined;
49
+
50
+ ngOnInit() {
51
+ this.items = [
52
+ {
53
+ label: 'Router',
54
+ icon: 'pi pi-palette',
55
+ items: [
56
+ [
57
+ {
58
+ label: 'RouterLink',
59
+ items: [{ label: 'Theming', routerLink: '/theming' }]
60
+ }
61
+ ]
62
+ ]
63
+ },
64
+ {
65
+ label: 'Programmatic',
66
+ icon: 'pi pi-link',
67
+ command: () => {
68
+ this.router.navigate(['/installation']);
69
+ }
70
+ },
71
+ {
72
+ label: 'External',
73
+ icon: 'pi pi-home',
74
+ items: [
75
+ [
76
+ {
77
+ label: 'External',
78
+ items: [
79
+ { label: 'Angular', url: 'https://angular.dev/' },
80
+ {
81
+ label: 'Vite.js',
82
+ url: 'https://vitejs.dev/'
83
+ }
84
+ ]
85
+ }
86
+ ]
87
+ ]
88
+ }
89
+ ];
90
+ }
91
+ }
92
+ ```
93
+
94
+ Every component and directive also accepts `pt` (pass through attributes), `ptOptions`, `dt` (design tokens) and `unstyled`.
95
+
96
+ Full documentation (every input, pass through, styling, all examples): https://exhaustive-ui.com/llms/components/megamenu.md
@@ -0,0 +1,64 @@
1
+ # Menu
2
+
3
+ Menu is a navigation / command component that supports dynamic and static positioning.
4
+
5
+ ```typescript
6
+ import { Menu } from '@exhaustive-ui/core/menu'; // standalone; or MenuModule for all its parts
7
+ ```
8
+
9
+ ## `p-menu`: Menu
10
+
11
+ Inputs:
12
+ - `ariaLabel`: `string | undefined`: Defines a string value that labels an interactive element.
13
+ - `id`: `string | undefined`: Current id state as a string.
14
+ - `model`: `MenuItem[] | undefined`: An array of menuitems.
15
+ - `popup`: `boolean | undefined`: Defines if menu would displayed as a popup.
16
+ - `style`: `{ [klass: string]: any; } | null | undefined`: Inline style of the component.
17
+ - `styleClass`: `string | undefined`: Style class of the component.
18
+ - Other inputs: `appendTo`, `ariaLabelledBy`, `autoZIndex`, `baseZIndex`, `motionOptions`, `tabindex`.
19
+
20
+ Outputs:
21
+ - `(onBlur)`: `Event`
22
+ - `(onFocus)`: `Event`
23
+ - `(onHide)`: `any`
24
+ - `(onShow)`: `any`
25
+
26
+ Templates (`<ng-template #name let-…>` inside the element):
27
+ - `#start`: no context. Defines template option for start.
28
+ - `#end`: no context. Defines template option for end.
29
+ - `#item`: context { $implicit: MenuItem }. Custom item template.
30
+ - `#submenuheader`: context { $implicit: MenuItem }. Custom submenu header template.
31
+
32
+ Read a context with `let-`: `<ng-template #item let-item>` (`$implicit` is the bare `let-x`).
33
+
34
+ ## Example: Basic
35
+
36
+ ```typescript
37
+ import { Component, OnInit } from '@angular/core';
38
+ import { MenuItem } from '@exhaustive-ui/core/api';
39
+ import { MenuModule } from '@exhaustive-ui/core/menu';
40
+
41
+ @Component({
42
+ template: `
43
+ <div class="card flex justify-center">
44
+ <p-menu [model]="items" />
45
+ </div>
46
+ `,
47
+ standalone: true,
48
+ imports: [MenuModule]
49
+ })
50
+ export class MenuBasicDemo implements OnInit {
51
+ items: MenuItem[] | undefined;
52
+
53
+ ngOnInit() {
54
+ this.items = [
55
+ { label: 'New', icon: 'pi pi-plus' },
56
+ { label: 'Search', icon: 'pi pi-search' }
57
+ ];
58
+ }
59
+ }
60
+ ```
61
+
62
+ Every component and directive also accepts `pt` (pass through attributes), `ptOptions`, `dt` (design tokens) and `unstyled`.
63
+
64
+ Full documentation (every input, pass through, styling, all examples): https://exhaustive-ui.com/llms/components/menu.md
@@ -0,0 +1,102 @@
1
+ # Menubar
2
+
3
+ Menubar is a horizontal menu component.
4
+
5
+ ```typescript
6
+ import { Menubar } from '@exhaustive-ui/core/menubar'; // standalone; or MenubarModule for all its parts
7
+ ```
8
+
9
+ ## `p-menubar`: Menubar
10
+
11
+ Inputs:
12
+ - `ariaLabel`: `string | undefined`: Defines a string value that labels an interactive element.
13
+ - `id`: `string | undefined`: Current id state as a string.
14
+ - `model`: `MenuItem[] | undefined`: An array of menuitems.
15
+ - Other inputs: `ariaLabelledBy`, `autoDisplay`, `autoHide`, `autoHideDelay`, `breakpoint`.
16
+
17
+ Outputs:
18
+ - `(onBlur)`: `FocusEvent`
19
+ - `(onFocus)`: `FocusEvent`
20
+
21
+ Templates (`<ng-template #name let-…>` inside the element):
22
+ - `#start`: no context. Defines template option for start.
23
+ - `#end`: no context. Defines template option for end.
24
+ - `#item`: context { $implicit: MenuItem, root: boolean }. Custom item template.
25
+ - `#menuicon`: no context. Defines template option for menu icon.
26
+ - `#submenuicon`: no context. Defines template option for submenu icon.
27
+
28
+ Read a context with `let-`: `<ng-template #item let-item let-root="root">` (`$implicit` is the bare `let-x`).
29
+
30
+ ## Example: Basic
31
+
32
+ ```typescript
33
+ import { Component, OnInit } from '@angular/core';
34
+ import { MenuItem } from '@exhaustive-ui/core/api';
35
+ import { MenubarModule } from '@exhaustive-ui/core/menubar';
36
+
37
+ @Component({
38
+ template: `
39
+ <div class="card">
40
+ <p-menubar [model]="items" />
41
+ </div>
42
+ `,
43
+ standalone: true,
44
+ imports: [MenubarModule]
45
+ })
46
+ export class MenubarBasicDemo implements OnInit {
47
+ items: MenuItem[] | undefined;
48
+
49
+ ngOnInit() {
50
+ this.items = [
51
+ {
52
+ label: 'Home',
53
+ icon: 'pi pi-home'
54
+ },
55
+ {
56
+ label: 'Features',
57
+ icon: 'pi pi-star'
58
+ },
59
+ {
60
+ label: 'Projects',
61
+ icon: 'pi pi-search',
62
+ items: [
63
+ {
64
+ label: 'Components',
65
+ icon: 'pi pi-bolt'
66
+ },
67
+ {
68
+ label: 'Blocks',
69
+ icon: 'pi pi-server'
70
+ },
71
+ {
72
+ label: 'UI Kit',
73
+ icon: 'pi pi-pencil'
74
+ },
75
+ {
76
+ label: 'Templates',
77
+ icon: 'pi pi-palette',
78
+ items: [
79
+ {
80
+ label: 'Apollo',
81
+ icon: 'pi pi-palette'
82
+ },
83
+ {
84
+ label: 'Ultima',
85
+ icon: 'pi pi-palette'
86
+ }
87
+ ]
88
+ }
89
+ ]
90
+ },
91
+ {
92
+ label: 'Contact',
93
+ icon: 'pi pi-envelope'
94
+ }
95
+ ];
96
+ }
97
+ }
98
+ ```
99
+
100
+ Every component and directive also accepts `pt` (pass through attributes), `ptOptions`, `dt` (design tokens) and `unstyled`.
101
+
102
+ Full documentation (every input, pass through, styling, all examples): https://exhaustive-ui.com/llms/components/menubar.md