@progress/kendo-angular-dropdowns 19.1.1 → 19.1.2-develop.2

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 (62) hide show
  1. package/autocomplete/autocomplete.component.d.ts +62 -53
  2. package/autocomplete/autocomplete.module.d.ts +9 -1
  3. package/comboboxes/combobox-column/column-cell-template.directive.d.ts +6 -6
  4. package/comboboxes/combobox-column/column-header-template.directive.d.ts +5 -4
  5. package/comboboxes/combobox-column/combobox-column.component.d.ts +21 -17
  6. package/comboboxes/combobox-column/util.d.ts +7 -4
  7. package/comboboxes/combobox.component.d.ts +28 -45
  8. package/comboboxes/combobox.module.d.ts +11 -2
  9. package/comboboxes/multicolumncombobox.component.d.ts +12 -2
  10. package/dropdownlist/dropdownlist.component.d.ts +53 -75
  11. package/dropdownlist/dropdownlist.module.d.ts +29 -11
  12. package/dropdowns.module.d.ts +8 -20
  13. package/dropdowntrees/checked-state/base-check.directive.d.ts +4 -7
  14. package/dropdowntrees/checked-state/check-all.directive.d.ts +4 -7
  15. package/dropdowntrees/checked-state/check.directive.d.ts +6 -10
  16. package/dropdowntrees/checked-state/checkable-settings.d.ts +2 -4
  17. package/dropdowntrees/checked-state/checked-item.d.ts +2 -2
  18. package/dropdowntrees/data-binding/dropdowntree/flat-binding.directive.d.ts +3 -3
  19. package/dropdowntrees/data-binding/dropdowntree/hierarchy-binding.directive.d.ts +2 -2
  20. package/dropdowntrees/data-binding/multiselecttree/flat-binding.directive.d.ts +3 -3
  21. package/dropdowntrees/data-binding/multiselecttree/hierarchy-binding.directive.d.ts +2 -2
  22. package/dropdowntrees/dropdowntree.component.d.ts +3 -3
  23. package/dropdowntrees/dropdowntrees.module.d.ts +1 -0
  24. package/dropdowntrees/expanded-state/expand.directive.d.ts +1 -1
  25. package/dropdowntrees/multiselecttree.component.d.ts +139 -120
  26. package/dropdowntrees/summary-tag/summary-tag.directive.d.ts +8 -6
  27. package/dropdowntrees/templates/node-template.directive.d.ts +4 -3
  28. package/esm2022/autocomplete/autocomplete.component.mjs +62 -53
  29. package/esm2022/autocomplete/autocomplete.module.mjs +9 -1
  30. package/esm2022/comboboxes/combobox-column/column-cell-template.directive.mjs +6 -6
  31. package/esm2022/comboboxes/combobox-column/column-header-template.directive.mjs +5 -4
  32. package/esm2022/comboboxes/combobox-column/combobox-column.component.mjs +21 -17
  33. package/esm2022/comboboxes/combobox-column/util.mjs +10 -5
  34. package/esm2022/comboboxes/combobox.component.mjs +28 -45
  35. package/esm2022/comboboxes/combobox.module.mjs +11 -2
  36. package/esm2022/comboboxes/multicolumncombobox.component.mjs +12 -2
  37. package/esm2022/dropdownlist/dropdownlist.component.mjs +53 -75
  38. package/esm2022/dropdownlist/dropdownlist.module.mjs +29 -11
  39. package/esm2022/dropdowns.module.mjs +8 -20
  40. package/esm2022/dropdowntrees/checked-state/base-check.directive.mjs +1 -1
  41. package/esm2022/dropdowntrees/checked-state/check-all.directive.mjs +4 -7
  42. package/esm2022/dropdowntrees/checked-state/check.directive.mjs +6 -10
  43. package/esm2022/dropdowntrees/data-binding/dropdowntree/flat-binding.directive.mjs +3 -3
  44. package/esm2022/dropdowntrees/data-binding/dropdowntree/hierarchy-binding.directive.mjs +2 -2
  45. package/esm2022/dropdowntrees/data-binding/multiselecttree/flat-binding.directive.mjs +3 -3
  46. package/esm2022/dropdowntrees/data-binding/multiselecttree/hierarchy-binding.directive.mjs +2 -2
  47. package/esm2022/dropdowntrees/dropdowntree.component.mjs +3 -3
  48. package/esm2022/dropdowntrees/dropdowntrees.module.mjs +1 -0
  49. package/esm2022/dropdowntrees/expanded-state/expand.directive.mjs +1 -1
  50. package/esm2022/dropdowntrees/multiselecttree.component.mjs +139 -120
  51. package/esm2022/dropdowntrees/summary-tag/summary-tag.directive.mjs +8 -6
  52. package/esm2022/dropdowntrees/templates/node-template.directive.mjs +4 -3
  53. package/esm2022/multiselect/multiselect.component.mjs +119 -163
  54. package/esm2022/multiselect/multiselect.module.mjs +13 -5
  55. package/esm2022/multiselect/summary-tag.directive.mjs +6 -4
  56. package/esm2022/package-metadata.mjs +2 -2
  57. package/fesm2022/progress-kendo-angular-dropdowns.mjs +571 -576
  58. package/multiselect/multiselect.component.d.ts +119 -163
  59. package/multiselect/multiselect.module.d.ts +13 -5
  60. package/multiselect/summary-tag.directive.d.ts +6 -4
  61. package/package.json +10 -10
  62. package/schematics/ngAdd/index.js +2 -2
