@vonage/vivid-vue 4.24.0 → 4.26.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 (121) hide show
  1. package/generated/components/VAccordionItem.vue3.d.ts +9 -1
  2. package/generated/components/VAlert.vue3.d.ts +1 -1
  3. package/generated/components/VBadge.types.d.ts +4 -0
  4. package/generated/components/VBadge.vue2.d.ts +15 -0
  5. package/generated/components/VBadge.vue3.d.ts +16 -1
  6. package/generated/components/VBanner.vue3.d.ts +1 -1
  7. package/generated/components/VBreadcrumbItem.types.d.ts +8 -12
  8. package/generated/components/VBreadcrumbItem.vue2.d.ts +16 -31
  9. package/generated/components/VBreadcrumbItem.vue3.d.ts +16 -31
  10. package/generated/components/VButton.types.d.ts +10 -14
  11. package/generated/components/VButton.vue2.d.ts +29 -28
  12. package/generated/components/VButton.vue3.d.ts +30 -29
  13. package/generated/components/VCard.types.d.ts +36 -0
  14. package/generated/components/VCard.vue2.d.ts +135 -0
  15. package/generated/components/VCard.vue3.d.ts +135 -0
  16. package/generated/components/VCheckbox.types.d.ts +11 -21
  17. package/generated/components/VCheckbox.vue2.d.ts +31 -42
  18. package/generated/components/VCheckbox.vue3.d.ts +31 -42
  19. package/generated/components/VCombobox.types.d.ts +8 -15
  20. package/generated/components/VCombobox.vue2.d.ts +27 -56
  21. package/generated/components/VCombobox.vue3.d.ts +27 -57
  22. package/generated/components/VDataGridCell.types.d.ts +9 -0
  23. package/generated/components/VDataGridCell.vue2.d.ts +30 -1
  24. package/generated/components/VDataGridCell.vue3.d.ts +33 -2
  25. package/generated/components/VDataGridRow.types.d.ts +4 -0
  26. package/generated/components/VDataGridRow.vue2.d.ts +16 -1
  27. package/generated/components/VDataGridRow.vue3.d.ts +16 -1
  28. package/generated/components/VDatePicker.types.d.ts +10 -4
  29. package/generated/components/VDatePicker.vue2.d.ts +38 -9
  30. package/generated/components/VDatePicker.vue3.d.ts +38 -9
  31. package/generated/components/VDateRangePicker.types.d.ts +9 -3
  32. package/generated/components/VDateRangePicker.vue2.d.ts +36 -7
  33. package/generated/components/VDateRangePicker.vue3.d.ts +36 -7
  34. package/generated/components/VDateTimePicker.types.d.ts +10 -4
  35. package/generated/components/VDateTimePicker.vue2.d.ts +38 -9
  36. package/generated/components/VDateTimePicker.vue3.d.ts +38 -9
  37. package/generated/components/VDialPad.types.d.ts +4 -0
  38. package/generated/components/VDialPad.vue2.d.ts +19 -0
  39. package/generated/components/VDialPad.vue3.d.ts +19 -0
  40. package/generated/components/VDialog.types.d.ts +4 -0
  41. package/generated/components/VDialog.vue2.d.ts +15 -0
  42. package/generated/components/VDialog.vue3.d.ts +15 -0
  43. package/generated/components/VDivider.types.d.ts +1 -1
  44. package/generated/components/VDivider.vue2.d.ts +3 -3
  45. package/generated/components/VDivider.vue3.d.ts +3 -3
  46. package/generated/components/VEmptyState.types.d.ts +0 -3
  47. package/generated/components/VEmptyState.vue2.d.ts +0 -6
  48. package/generated/components/VEmptyState.vue3.d.ts +0 -6
  49. package/generated/components/VFab.types.d.ts +2 -6
  50. package/generated/components/VFab.vue2.d.ts +13 -12
  51. package/generated/components/VFab.vue3.d.ts +14 -13
  52. package/generated/components/VFilePicker.types.d.ts +5 -8
  53. package/generated/components/VFilePicker.vue2.d.ts +19 -16
  54. package/generated/components/VFilePicker.vue3.d.ts +19 -16
  55. package/generated/components/VIcon.types.d.ts +4 -0
  56. package/generated/components/VIcon.vue2.d.ts +15 -0
  57. package/generated/components/VIcon.vue3.d.ts +15 -0
  58. package/generated/components/VMenuItem.types.d.ts +8 -4
  59. package/generated/components/VMenuItem.vue2.d.ts +15 -0
  60. package/generated/components/VMenuItem.vue3.d.ts +17 -2
  61. package/generated/components/VNavDisclosure.types.d.ts +4 -0
  62. package/generated/components/VNavDisclosure.vue2.d.ts +15 -0
  63. package/generated/components/VNavDisclosure.vue3.d.ts +16 -1
  64. package/generated/components/VNavItem.types.d.ts +14 -14
  65. package/generated/components/VNavItem.vue2.d.ts +34 -36
  66. package/generated/components/VNavItem.vue3.d.ts +35 -37
  67. package/generated/components/VNote.vue3.d.ts +1 -1
  68. package/generated/components/VNumberField.types.d.ts +7 -18
  69. package/generated/components/VNumberField.vue2.d.ts +23 -43
  70. package/generated/components/VNumberField.vue3.d.ts +23 -43
  71. package/generated/components/VOption.vue2.d.ts +1 -1
  72. package/generated/components/VOption.vue3.d.ts +2 -2
  73. package/generated/components/VProgressRing.types.d.ts +1 -1
  74. package/generated/components/VProgressRing.vue2.d.ts +3 -3
  75. package/generated/components/VProgressRing.vue3.d.ts +3 -3
  76. package/generated/components/VRadio.types.d.ts +11 -14
  77. package/generated/components/VRadio.vue2.d.ts +40 -29
  78. package/generated/components/VRadio.vue3.d.ts +40 -29
  79. package/generated/components/VRadioGroup.types.d.ts +11 -1
  80. package/generated/components/VRadioGroup.vue2.d.ts +43 -2
  81. package/generated/components/VRadioGroup.vue3.d.ts +47 -2
  82. package/generated/components/VRangeSlider.types.d.ts +2 -6
  83. package/generated/components/VRangeSlider.vue2.d.ts +13 -12
  84. package/generated/components/VRangeSlider.vue3.d.ts +13 -12
  85. package/generated/components/VRichTextEditor.vue2.d.ts +6 -0
  86. package/generated/components/VRichTextEditor.vue3.d.ts +6 -0
  87. package/generated/components/VSearchableSelect.types.d.ts +7 -14
  88. package/generated/components/VSearchableSelect.vue2.d.ts +25 -29
  89. package/generated/components/VSearchableSelect.vue3.d.ts +26 -30
  90. package/generated/components/VSelect.types.d.ts +7 -14
  91. package/generated/components/VSelect.vue2.d.ts +23 -29
  92. package/generated/components/VSelect.vue3.d.ts +24 -30
  93. package/generated/components/VSelectableBox.types.d.ts +0 -3
  94. package/generated/components/VSelectableBox.vue2.d.ts +1 -7
  95. package/generated/components/VSelectableBox.vue3.d.ts +1 -7
  96. package/generated/components/VSlider.types.d.ts +3 -11
  97. package/generated/components/VSlider.vue2.d.ts +15 -22
  98. package/generated/components/VSlider.vue3.d.ts +15 -22
  99. package/generated/components/VSplitButton.vue3.d.ts +1 -1
  100. package/generated/components/VSwitch.types.d.ts +6 -17
  101. package/generated/components/VSwitch.vue2.d.ts +23 -35
  102. package/generated/components/VSwitch.vue3.d.ts +23 -35
  103. package/generated/components/VTab.types.d.ts +1 -2
  104. package/generated/components/VTab.vue2.d.ts +2 -11
  105. package/generated/components/VTab.vue3.d.ts +3 -12
  106. package/generated/components/VTag.vue3.d.ts +1 -1
  107. package/generated/components/VTextArea.types.d.ts +9 -16
  108. package/generated/components/VTextArea.vue2.d.ts +28 -33
  109. package/generated/components/VTextArea.vue3.d.ts +28 -33
  110. package/generated/components/VTextField.types.d.ts +8 -15
  111. package/generated/components/VTextField.vue2.d.ts +26 -31
  112. package/generated/components/VTextField.vue3.d.ts +26 -31
  113. package/generated/components/VTimePicker.types.d.ts +10 -4
  114. package/generated/components/VTimePicker.vue2.d.ts +38 -9
  115. package/generated/components/VTimePicker.vue3.d.ts +38 -9
  116. package/generated/components/VTreeItem.vue3.d.ts +1 -1
  117. package/index.cjs +644 -333
  118. package/index.js +644 -334
  119. package/package.json +2 -2
  120. package/plugin/index.d.ts +8 -2
  121. package/web-types.json +349 -155