@@ -45,17 +45,28 @@ import * as i0 from "@angular/core";
45
45
  /**
46
46
  * Represents the [Kendo UI MultiSelect component for Angular]({% slug overview_multiselect %}).
47
47
  *
48
+ * Use the `MultiSelectComponent` to show a dropdown list where users can select multiple items.
49
+ * [See example]({% slug overview_multiselect %}).
50
+ *
48
51
  * @example
49
- * ```ts
50
- * _@Component({
51
- * selector: 'my-app',
52
- * template: `
53
- * <kendo-multiselect [data]="listItems">
54
- * </kendo-multiselect>
55
- * `
52
+ * ```typescript
53
+ * @Component({
54
+ * selector: 'my-app',
55
+ * template: `
56
+ * <kendo-multiselect
57
+ * [data]="listItems"
58
+ * textField="name"
59
+ * valueField="id"
60
+ * placeholder="Select items...">
61
+ * </kendo-multiselect>
62
+ * `
56
63
  * })
57
- * class AppComponent {
58
- * public listItems: Array<string> = ["Item 1", "Item 2", "Item 3", "Item 4"];
64
+ * export class AppComponent {
65
+ * public listItems = [
66
+ * { id: 1, name: "Item 1" },
67
+ * { id: 2, name: "Item 2" },
68
+ * { id: 3, name: "Item 3" }
69
+ * ];
59
70
  * }
60
71
  * ```
61
72
  */
@@ -115,13 +126,13 @@ export declare class MultiSelectComponent implements OnDestroy, OnChanges, OnIni
115
126
  */
116
127
  get formControl(): FormControl;
117
128
  /**
118
- * Focuses a specific item of the MultiSelect based on a provided index.
119
- * If there is a custom item it is positioned at index -1.
120
- * If null or invalid index is provided the focus will be removed.
129
+ * Focuses a specific item in the MultiSelect based on the provided index.
130
+ * Sets the index to `-1` to focus the custom item if available.
131
+ * Pass `null` or an invalid index to remove focus.
121
132
  */
122
133
  focusItemAt(index: number): void;
123
134
  /**
124
- * Focuses the MultiSelect.
135
+ * Focuses the MultiSelect input element.
125
136
  */
126
137
  focus(): void;
127
138
  /**
@@ -129,7 +140,7 @@ export declare class MultiSelectComponent implements OnDestroy, OnChanges, OnIni
129
140
  */
130
141
  handleInputFocus(): void;
131
142
  /**
132
- * Blurs the MultiSelect.
143
+ * Removes focus from the MultiSelect input element.
133
144
  */
134
145
  blur(): void;
135
146
  /**
@@ -163,46 +174,47 @@ export declare class MultiSelectComponent implements OnDestroy, OnChanges, OnIni
163
174
  */
164
175
  focusableId: string;
165
176
  /**
166
- * Determines whether to close the options list of the MultiSelect after the item selection is finished
167
- * ([see example]({% slug openstate_multiselect %}#toc-keeping-the-options-list-open-while-on-focus)).
177
+ * Controls whether the options list closes after item selection finishes ([see example]({% slug openstate_multiselect %}#toc-keeping-the-options-list-open-while-on-focus)).
178
+ * Set to `false` to keep the list open while the component has focus.
179
+ *
168
180
  * @default true
169
181
  */
170
182
  autoClose: boolean;
171
183
  /**
172
- * Sets and gets the loading state of the MultiSelect.
184
+ * Controls the loading state of the MultiSelect.
185
+ * Set to `true` to display the loading indicator.
173
186
  */
174
187
  loading: boolean;
175
188
  /**
176
- * Sets the data of the MultiSelect.
177
- *
178
- * > The data has to be provided in an array-like list of items.
189
+ * Sets the data source for the MultiSelect.
190
+ * Provide the data as an array of items.
179
191
  */
180
192
  set data(data: any[]);
181
193
  get data(): any[];
182
194
  /**
183
- * Sets the value of the MultiSelect. It can be either of the primitive (string, numbers) or of the complex (objects) type.
184
- * To define the type, use the `valuePrimitive` option.
185
- *
186
- * > All selected values which are not present in the source are ignored.
195
+ * Sets the selected values of the MultiSelect.
196
+ * Accepts primitive values (strings, numbers) or complex objects.
197
+ * Use the `valuePrimitive` property to define the value type.
198
+ * > The component ignores selected values that don't exist in the data source.
187
199
  */
188
200
  set value(values: any[]);
189
201
  get value(): any[];
190
202
  /**
191
- * Sets the data item field that represents the item value.
192
- * If the data contains only primitive values, do not define it.
193
- *
194
- * > The `valueField` property can be set to point to a nested property value - e.g. `category.id`.
203
+ * Sets the field name that contains the item value in the data objects.
204
+ * Skip this property when your data contains only primitive values.
205
+ * Supports nested property paths like `category.id`.
195
206
  */
196
207
  valueField: string;
197
208
  /**
198
- * Sets the data item field that represents the item text.
199
- * If the data contains only primitive values, do not define it.
200
- *
201
- * > The `textField` property can be set to point to a nested property value - e.g. `category.name`.
209
+ * Sets the field name that contains the item text in the data objects.
210
+ * Skip this property when your data contains only primitive values.
211
+ * Supports nested property paths like `category.name`.
202
212
  */
203
213
  textField: string;
204
214
  /**
205
- * Specifies the [`tabindex`](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/tabindex) of the component.
215
+ * Sets the [`tabindex`](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/tabindex) attribute of the component.
216
+ *
217
+ * @default 0
206
218
  */
207
219
  tabindex: number;
208
220
  /**
@@ -213,250 +225,195 @@ export declare class MultiSelectComponent implements OnDestroy, OnChanges, OnIni
213
225
  /**
214
226
  * Sets the size of the component.
215
227
  *
216
- * The possible values are:
217
- * * `small`
218
- * * `medium` (default)
219
- * * `large`
220
- * * `none`
221
- *
228
+ * @default "medium"
222
229
  */
223
230
  set size(size: DropDownSize);
224
231
  get size(): DropDownSize;
225
232
  /**
226
233
  * Sets the border radius of the component.
227
234
  *
228
- * The possible values are:
229
- * * `small`
230
- * * `medium` (default)
231
- * * `large`
232
- * * `full`
233
- * * `none`
234
- *
235
+ * @default "medium"
235
236
  */
236
237
  set rounded(rounded: DropDownRounded);
237
238
  get rounded(): DropDownRounded;
238
239
  /**
239
- * Sets the fillMode of the component.
240
- *
241
- * The possible values are:
242
- * * `flat`
243
- * * `solid` (default)
244
- * * `outline`
245
- * * `none`
240
+ * Sets the fill mode of the component.
246
241
  *
242
+ * @default "solid"
247
243
  */