@@ -22,7 +22,7 @@ declare const _default: import("vue").DefineComponent<{
22
22
  default: undefined;
23
23
  };
24
24
  /**
25
- * Whether to show the character count.
25
+ * Use in combination with `maxlength` to display a character count.
26
26
  */
27
27
  charCount: {
28
28
  type: PropType<boolean>;
@@ -36,14 +36,15 @@ declare const _default: import("vue").DefineComponent<{
36
36
  default: undefined;
37
37
  };
38
38
  /**
39
- * The error text for the form element.
39
+ * Provides a custom error message. Any current error state will be overridden.
40
40
  */
41
41
  errorText: {
42
42
  type: PropType<string>;
43
43
  default: undefined;
44
44
  };
45
45
  /**
46
- * The helper text for the form element.
46
+ * Provides additional information to help the user enter the correct information.
47
+ * To add HTML to the helper text, use the helper-text slot instead.
47
48
  */
48
49
  helperText: {
49
50
  type: PropType<string>;
@@ -58,7 +59,7 @@ declare const _default: import("vue").DefineComponent<{
58
59
  default: undefined;
59
60
  };
60
61
  /**
61
- * The initial value of the form. This value sets the `value` property
62
+ * The default value of the element. This value sets the `value` property
62
63
  * only when the `value` property has not been explicitly set.
63
64
  */
64
65
  initialValue: {
@@ -162,7 +163,7 @@ declare const _default: import("vue").DefineComponent<{
162
163
  default: undefined;
163
164
  };
164
165
  /**
165
- * The success text for the form element.
166
+ * Provides a custom success message. Any current error state will be overridden.
166
167
  */
167
168
  successText: {
168
169
  type: PropType<string>;
@@ -176,22 +177,14 @@ declare const _default: import("vue").DefineComponent<{
176
177
  default: undefined;
177
178
  };
178
179
  /**
179
- * The current value of the element. This property serves as a mechanism
180
- * to set the `value` property through both property assignment and the
181
- * .setAttribute() method. This is useful for setting the field's value
182
- * in UI libraries that bind data through the .setAttribute() API
183
- * and don't support IDL attribute binding.
180
+ * The current value of the element.
184
181
  */
185
182
  value: {
186
183
  type: PropType<string>;
187
184
  default: undefined;
188
185
  };
189
186
  /**
190
- * The current value of the element. This property serves as a mechanism
191
- * to set the `value` property through both property assignment and the
192
- * .setAttribute() method. This is useful for setting the field's value
193
- * in UI libraries that bind data through the .setAttribute() API
194
- * and don't support IDL attribute binding.
187
+ * The current value of the element.
195
188
  */
196
189
  modelValue: {
197
190
  type: PropType<string>;
@@ -201,7 +194,16 @@ declare const _default: import("vue").DefineComponent<{
201
194
  componentName: import("vue").Ref<string>;
202
195
  element: import("vue").Ref<VwcTextFieldElement | null>;
203
196
  }, unknown, {}, {
197
+ /**
198
+ * Return the current validity of the element.
199
+ */
200
+ checkValidity(): boolean;
204
201
  focus(): unknown;
202
+ /**
203
+ * Return the current validity of the element.
204
+ * If false, fires an invalid event at the element.
205
+ */
206
+ reportValidity(): boolean;
205
207
  /**
206
208
  * Selects all the text in the text field
207
209
  */
@@ -310,7 +312,7 @@ declare const _default: import("vue").DefineComponent<{
310
312
  default: undefined;
311
313
  };
312
314
  /**
313
- * Whether to show the character count.
315
+ * Use in combination with `maxlength` to display a character count.
314
316
  */
315
317
  charCount: {
316
318
  type: PropType<boolean>;
@@ -324,14 +326,15 @@ declare const _default: import("vue").DefineComponent<{
324
326
  default: undefined;
325
327
  };
326
328
  /**
327
- * The error text for the form element.
329
+ * Provides a custom error message. Any current error state will be overridden.
328
330
  */
329
331
  errorText: {
330
332
  type: PropType<string>;
331
333
  default: undefined;
332
334
  };
333
335
  /**
334
- * The helper text for the form element.
336
+ * Provides additional information to help the user enter the correct information.
337
+ * To add HTML to the helper text, use the helper-text slot instead.
335
338
  */
336
339
  helperText: {
337
340
  type: PropType<string>;
@@ -346,7 +349,7 @@ declare const _default: import("vue").DefineComponent<{
346
349
  default: undefined;
347
350
  };
348
351
  /**
349
- * The initial value of the form. This value sets the `value` property
352
+ * The default value of the element. This value sets the `value` property
350
353
  * only when the `value` property has not been explicitly set.
351
354
  */
352
355
  initialValue: {
@@ -450,7 +453,7 @@ declare const _default: import("vue").DefineComponent<{
450
453
  default: undefined;
451
454
  };
452
455
  /**
453
- * The success text for the form element.
456
+ * Provides a custom success message. Any current error state will be overridden.
454
457
  */
455
458
  successText: {
456
459
  type: PropType<string>;
@@ -464,22 +467,14 @@ declare const _default: import("vue").DefineComponent<{
464
467
  default: undefined;
465
468
  };
466
469
  /**
467
- * The current value of the element. This property serves as a mechanism
468
- * to set the `value` property through both property assignment and the
469
- * .setAttribute() method. This is useful for setting the field's value
470
- * in UI libraries that bind data through the .setAttribute() API
471
- * and don't support IDL attribute binding.
470
+ * The current value of the element.
472
471
  */
473
472
  value: {
474
473
  type: PropType<string>;
475
474
  default: undefined;
476
475
  };
477
476
  /**
478
- * The current value of the element. This property serves as a mechanism
479
- * to set the `value` property through both property assignment and the
480
- * .setAttribute() method. This is useful for setting the field's value
481
- * in UI libraries that bind data through the .setAttribute() API
482
- * and don't support IDL attribute binding.
477
+ * The current value of the element.
483
478
  */
484
479
  modelValue: {
485
480
  type: PropType<string>;
@@ -559,9 +554,9 @@ declare const _default: import("vue").DefineComponent<{
559
554
  scale: "condensed" | "normal";
560
555
  pattern: string;
561
556
  autoComplete: string;
562
- charCount: boolean;
563
557
  maxlength: number;
564
558
  minlength: number;
559
+ charCount: boolean;
565
560
  spellcheck: boolean;
566
561
  inputmode: string;
567
562
  }, SlotsType<{
@@ -85,11 +85,17 @@ export interface VTimePickerProps {
85
85
  */
86
86
  disabled?: boolean;
87
87
  /**
88
- * The error text for the form element.
88
+ * Provides a custom error message. Any current error state will be overridden.
89
89
  */
90
90
  errorText?: string;
91
91
  /**
92
- * The initial value of the date-picker.
92
+ * Provides additional information to help the user enter the correct information.
93
+ * To add HTML to the helper text, use the helper-text slot instead.
94
+ */
95
+ helperText?: string;
96
+ /**
97
+ * The default value of the element. This value sets the `value` property
98
+ * only when the `value` property has not been explicitly set.
93
99
  */
94
100
  initialValue?: string;
95
101
  /**
@@ -125,11 +131,11 @@ export interface VTimePickerProps {
125
131
  */
126
132
  secondsStep?: number;
127
133
  /**
128
- * The current value of the date-picker.
134
+ * The current value of the element.
129
135
  */
130
136
  value?: string;
131
137
  /**
132
- * The current value of the date-picker.
138
+ * The current value of the element.
133
139
  */
134
140
  modelValue?: string;
135
141
  /**
@@ -16,14 +16,23 @@ declare const _default: import("vue/types/v3-define-component").DefineComponent<
16
16
  default: undefined;
17
17
  };
18
18
  /**
19
- * The error text for the form element.
19
+ * Provides a custom error message. Any current error state will be overridden.
20
20
  */
21
21
  errorText: {
22
22
  type: PropType<string>;
23
23
  default: undefined;
24
24
  };
25
25
  /**
26
- * The initial value of the date-picker.
26
+ * Provides additional information to help the user enter the correct information.
27
+ * To add HTML to the helper text, use the helper-text slot instead.
28
+ */
29
+ helperText: {
30
+ type: PropType<string>;
31
+ default: undefined;
32
+ };
33
+ /**
34
+ * The default value of the element. This value sets the `value` property
35
+ * only when the `value` property has not been explicitly set.
27
36
  */
28
37
  initialValue: {
29
38
  type: PropType<string>;
@@ -86,14 +95,14 @@ declare const _default: import("vue/types/v3-define-component").DefineComponent<
86
95
  default: undefined;
87
96
  };
88
97
  /**
89
- * The current value of the date-picker.
98
+ * The current value of the element.
90
99
  */
91
100
  value: {
92
101
  type: PropType<string>;
93
102
  default: undefined;
94
103
  };
95
104
  /**
96
- * The current value of the date-picker.
105
+ * The current value of the element.
97
106
  */
98
107
  modelValue: {
99
108
  type: PropType<string>;
@@ -102,7 +111,17 @@ declare const _default: import("vue/types/v3-define-component").DefineComponent<
102
111
  }, {
103
112
  componentName: import("vue").Ref<string>;
104
113
  element: import("vue").Ref<VwcTimePickerElement | null>;
105
- }, import("vue").Data, {}, {}, import("vue/types/v3-component-options").ComponentOptionsMixin, import("vue/types/v3-component-options").ComponentOptionsMixin, ("blur" | "change" | "click" | "focus" | "input" | "keydown" | "keyup" | "update:modelValue")[], string, Readonly<import("vue").ExtractPropTypes<{
114
+ }, import("vue").Data, {}, {
115
+ /**
116
+ * Return the current validity of the element.
117
+ */
118
+ checkValidity(): boolean;
119
+ /**
120
+ * Return the current validity of the element.
121
+ * If false, fires an invalid event at the element.
122
+ */
123
+ reportValidity(): boolean;
124
+ }, import("vue/types/v3-component-options").ComponentOptionsMixin, import("vue/types/v3-component-options").ComponentOptionsMixin, ("blur" | "change" | "click" | "focus" | "input" | "keydown" | "keyup" | "update:modelValue")[], string, Readonly<import("vue").ExtractPropTypes<{
106
125
  /**
107
126
  * Forces a 12h or 24h clock to be used.
108
127
  */
@@ -118,14 +137,23 @@ declare const _default: import("vue/types/v3-define-component").DefineComponent<
118
137
  default: undefined;
119
138
  };
120
139
  /**
121
- * The error text for the form element.
140
+ * Provides a custom error message. Any current error state will be overridden.
122
141
  */
123
142
  errorText: {
124
143
  type: PropType<string>;
125
144
  default: undefined;
126
145
  };
127
146
  /**
128
- * The initial value of the date-picker.
147
+ * Provides additional information to help the user enter the correct information.
148
+ * To add HTML to the helper text, use the helper-text slot instead.
149
+ */
150
+ helperText: {
151
+ type: PropType<string>;
152
+ default: undefined;
153
+ };
154
+ /**
155
+ * The default value of the element. This value sets the `value` property
156
+ * only when the `value` property has not been explicitly set.
129
157
  */
130
158
  initialValue: {
131
159
  type: PropType<string>;
@@ -188,14 +216,14 @@ declare const _default: import("vue/types/v3-define-component").DefineComponent<
188
216
  default: undefined;
189
217
  };
190
218
  /**
191
- * The current value of the date-picker.
219
+ * The current value of the element.
192
220
  */
193
221
  value: {
194
222
  type: PropType<string>;
195
223
  default: undefined;
196
224
  };
197
225
  /**
198
- * The current value of the date-picker.
226
+ * The current value of the element.
199
227
  */
200
228
  modelValue: {
201
229
  type: PropType<string>;
@@ -210,6 +238,7 @@ declare const _default: import("vue/types/v3-define-component").DefineComponent<
210
238
  required: boolean;
211
239
  modelValue: string;
212
240
  errorText: string;
241
+ helperText: string;
213
242
  readonly: boolean;
214
243
  max: string;
215
244
  min: string;
@@ -17,14 +17,23 @@ declare const _default: import("vue").DefineComponent<{
17
17
  default: undefined;
18
18
  };
19
19
  /**
20
- * The error text for the form element.
20
+ * Provides a custom error message. Any current error state will be overridden.
21
21
  */
22
22
  errorText: {
23
23
  type: PropType<string>;
24
24
  default: undefined;
25
25
  };
26
26
  /**
27
- * The initial value of the date-picker.
27
+ * Provides additional information to help the user enter the correct information.
28
+ * To add HTML to the helper text, use the helper-text slot instead.
29
+ */
30
+ helperText: {
31
+ type: PropType<string>;
32
+ default: undefined;
33
+ };
34
+ /**
35
+ * The default value of the element. This value sets the `value` property
36
+ * only when the `value` property has not been explicitly set.
28
37
  */
29
38
  initialValue: {
30
39
  type: PropType<string>;
@@ -87,14 +96,14 @@ declare const _default: import("vue").DefineComponent<{
87
96
  default: undefined;
88
97
  };
89
98
  /**
90
- * The current value of the date-picker.
99
+ * The current value of the element.
91
100
  */
92
101
  value: {
93
102
  type: PropType<string>;
94
103
  default: undefined;
95
104
  };
96
105
  /**
97
- * The current value of the date-picker.
106
+ * The current value of the element.
98
107
  */
99
108
  modelValue: {
100
109
  type: PropType<string>;
@@ -103,7 +112,17 @@ declare const _default: import("vue").DefineComponent<{
103
112
  }, {
104
113
  componentName: import("vue").Ref<string>;
105
114
  element: import("vue").Ref<VwcTimePickerElement | null>;
106
- }, unknown, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
115
+ }, unknown, {}, {
116
+ /**
117
+ * Return the current validity of the element.
118
+ */
119
+ checkValidity(): boolean;
120
+ /**
121
+ * Return the current validity of the element.
122
+ * If false, fires an invalid event at the element.
123
+ */
124
+ reportValidity(): boolean;
125
+ }, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
107
126
  /**
108
127
  * Fires when the element loses focus.
109
128
  * @type {FocusEvent}
@@ -202,14 +221,23 @@ declare const _default: import("vue").DefineComponent<{
202
221
  default: undefined;
203
222
  };
204
223
  /**
205
- * The error text for the form element.
224
+ * Provides a custom error message. Any current error state will be overridden.
206
225
  */
207
226
  errorText: {
208
227
  type: PropType<string>;
209
228
  default: undefined;
210
229
  };
211
230
  /**
212
- * The initial value of the date-picker.
231
+ * Provides additional information to help the user enter the correct information.
232
+ * To add HTML to the helper text, use the helper-text slot instead.
233
+ */
234
+ helperText: {
235
+ type: PropType<string>;
236
+ default: undefined;
237
+ };
238
+ /**
239
+ * The default value of the element. This value sets the `value` property
240
+ * only when the `value` property has not been explicitly set.
213
241
  */
214
242
  initialValue: {
215
243
  type: PropType<string>;
@@ -272,14 +300,14 @@ declare const _default: import("vue").DefineComponent<{
272
300
  default: undefined;
273
301
  };
274
302
  /**
275
- * The current value of the date-picker.
303
+ * The current value of the element.
276
304
  */
277
305
  value: {
278
306
  type: PropType<string>;
279
307
  default: undefined;
280
308
  };
281
309
  /**
282
- * The current value of the date-picker.
310
+ * The current value of the element.
283
311
  */
284
312
  modelValue: {
285
313
  type: PropType<string>;
@@ -345,6 +373,7 @@ declare const _default: import("vue").DefineComponent<{
345
373
  required: boolean;
346
374
  modelValue: string;
347
375
  errorText: string;
376
+ helperText: string;
348
377
  readonly: boolean;
349
378
  max: string;
350
379
  min: string;
@@ -237,7 +237,7 @@ declare const _default: import("vue").DefineComponent<{
237
237
  selected: boolean;
238
238
  }, SlotsType<{
239
239
  /**
240
- * Add an icon to the component.
240
+ * The preferred way to add an icon to the component.
241
241
  */
242
242
  icon: Record<string, never>;
243
243
  /**