248
244
  set fillMode(fillMode: DropDownFillMode);
249
245
  get fillMode(): DropDownFillMode;
250
246
  /**
251
- * The hint which is displayed when the component is empty.
247
+ * Sets the placeholder text for the MultiSelect input.
252
248
  * When the values are selected, it disappears.
253
249
  */
254
250
  set placeholder(text: string);
255
251
  get placeholder(): string;
256
252
  /**
257
- * Enables or disables the adaptive mode. By default the adaptive rendering is disabled.
253
+ * Controls the adaptive mode behavior of the component.
254
+ * Set to `auto` to enable adaptive rendering on small screens.
255
+ *
256
+ * @default "none"
258
257
  */
259
258
  adaptiveMode: AdaptiveMode;
260
259
  /**
261
- * Sets the title of the ActionSheet that is rendered instead of the Popup when using small screen devices.
262
- * By default the ActionSheet title uses the text provided for the label of the MultiSelect.
260
+ * Sets the title text for the ActionSheet in adaptive mode.
261
+ * Uses the component's label text by default.
263
262
  */
264
263
  adaptiveTitle: string;
265
264
  /**
266
- * Sets the subtitle of the ActionSheet that is rendered instead of the Popup when using small screen devices.
267
- * By default the ActionSheet does not render a subtitle.
268
- */
265
+ * Sets the subtitle text for the ActionSheet in adaptive mode.
266
+ * No subtitle appears by default.
267
+ */
269
268
  adaptiveSubtitle: string;
270
269
  /**
271
270
  * @hidden
272
271
  */
273
272
  get isAdaptiveModeEnabled(): boolean;
274
273
  /**
275
- * Sets the disabled state of the component. To learn how to disable the component in reactive forms, refer to the article on [Forms Support](slug:formssupport_multiselect#toc-managing-the-multiselect-disabled-state-in-reactive-forms).
274
+ * Controls the disabled state of the component.
275
+ * When true, sets the component to disabled.
276
+ * To learn how to disable the component in reactive forms, refer to the article on [Forms Support](slug:formssupport_multiselect#toc-managing-the-multiselect-disabled-state-in-reactive-forms).
277
+ *
278
+ * @default false
276
279
  */
277
280
  disabled: boolean;
278
281
  /**
279
- * Defines a Boolean function that is executed for each data item in the component
280
- * ([see examples]({% slug disableditems_multiselect %})). Determines whether the item will be disabled.
282
+ * Determines wether the item will be disabled. The function is executed for each data item.
283
+ * The function receives the item as an argument and should return `true` if the item is disabled.
281
284
  */
282
285
  set itemDisabled(fn: ItemDisabledFn);
283
286
  /**
284
- * Specifies whether checkboxes will be rendered before each item in the popup list.
287
+ * Controls whether checkboxes appear before each item in the popup list.
288
+ * Pass `true` to enable checkboxes or an object to configure checkbox settings.
289
+ *
290
+ * @default false
285
291
  */
286
292
  set checkboxes(settings: MultiSelectCheckableSettings | boolean);
287
293
  get checkboxes(): MultiSelectCheckableSettings;
288
294
  /**
289
- * Sets the read-only state of the component.
295
+ * Controls the read-only state of the component.
296
+ * When true, the component does not allow user input or selection changes.
290
297
  *
291
298
  * @default false
292
299
  */
293
300
  readonly: boolean;
294
301
  /**
295
- * Enables the [filtering]({% slug filtering_multiselect %}) functionality of the MultiSelect.
302
+ * Enables the filtering functionality of the MultiSelect.
303
+ * Set to `true` to allow users to filter the data by typing.
304
+ *
305
+ * @default false
296
306
  */
297
307
  filterable: boolean;
298
308
  /**
299
- * Enables the [virtualization]({% slug virtualization_multiselect %}) functionality.
309
+ * Enables virtualization to improve performance with large datasets.
310
+ * Pass `true` for default settings or an object to configure virtualization.
300
311
  */
301
312
  set virtual(settings: boolean | VirtualizationSettings);
302
313
  get virtual(): VirtualizationSettings;
303
314
  /**
304
- * Configures the popup of the MultiSelect.
305
- *
306
- * The available options are:
307
- * - `animate: Boolean`&mdash;Controls the popup animation. By default, the open and close animations are enabled.
308
- * - `width: Number | String`&mdash;Sets the width of the popup container. By default, the width of the host element is used. If set to `auto`, the component automatically adjusts the width of the popup and no item labels are wrapped. The `auto` mode is not supported when virtual scrolling is enabled.
309
- * - `height: Number`&mdash;Sets the height of the popup container.
310
- * - `popupClass: String`&mdash;Specifies a list of CSS classes that are used to style the popup.
311
- * - `appendTo: "root" | "component" | ViewContainerRef`&mdash;Specifies the component to which the popup will be appended.
315
+ * Configures the popup appearance and behavior.
316
+ * Set properties like `animate`, `width`, `height`, `popupClass`, and `appendTo`.
312
317
  */
313
318
  set popupSettings(settings: PopupSettings);
314
319
  get popupSettings(): PopupSettings;
315
320
  /**
316
- * Sets the height of the options list in the popup. By default, `listHeight` is 200px.
321
+ * Sets the height of the options list in the popup.
322
+ * This affects only the list height, not the entire popup container.
317
323
  *
318
- * > The `listHeight` property affects only the list of options and not the whole popup container.
319
- * > To set the height of the popup container, use `popupSettings.height`.
320
- *
321
- * > When using `adaptiveMode` and the screen size is `small` or `medium` the `listHeight` property is set to null.
324
+ * @default 200
322
325
  */
323
326
  set listHeight(_listHeight: number);
324
327
  get listHeight(): number;
325
328
  private _listHeight;
326
329
  /**
327
- * Specifies the type of the selected value.
328
- * If set to `true`, the selected value has to be of the primitive type
329
- * ([more information and example]({% slug valuebinding_multiselect %}#toc-primitive-values-from-object-fields)).
330
+ * Controls the type of selected values.
331
+ * Set to `true` for primitive values or `false` for object references.
332
+ * When undefined, the component determines the type based on `valueField`.
330
333
  */
331
334
  set valuePrimitive(isPrimitive: boolean);
332
335
  get valuePrimitive(): boolean;
333
336
  /**
334
- * If set to `true`, renders a button on hovering over the component.
335
- * Clicking this button resets the value of the component to an empty array and triggers the `change` event.
337
+ * Controls whether a clear button appears when items are selected.
338
+ * Set to `true` to show the button that clears all selections.
339
+ *
340
+ * @default true
336
341
  */
337
342
  clearButton: boolean;
338
343
  /**
339
- * A user-defined callback function which receives an array of selected data items and maps them to an array of tags
340
- * ([see examples]({% slug summarytagmode_multiselect %}#toc-rendering-of-tags)).
344
+ * Sets a function that transforms selected data items into display tags.
345
+ * Use this to customize how selected items appear as tags.
341
346
  *
342
- * @param { Any[] } dataItems - The selected data items from the list.
343
- * @returns { Any[] } - The tags that will be rendered by the component.
347
+ * @default (tags) => tags || []
344
348
  */
345
349
  tagMapper: (tags: any) => any;
346
350
  /**
347
- * Specifies whether the MultiSelect allows user-defined values that are not present in the dataset
348
- * ([more information and examples]({% slug custom_values_multiselect %})).
349
- * Defaults to `false`.
351
+ * Allows users to add custom values not present in the data source.
352
+ * Set to `true` to enable custom value input.
353
+ * This feature is not available in adaptive mode.
350
354
  *
351
- * The feature is not available when using adaptive mode.
355
+ * @default false
352
356
  */
353
357
  allowCustom: boolean;
354
358
  /**
355
- * A user-defined callback function which returns normalized custom values.
356
- * Typically used when the data items are different from type `string`.
357
- *
358
- * @param { Any } value - The custom value that is defined by the user.
359
- * @returns { Any }
360
- *
361
- * @example
362
- * ```ts
363
- * import { map } from 'rxjs/operators';
364
- *
365
- * _@Component({
366
- * selector: 'my-app',
367
- * template: `
368
- * <kendo-multiselect
369
- * [allowCustom]="true"
370
- * [data]="listItems"
371
- * textField="text"
372
- * valueField="value"
373
- * [valueNormalizer]="valueNormalizer"
374
- * (valueChange)="onValueChange($event)"
375
- * >
376
- * </kendo-multiselect>
377
- * `
378
- * })
379
- *
380
- * class AppComponent {
381
- * public listItems: Array<{ text: string, value: number }> = [
382
- * { text: "Small", value: 1 },
383
- * { text: "Medium", value: 2 },
384
- * { text: "Large", value: 3 }
385
- * ];
386
- *
387
- * public onValueChange(value) {
388
- * console.log("valueChange : ", value);
389
- * }
390
- *
391
- * public valueNormalizer = (text$: Observable<string>) => text$.pipe(map((text: string) => {
392
- * return {
393
- * value: Math.floor(Math.random() * (1000 - 100) + 1000), //generate unique valueField
394
- * text: text };
395
- * }));
396
- *
397
- * }
398
- * ```
359
+ * Sets a function that normalizes custom user input into data items.
360
+ * Use this when your data items differ from simple strings.
399
361
  */
400
362
  valueNormalizer: (text: Observable<string>) => Observable<any>;
401
363
  /**
402
- * Sets the HTML attributes of the inner focusable input element. Attributes which are essential for certain component functionalities cannot be changed.
364
+ * Sets HTML attributes for the inner input element.
365
+ * You cannot change attributes essential for component functionality.
403
366
  */
404
367
  inputAttributes: {
405
368
  [key: string]: string;
406
369
  };
407
370
  /**
408
- * Fires each time the user types in the input field.
409
- * You can filter the source based on the passed filtration value.
371
+ * Fires when the user types in the input field.
372
+ * Use this event to filter the data source based on user input.
410
373
  */
411
374
  filterChange: EventEmitter<string>;
412
375
  /**
413
- * Fires each time the value is changed&mdash;
414
- * when the component is blurred or the value is cleared through the **Clear** button
415
- * ([see example](slug:events_multiselect)).
416
- * When the value of the component is programmatically changed to `ngModel` or `formControl`
417
- * through its API or form binding, the `valueChange` event is not triggered because it
418
- * might cause a mix-up with the built-in `valueChange` mechanisms of the `ngModel` or `formControl` bindings.
376
+ * Fires when the value changes through user interaction or the Clear button.
377
+ * This event does not fire when you change the value programmatically.
419
378
  */
420
379
  valueChange: EventEmitter<any[]>;
421
380
  /**
422
- * Fires each time the popup is about to open
423
- * ([see example]({% slug openstate_multiselect %}#toc-preventing-opening-and-closing)).
424
- * This event is preventable. If you cancel it, the popup will remain closed.
381
+ * Fires before the popup opens.
382
+ * You can prevent the popup from opening by calling `preventDefault()` on the event.
425
383
  */
426
384
  open: EventEmitter<PreventableEvent>;
427
385
  /**
428
- * Fires after the popup has been opened.
386
+ * Fires after the popup opens completely.
429
387
  */
430
388
  opened: EventEmitter<any>;
431
389
  /**
432
- * Fires each time the popup is about to close
433
- * ([see example]({% slug openstate_multiselect %}#toc-preventing-opening-and-closing)).
434
- * This event is preventable. If you cancel it, the popup will remain open.
390
+ * Fires before the popup closes.
391
+ * You can prevent the popup from closing by calling `preventDefault()` on the event.
435
392
  */
436
393
  close: EventEmitter<PreventableEvent>;
437
394
  /**
438
- * Fires after the popup has been closed.
395
+ * Fires after the popup closes completely.
439
396
  */
440
397
  closed: EventEmitter<any>;
441
398
  /**
442
- * Fires each time the user focuses the MultiSelect.
399
+ * Fires when the user focuses the MultiSelect component.
443
400
  */
444
401
  onFocus: EventEmitter<any>;
445
402
  /**
446
- * Fires each time the MultiSelect gets blurred.
403
+ * Fires when the MultiSelect component loses focus.
447
404
  */
448
405
  onBlur: EventEmitter<any>;
449
406
  /**
450
- * Fires each time the user focuses the `input` element.
407
+ * Fires when the user focuses the input element inside the MultiSelect.
451
408
  */
452
409
  inputFocus: EventEmitter<any>;
453
410
  /**
454
- * Fires each time the `input` element gets blurred.
411
+ * Fires when the input element inside the MultiSelect loses focus.
455
412
  */
456
413
  inputBlur: EventEmitter<any>;
457
414
  /**
458
- * Fires each time a tag is about to be removed([see examples]({% slug summarytagmode_multiselecttree %}#toc-notifying-on-removing-group-tags)).
459
- * This event is preventable. If you cancel it, the tag will not be removed.
415
+ * Fires before a tag gets removed from the selection.
416
+ * You can prevent tag removal by calling `preventDefault()` on the event.
460
417
  */
461
418
  removeTag: EventEmitter<RemoveTagEvent>;
462
419
  container: ViewContainerRef;
@@ -580,9 +537,8 @@ export declare class MultiSelectComponent implements OnDestroy, OnChanges, OnIni
580
537
  */
581
538
  get isOpen(): boolean;
582
539
  /**
583
- * Resets the value of the MultiSelect.
584
- * If you use the `reset` method to clear the value of the component,
585
- * the model will not update automatically and the `selectionChange` and `valueChange` events will not be fired.
540
+ * Resets the MultiSelect by clearing the text and value.
541
+ * This method does not trigger the `selectionChange` and `valueChange` events.
586
542
  */
587
543
  reset(): void;
588
544
  /**
@@ -18,12 +18,11 @@ import * as i12 from "../common/filtering/filter.directive";
18
18
  import * as i13 from "../common/localization/custom-messages.component";
19
19
  import * as i14 from "@progress/kendo-angular-common";
20
20
  /**
21
+ * Required for adding all MultiSelect features in NgModule-based Angular applications.
21
22
  *
22
- * The exported package module.
23
- *
24
- * The package exports:
25
- * - `MultiSelectComponent`&mdash;The MultiSelect component class.
26
- * - `SummaryTagDirective`&mdash;The MultiSelect summary tag directive.
23
+ * This module exports all MultiSelect-related components and directives:
24
+ * - `MultiSelectComponent`&mdash;The main MultiSelect component class.
25
+ * - `SummaryTagDirective`&mdash;The summary tag directive for MultiSelect.
27
26
  * - `ItemTemplateDirective`&mdash;The item template directive.
28
27
  * - `CustomItemTemplateDirective`&mdash;The custom item template directive.
29
28
  * - `TagTemplateDirective`&mdash;The tag template directive.
@@ -38,6 +37,15 @@ import * as i14 from "@progress/kendo-angular-common";
38
37
  * - `FixedGroupTemplateDirective`&mdash;The fixed group template directive.
39
38
  * - `SuffixTemplateDirective`&mdash;The suffix template directive.
40
39
  * - `PrefixTemplateDirective`&mdash;The prefix template directive.
40
+ *
41
+ * ```ts
42
+ * import { MultiSelectModule } from '@progress/kendo-angular-dropdowns';
43
+ * @NgModule({
44
+ * imports: [ MultiSelectModule ],
45
+ * declarations: [ AppComponent ],
46
+ * bootstrap: [ AppComponent ],
47
+ * })
48
+ * ```
41
49
  */
42
50
  export declare class MultiSelectModule {
43
51
  static ɵfac: i0.ɵɵFactoryDeclaration<MultiSelectModule, never>;
@@ -6,9 +6,9 @@ import { OnChanges } from '@angular/core';
6
6
  import { MultiSelectComponent } from './multiselect.component';
7
7
  import * as i0 from "@angular/core";
8
8
  /**
9
- * A directive which configures the MultiSelect to show one single summary tag for all selected data items.
10
- * When a number is provided, the summary tag is displayed after the given amount of data items are selected
11
- * ([more information and examples]({% slug summarytagmode_multiselect %})).
9
+ * Configures the MultiSelect to show one summary tag for all selected items.
10
+ * Set a number to display the summary tag after the respective number of items are selected.
11
+ * [See example]({% slug summarytagmode_multiselect %}).
12
12
  *
13
13
  * @example
14
14
  * ```ts-no-run
@@ -23,7 +23,9 @@ import * as i0 from "@angular/core";
23
23
  export declare class SummaryTagDirective implements OnChanges {
24
24
  private multiSelectComponent;
25
25
  /**
26
- * A numeric value that indicates the number of selected data items after which the summary tag will appear.
26
+ * Sets the number of selected items after which the summary tag appears.
27
+ *
28
+ * @default 0
27
29
  */
28
30
  showAfter: number | string;
29
31
  constructor(multiSelectComponent: MultiSelectComponent);
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@progress/kendo-angular-dropdowns",
3
- "version": "19.1.1",
3
+ "version": "19.1.2-develop.2",
4
4
  "description": "A wide variety of native Angular dropdown components including AutoComplete, ComboBox, DropDownList, DropDownTree, MultiColumnComboBox, MultiSelect, and MultiSelectTree ",
5
5
  "license": "SEE LICENSE IN LICENSE.md",
6
6
  "author": "Progress",
@@ -100,7 +100,7 @@
100
100
  "package": {
101
101
  "productName": "Kendo UI for Angular",
102
102
  "productCode": "KENDOUIANGULAR",
103
- "publishDate": 1749540146,
103
+ "publishDate": 1749820488,
104
104
  "licensingDocsUrl": "https://www.telerik.com/kendo-angular-ui/my-license/"
105
105
  }
106
106
  },
@@ -111,18 +111,18 @@
111
111
  "@angular/forms": "16 - 20",
112
112
  "@angular/platform-browser": "16 - 20",
113
113
  "@progress/kendo-licensing": "^1.5.0",
114
- "@progress/kendo-angular-common": "19.1.1",
115
- "@progress/kendo-angular-utils": "19.1.1",
116
- "@progress/kendo-angular-l10n": "19.1.1",
117
- "@progress/kendo-angular-navigation": "19.1.1",
118
- "@progress/kendo-angular-popup": "19.1.1",
119
- "@progress/kendo-angular-icons": "19.1.1",
120
- "@progress/kendo-angular-treeview": "19.1.1",
114
+ "@progress/kendo-angular-common": "19.1.2-develop.2",
115
+ "@progress/kendo-angular-utils": "19.1.2-develop.2",
116
+ "@progress/kendo-angular-l10n": "19.1.2-develop.2",
117
+ "@progress/kendo-angular-navigation": "19.1.2-develop.2",
118
+ "@progress/kendo-angular-popup": "19.1.2-develop.2",
119
+ "@progress/kendo-angular-icons": "19.1.2-develop.2",
120
+ "@progress/kendo-angular-treeview": "19.1.2-develop.2",
121
121
  "rxjs": "^6.5.3 || ^7.0.0"
122
122
  },
123
123
  "dependencies": {
124
124
  "tslib": "^2.3.1",
125
- "@progress/kendo-angular-schematics": "19.1.1",
125
+ "@progress/kendo-angular-schematics": "19.1.2-develop.2",
126
126
  "@progress/kendo-common": "^1.0.1"
127
127
  },
128
128
  "schematics": "./schematics/collection.json",
@@ -4,9 +4,9 @@ const schematics_1 = require("@angular-devkit/schematics");
4
4
  function default_1(options) {
5
5
  const finalOptions = Object.assign(Object.assign({}, options), { mainNgModule: 'DropDownsModule', package: 'dropdowns', peerDependencies: {
6
6
  // peers of the treeview
7
- '@progress/kendo-angular-inputs': '19.1.1',
7
+ '@progress/kendo-angular-inputs': '19.1.2-develop.2',
8
8
  // peers of inputs
9
- '@progress/kendo-angular-intl': '19.1.1',
9
+ '@progress/kendo-angular-intl': '19.1.2-develop.2',
10
10
  '@progress/kendo-drawing': '^1.17.2',
11
11
  // Peer dependency of icons
12
12
  '@progress/kendo-svg-icons': '^4.0.0'