@progress/kendo-vue-dropdowns 3.11.0-dev.202305230623 → 3.11.0-dev.202305230751

package/dist/npm/DropDownList/DropDownList.js

@@ -31,6 +31,7 @@ var ListFilter_1 = require("../common/ListFilter");
 var ListDefaultItem_1 = require("../common/ListDefaultItem");
 var List_1 = require("../common/List");
 var DropDownBase_1 = require("../common/DropDownBase");
+var GroupStickyHeader_1 = require("../common/GroupStickyHeader");
 var main_1 = require("../messages/main");
 var kendo_vue_intl_1 = require("@progress/kendo-vue-intl");
 var utils_1 = require("../common/utils");
@@ -133,6 +134,8 @@ var DropDownListVue2 = {
       }
     },
     itemRender: [String, Function, Object],
+    groupHeaderItemRender: [String, Function, Object],
+    groupStickyHeaderItemRender: [String, Function, Object],
     listNoDataRender: [String, Function, Object],
     focusedItemIndex: Function,
     header: [String, Function, Object],
@@ -169,6 +172,9 @@ var DropDownListVue2 = {
       validator: function validator(value) {
         return ['small', 'medium', 'large'].includes(value);
       }
+    },
+    groupField: {
+      type: String
     }
   },
   inject: {
@@ -189,7 +195,10 @@ var DropDownListVue2 = {
       },
       _skipFocusEvent: false,
       valueDuringOnChange: {},
-      _navigated: false
+      _navigated: false,
+      group: undefined,
+      isScrolling: false,
+      itemHeight: 0
     };
   },
   watch: {
@@ -240,11 +249,14 @@ var DropDownListVue2 = {
     this.setValidity();
   },
   updated: function updated() {
-    var _a = this.$props,
-      _b = _a.dataItems,
-      dataItems = _b === void 0 ? [] : _b,
-      dataItemKey = _a.dataItemKey,
-      virtual = _a.virtual;
+    var _a;
+    var _b = this.$props,
+      _c = _b.dataItems,
+      dataItems = _c === void 0 ? [] : _c,
+      dataItemKey = _b.dataItemKey,
+      virtual = _b.virtual,
+      groupField = _b.groupField,
+      textField = _b.textField;
     var opened = this.$props.opened !== undefined ? this.$props.opened : this.currentOpened;
     var prevOpened = this.prevOpened !== undefined ? this.prevOpened : this.prevCurrentOpened;
     var opening = !prevOpened && opened;
@@ -288,11 +300,19 @@ var DropDownListVue2 = {
       var selectedItemIndex = dataItems.findIndex(function (i) {
         return (0, utils_1.areSame)(i, selectedItem_1, dataItemKey);
       });
+      // Needed to calculate the proper item index when in grouping mode
+      if (groupField) {
+        selectedItemIndex = (_a = this.base.getGroupedDataModernMode(dataItems, groupField)) === null || _a === void 0 ? void 0 : _a.indexOf(selectedItem_1);
+      }
       var selectedItemChanged = !(0, utils_1.areSame)(prevSelectedItem, selectedItem_1, dataItemKey);
       if (opening && virtual) {
         this.base.scrollToVirtualItem(virtual, selectedItemIndex);
         this.prevCurrentOpened = true;
       } else if (opening && !virtual) {
+        // Resets the sticky header group value for scenarios with open/close of component's popup
+        if (dataItems && dataItems.length !== 0) {
+          this.base.resetGroupStickyHeader(dataItems[0][groupField], this);
+        }
         this.base.scrollToItem(selectedItemIndex);
         this.prevCurrentOpened = true;
       } else if (opened && prevOpened && selectedItem_1 && selectedItemChanged && !this._navigated) {
@@ -493,6 +513,9 @@ var DropDownListVue2 = {
       }
     },
     handleKeyDown: function handleKeyDown(event) {
+      if (this.isScrolling) {
+        this.isScrolling = false;
+      }
       var _a = this.$props,
         _b = _a.dataItems,
         dataItems = _b === void 0 ? [] : _b,
@@ -617,6 +640,8 @@ var DropDownListVue2 = {
         state.data.currentText = event.target.value;
       }
       this.base.filterChanged(event.target.value, state);
+      // Used to reset the value of the StickyHeader when filtering the data
+      state.data.group = undefined;
       this.applyState(state);
     },
     onPopupOpened: function onPopupOpened() {
@@ -688,6 +713,39 @@ var DropDownListVue2 = {
     },
     repositionPopup: function repositionPopup() {
       this.base.repositionPopup();
+    },
+    onScroll: function onScroll(event) {
+      this.isScrolling = true;
+      var _a = this.base,
+        vs = _a.vs,
+        list = _a.list;
+      vs.scrollHandler(event);
+      var state = this.base.initState();
+      var groupField = this.$props.groupField;
+      var _b = this.$props.dataItems,
+        dataItems = _b === void 0 ? [] : _b;
+      if (!groupField || !dataItems.length) {
+        return;
+      }
+      var itemHeight = this.itemHeight = this.itemHeight || (vs.enabled ? vs.itemHeight : list ? list.children[0].offsetHeight : 0);
+      var target = event.target;
+      var scrollTop = target.scrollTop - vs.skip * itemHeight;
+      if (groupField) {
+        dataItems = this.base.getGroupedDataModernMode(dataItems, groupField);
+      }
+      var group = dataItems[0][groupField];
+      for (var i = 1; i < dataItems.length; i++) {
+        if (itemHeight * i > scrollTop) {
+          break;
+        }
+        if (dataItems[i] && dataItems[i][groupField]) {
+          group = dataItems[i][groupField];
+        }
+      }
+      if (group !== this.group) {
+        state.data.group = group;
+        this.applyState(state);
+      }
     }
   },
   render: function render(createElement) {
@@ -805,11 +863,18 @@ var DropDownListVue2 = {
     };
     var renderList = function renderList() {
       var _this2 = this;
-      var textField = this.$props.textField;
+      var _a = this.$props,
+        textField = _a.textField,
+        groupField = _a.groupField;
+      var dataItemsToRender = this.$props.dataItems || [];
       var itemRender = kendo_vue_common_1.templateRendering.call(this, this.$props.itemRender, kendo_vue_common_1.getListeners.call(this));
+      var groupHeaderItemRender = kendo_vue_common_1.templateRendering.call(this, this.$props.groupHeaderItemRender, kendo_vue_common_1.getListeners.call(this));
       var listNoDataRender = kendo_vue_common_1.templateRendering.call(this, this.$props.listNoDataRender, kendo_vue_common_1.getListeners.call(this));
       var skip = virtual.skip;
       var translate = "translateY(".concat(vs.translate, "px)");
+      if (groupField) {
+        dataItemsToRender = this.base.getGroupedDataModernMode(dataItemsToRender, groupField);
+      }
       return (
         // @ts-ignore  function children
         h(List_1.List, {
@@ -817,7 +882,7 @@ var DropDownListVue2 = {
           attrs: this.v3 ? undefined : {
             id: this.base.listBoxId,
             show: opened,
-            dataItems: dataItems.slice(),
+            dataItems: dataItemsToRender.slice(),
             focusedIndex: this.focusedIndex(),
             value: this.computedValue(),
             textField: textField,
@@ -832,10 +897,12 @@ var DropDownListVue2 = {
             } : undefined,
             skip: skip,
             itemRender: itemRender,
-            noDataRender: listNoDataRender
+            groupHeaderItemRender: groupHeaderItemRender,
+            noDataRender: listNoDataRender,
+            groupField: groupField
           },
           show: opened,
-          dataItems: dataItems.slice(),
+          dataItems: dataItemsToRender.slice(),
           focusedIndex: this.focusedIndex(),
           value: this.computedValue(),
           textField: textField,
@@ -854,11 +921,13 @@ var DropDownListVue2 = {
           onListclick: this.handleItemClick,
           on: this.v3 ? undefined : {
             "listclick": this.handleItemClick,
-            "scroll": vs.scrollHandler
+            "scroll": this.onScroll
           },
           itemRender: itemRender,
+          groupHeaderItemRender: groupHeaderItemRender,
           noDataRender: listNoDataRender,
-          onScroll: vs.scrollHandler
+          groupField: groupField,
+          onScroll: this.onScroll
         }, this.v3 ? function () {
           return [renderScrollElement.call(_this2)];
         } : [renderScrollElement.call(_this2)])
@@ -899,6 +968,7 @@ var DropDownListVue2 = {
       var _a;
       var headerTemplate = kendo_vue_common_1.templateRendering.call(this, this.$props.header, kendo_vue_common_1.getListeners.call(this));
       var footerTemplate = kendo_vue_common_1.templateRendering.call(this, this.$props.footer, kendo_vue_common_1.getListeners.call(this));
+      var groupStickyHeaderTemplate = kendo_vue_common_1.templateRendering.call(this, this.$props.groupStickyHeaderItemRender, kendo_vue_common_1.getListeners.call(this));
       var header = kendo_vue_common_1.getTemplate.call(this, {
         h: h,
         template: headerTemplate
@@ -908,6 +978,9 @@ var DropDownListVue2 = {
         template: footerTemplate
       });
       var popupWidth = popupSettings.width !== undefined ? popupSettings.width : base.popupWidth;
+      if (this.group === undefined && this.$props.groupField !== undefined) {
+        this.group = (0, utils_1.getItemValue)(dataItems[0], this.$props.groupField);
+      }
       return (
         // @ts-ignore  function children
         h(ListContainer_1.ListContainer, {
@@ -943,12 +1016,26 @@ var DropDownListVue2 = {
           onClose: this.onPopupClosed,
           onBlur: this.handleBlur
         }, this.v3 ? function () {
-          return [renderListFilter.call(_this3), renderDefaultItem.call(_this3), header && h("div", {
+          return [renderListFilter.call(_this3), renderDefaultItem.call(_this3), _this3.group && dataItems.length !== 0 && h(GroupStickyHeader_1.GroupStickyHeader, {
+            group: _this3.group,
+            attrs: _this3.v3 ? undefined : {
+              group: _this3.group,
+              render: groupStickyHeaderTemplate
+            },
+            render: groupStickyHeaderTemplate
+          }), header && h("div", {
             "class": "k-list-header"
           }, [header]), renderList.call(_this3), footer && h("div", {
             "class": "k-list-footer"
           }, [footer])];
-        } : [renderListFilter.call(_this3), renderDefaultItem.call(_this3), header && h("div", {
+        } : [renderListFilter.call(_this3), renderDefaultItem.call(_this3), _this3.group && dataItems.length !== 0 && h(GroupStickyHeader_1.GroupStickyHeader, {
+          group: _this3.group,
+          attrs: _this3.v3 ? undefined : {
+            group: _this3.group,
+            render: groupStickyHeaderTemplate
+          },
+          render: groupStickyHeaderTemplate
+        }), header && h("div", {
           "class": "k-list-header"
         }, [header]), renderList.call(_this3), footer && h("div", {
           "class": "k-list-footer"

package/dist/npm/DropDownList/DropDownListProps.d.ts

@@ -284,4 +284,16 @@ export interface DropDownListProps extends FormComponentProps {
      * @default `solid`
      */
     fillMode?: null | 'solid' | 'outline' | 'flat' | string;
+    /**
+     * Sets the data item field that represents the start of a group. Applicable to objects data.
+     */
+    groupField?: string;
+    /**
+     * Fires when a DropDownList group header item is about to be rendered. Used to override the default appearance of the group's headers.
+     */
+    groupHeaderItemRender?: any;
+    /**
+     * Fires when a DropDownList sticky group header item is about to be rendered. Used to override the default appearance of the sticky group header of the component.
+     */
+    groupStickyHeaderItemRender?: any;
 }

package/dist/npm/MultiSelect/MultiSelect.js

@@ -39,6 +39,7 @@ var List_1 = require("../common/List");
 var TagList_1 = require("./TagList");
 var SearchBar_1 = require("../common/SearchBar");
 var DropDownBase_1 = require("../common/DropDownBase");
+var GroupStickyHeader_1 = require("../common/GroupStickyHeader");
 var ClearButton_1 = require("../common/ClearButton");
 var settings_1 = require("./../common/settings");
 var utils_1 = require("../common/utils");
@@ -145,6 +146,8 @@ var MultiSelectVue2 = {
       }
     },
     itemRender: [String, Function, Object],
+    groupHeaderItemRender: [String, Function, Object],
+    groupStickyHeaderItemRender: [String, Function, Object],
     listNoDataRender: [String, Function, Object],
     focusedItemIndex: Function,
     virtual: {
@@ -187,6 +190,9 @@ var MultiSelectVue2 = {
       validator: function validator(value) {
         return ['small', 'medium', 'large'].includes(value);
       }
+    },
+    groupField: {
+      type: String
     }
   },
   // @ts-ignore
@@ -238,7 +244,10 @@ var MultiSelectVue2 = {
         last: ''
       },
       suggested: '',
-      activedescendant: settings_1.ActiveDescendant.PopupList
+      activedescendant: settings_1.ActiveDescendant.PopupList,
+      group: undefined,
+      isScrolling: false,
+      itemHeight: 0
     };
   },
   watch: {
@@ -255,7 +264,13 @@ var MultiSelectVue2 = {
     }
   },
   updated: function updated() {
-    var virtual = this.$props.virtual;
+    var _a;
+    var _b = this.$props,
+      virtual = _b.virtual,
+      _c = _b.groupField,
+      groupField = _c === void 0 ? '' : _c,
+      _d = _b.dataItems,
+      dataItems = _d === void 0 ? [] : _d;
     var skip = virtual ? virtual.skip : 0;
     var opened = this.$props.opened !== undefined ? this.$props.opened : this.currentOpened;
     var prevOpened = this.prevOpened !== undefined ? this.prevOpened : this.prevCurrentOpened;
@@ -276,29 +291,38 @@ var MultiSelectVue2 = {
     if (scrollElement) {
       this.base.vs.scrollElement = scrollElement;
     }
-    if (list && this.dataItems.length) {
+    if (list && dataItems.length) {
       // @ts-ignore
       this.base.vs.scrollerRef(list.$el);
     }
     if (!popupSettings.animate && closing) {
       this.onPopupClosed();
     }
-    if (virtual && this.virtualTotalHasChanged) {
-      this.base.vs.calcScrollElementHeight();
-      this.base.vs.reset();
-      this.virtualTotalHasChanged = false;
-    } else {
-      var _a = this.getFocusedState(),
-        focusedItem = _a.focusedItem,
-        focusedIndex = _a.focusedIndex;
-      if (opening && virtual) {
-        this.base.scrollToVirtualItem(virtual, focusedIndex - skip);
-        this.prevCurrentOpened = true;
-      } else if (opening && !virtual) {
-        this.base.scrollToItem(focusedIndex);
-        this.prevCurrentOpened = true;
-      } else if (opened && prevOpened && focusedItem && this.scrollToFocused) {
-        this.base.scrollToItem(focusedIndex - skip);
+    if (!this.isScrolling) {
+      if (virtual && this.virtualTotalHasChanged) {
+        this.base.vs.calcScrollElementHeight();
+        this.base.vs.reset();
+        this.virtualTotalHasChanged = false;
+      } else {
+        var _e = this.getFocusedState(),
+          focusedItem = _e.focusedItem,
+          focusedIndex = _e.focusedIndex;
+        if (groupField !== '') {
+          focusedIndex = (_a = this.base.getGroupedDataModernMode(dataItems, groupField)) === null || _a === void 0 ? void 0 : _a.indexOf(focusedItem);
+        }
+        if (opening && virtual) {
+          this.base.scrollToVirtualItem(virtual, focusedIndex - skip);
+          this.prevCurrentOpened = true;
+        } else if (opening && !virtual) {
+          // Resets the sticky header group value for scenarios with open/close of component's popup
+          if (dataItems && dataItems.length !== 0) {
+            this.base.resetGroupStickyHeader(dataItems[0][groupField], this);
+          }
+          this.base.scrollToItem(focusedIndex);
+          this.prevCurrentOpened = true;
+        } else if (opened && prevOpened && focusedItem) {
+          this.base.scrollToItem(focusedIndex - skip);
+        }
       }
     }
     this.scrollToFocused = false;
@@ -484,6 +508,10 @@ var MultiSelectVue2 = {
         this.base.togglePopup(state);
       }
       this.base.filterChanged(value, state);
+      // Resets the value of the StickyHeader when filtering the data or just entering symbols in the input
+      if (this.$props.filterable) {
+        state.data.group = undefined;
+      }
       this.applyState(state);
     },
     clearButtonClick: function clearButtonClick(event) {
@@ -511,6 +539,9 @@ var MultiSelectVue2 = {
     },
     onInputKeyDown: function onInputKeyDown(event) {
       var _this = this;
+      if (this.isScrolling) {
+        this.isScrolling = false;
+      }
       var keyCode = event.keyCode;
       var text = this.$props.filter !== undefined ? this.$props.filter : this.currentText;
       var opened = this.$props.opened !== undefined ? this.$props.opened : this.currentOpened;
@@ -800,6 +831,39 @@ var MultiSelectVue2 = {
     },
     repositionPopup: function repositionPopup() {
       this.base.repositionPopup();
+    },
+    onScroll: function onScroll(event) {
+      this.isScrolling = true;
+      var _a = this.base,
+        vs = _a.vs,
+        list = _a.list;
+      vs.scrollHandler(event);
+      var state = this.base.initState();
+      var groupField = this.$props.groupField;
+      var _b = this.$props.dataItems,
+        dataItems = _b === void 0 ? [] : _b;
+      if (!groupField || !dataItems.length) {
+        return;
+      }
+      var itemHeight = this.itemHeight = this.itemHeight || (vs.enabled ? vs.itemHeight : list ? list.children[0].offsetHeight : 0);
+      var target = event.target;
+      var scrollTop = target.scrollTop - vs.skip * itemHeight;
+      if (groupField) {
+        dataItems = this.base.getGroupedDataModernMode(dataItems, groupField);
+      }
+      var group = dataItems[0][groupField];
+      for (var i = 1; i < dataItems.length; i++) {
+        if (itemHeight * i > scrollTop) {
+          break;
+        }
+        if (dataItems[i] && dataItems[i][groupField]) {
+          group = dataItems[i][groupField];
+        }
+      }
+      if (group !== this.group) {
+        state.data.group = group;
+        this.applyState(state);
+      }
     }
   },
   render: function render(createElement) {
@@ -905,14 +969,18 @@ var MultiSelectVue2 = {
     };
     var renderList = function renderList() {
       var _this2 = this;
-      var _a = this.$props.dataItems,
-        dataItems = _a === void 0 ? [] : _a;
+      var groupField = this.$props.groupField;
+      var dataItems = this.$props.dataItems || [];
       var itemRender = kendo_vue_common_1.templateRendering.call(this, this.$props.itemRender, kendo_vue_common_1.getListeners.call(this));
+      var groupHeaderItemRender = kendo_vue_common_1.templateRendering.call(this, this.$props.groupHeaderItemRender, kendo_vue_common_1.getListeners.call(this));
       var listNoDataRender = kendo_vue_common_1.templateRendering.call(this, this.$props.listNoDataRender, kendo_vue_common_1.getListeners.call(this));
       var skip = virtual ? virtual.skip : 0;
       var opened = this.$props.opened !== undefined ? this.$props.opened : this.currentOpened;
       var focusedIndex = this.getFocusedState().focusedIndex;
       var translate = "translateY(".concat(vs.translate, "px)");
+      if (groupField) {
+        dataItems = this.base.getGroupedDataModernMode(dataItems, groupField);
+      }
       return (
         // @ts-ignore  function children
         h(List_1.List, {
@@ -935,7 +1003,9 @@ var MultiSelectVue2 = {
             } : undefined,
             skip: skip,
             itemRender: itemRender,
-            noDataRender: listNoDataRender
+            groupHeaderItemRender: groupHeaderItemRender,
+            noDataRender: listNoDataRender,
+            groupField: groupField
           },
           show: opened,
           dataItems: dataItems.slice(),
@@ -957,11 +1027,13 @@ var MultiSelectVue2 = {
           onListclick: this.handleItemClick,
           on: this.v3 ? undefined : {
             "listclick": this.handleItemClick,
-            "scroll": vs.scrollHandler
+            "scroll": this.onScroll
           },
           itemRender: itemRender,
+          groupHeaderItemRender: groupHeaderItemRender,
           noDataRender: listNoDataRender,
-          onScroll: vs.scrollHandler
+          groupField: groupField,
+          onScroll: this.onScroll
         }, this.v3 ? function () {
           return [renderScrollElement.call(_this2)];
         } : [renderScrollElement.call(_this2)])
@@ -983,6 +1055,7 @@ var MultiSelectVue2 = {
         dataItems = _c === void 0 ? [] : _c;
       var headerTemplate = kendo_vue_common_1.templateRendering.call(this, this.$props.header, kendo_vue_common_1.getListeners.call(this));
       var footerTemplate = kendo_vue_common_1.templateRendering.call(this, this.$props.footer, kendo_vue_common_1.getListeners.call(this));
+      var groupStickyHeaderTemplate = kendo_vue_common_1.templateRendering.call(this, this.$props.groupStickyHeaderItemRender, kendo_vue_common_1.getListeners.call(this));
       var header = kendo_vue_common_1.getTemplate.call(this, {
         h: h,
         template: headerTemplate
@@ -1017,6 +1090,9 @@ var MultiSelectVue2 = {
           float: 'right'
         }
       })])]);
+      if (this.group === undefined && this.$props.groupField !== undefined) {
+        this.group = (0, utils_1.getItemValue)(dataItems[0], this.$props.groupField);
+      }
       return (
         // @ts-ignore  function children
         h(ListContainer_1.ListContainer, {
@@ -1054,12 +1130,26 @@ var MultiSelectVue2 = {
         }, this.v3 ? function () {
           return [header && h("div", {
             "class": "k-list-header"
-          }, [header]), customItem, renderList.call(_this3), footer && h("div", {
+          }, [header]), customItem, _this3.group && dataItems.length !== 0 && h(GroupStickyHeader_1.GroupStickyHeader, {
+            group: _this3.group,
+            attrs: _this3.v3 ? undefined : {
+              group: _this3.group,
+              render: groupStickyHeaderTemplate
+            },
+            render: groupStickyHeaderTemplate
+          }), renderList.call(_this3), footer && h("div", {
             "class": "k-list-footer"
           }, [footer]), virtual && header];
         } : [header && h("div", {
           "class": "k-list-header"
-        }, [header]), customItem, renderList.call(_this3), footer && h("div", {
+        }, [header]), customItem, _this3.group && dataItems.length !== 0 && h(GroupStickyHeader_1.GroupStickyHeader, {
+          group: _this3.group,
+          attrs: _this3.v3 ? undefined : {
+            group: _this3.group,
+            render: groupStickyHeaderTemplate
+          },
+          render: groupStickyHeaderTemplate
+        }), renderList.call(_this3), footer && h("div", {
           "class": "k-list-footer"
         }, [footer]), virtual && header])
       );

package/dist/npm/MultiSelect/MultiSelectProps.d.ts

@@ -263,4 +263,16 @@ export interface MultiSelectProps extends FormComponentProps {
      * @default `solid`
      */
     fillMode?: null | 'solid' | 'outline' | 'flat' | string;
+    /**
+     * Sets the data item field that represents the start of a group. Applicable to objects data.
+     */
+    groupField?: string;
+    /**
+     * Fires when a MultiSelect group header item is about to be rendered. Used to override the default appearance of the group's headers.
+     */
+    groupHeaderItemRender?: any;
+    /**
+     * Fires when a MultiSelect sticky group header item is about to be rendered. Used to override the default appearance of the sticky group header of the component.
+     */
+    groupStickyHeaderItemRender?: any;
 }

package/dist/npm/common/DropDownBase.d.ts

@@ -82,4 +82,6 @@ export default class DropDownBase {
     triggerOnPageChange(state: InternalState, skip: number, take: number): void;
     triggerPageChangeCornerItems(item: any, state: InternalState): void;
     scrollToVirtualItem: (virtual: VirtualizationSettings, selectedItemIndex: number) => void;
+    getGroupedDataModernMode: (data: any[], groupField: string) => any[];
+    resetGroupStickyHeader: (groupName: string, that: any) => void;
 }

package/dist/npm/common/DropDownBase.js

@@ -118,6 +118,26 @@ var DropDownBase = /** @class */function () {
         return vs.enabled = true;
       }, 10);
     };
+    this.getGroupedDataModernMode = function (data, groupField) {
+      var newData = [];
+      data.forEach(function (el, index) {
+        var _a;
+        if (data[index - 1] && el[groupField] !== data[index - 1][groupField]) {
+          newData.push((_a = {}, _a[groupField] = el[groupField], _a));
+          newData.push(data[index]);
+        } else {
+          newData.push(data[index]);
+        }
+      });
+      return newData;
+    };
+    this.resetGroupStickyHeader = function (groupName, that) {
+      var state = _this.initState();
+      if (groupName !== that.group && that.state) {
+        that.state.data.group = groupName;
+        _this.applyState(state);
+      }
+    };
     (0, kendo_vue_common_1.validatePackage)(package_metadata_1.packageMetadata);
     this.listBoxId = (0, kendo_vue_common_1.guid)();
     this.guid = (0, kendo_vue_common_1.guid)();

package/dist/npm/common/GroupStickyHeader.d.ts

@@ -0,0 +1,29 @@
+import { DefineComponent, RecordPropsDefinition, ComponentOptions, Vue2type } from '../additionalTypes';
+declare type DefaultData<V> = object | ((this: V) => {});
+declare type DefaultMethods<V> = {
+    [key: string]: (this: V, ...args: any[]) => any;
+};
+/**
+ * Represents the props of the GroupStickyHeader component.
+ */
+export interface GroupStickyHeaderProps {
+    /**
+     * The group that will be rendered.
+     */
+    group?: string;
+    /**
+     * Fires when a sticky group header item is about to be rendered. Used to override the default appearance of the sticky group header of the component.
+     */
+    render?: any;
+}
+export interface GroupStickyHeaderAll extends Vue2type {
+}
+/**
+ * @hidden
+ */
+declare let GroupStickyHeaderVue2: ComponentOptions<Vue2type, DefaultData<{}>, DefaultMethods<{}>, {}, RecordPropsDefinition<GroupStickyHeaderProps>>;
+/**
+ * @hidden
+ */
+declare const GroupStickyHeader: DefineComponent<GroupStickyHeaderProps, any, {}, {}, {}, {}, {}, {}, string, GroupStickyHeaderProps, GroupStickyHeaderProps, {}>;
+export { GroupStickyHeader, GroupStickyHeaderVue2 };

package/dist/npm/common/GroupStickyHeader.js

@@ -0,0 +1,66 @@
+"use strict";
+
+var __assign = undefined && undefined.__assign || function () {
+  __assign = Object.assign || function (t) {
+    for (var s, i = 1, n = arguments.length; i < n; i++) {
+      s = arguments[i];
+      for (var p in s) {
+        if (Object.prototype.hasOwnProperty.call(s, p)) t[p] = s[p];
+      }
+    }
+    return t;
+  };
+  return __assign.apply(this, arguments);
+};
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.GroupStickyHeaderVue2 = exports.GroupStickyHeader = void 0;
+// @ts-ignore
+var Vue = require("vue");
+var allVue = Vue;
+var gh = allVue.h;
+var isV3 = allVue.version && allVue.version[0] === '3';
+var ref = allVue.ref;
+var kendo_vue_common_1 = require("@progress/kendo-vue-common");
+/**
+ * @hidden
+ */
+var GroupStickyHeaderVue2 = {
+  name: 'KendoGroupStickyHeader',
+  props: {
+    group: String,
+    render: Object
+  },
+  // @ts-ignore
+  setup: !isV3 ? undefined : function () {
+    var v3 = !!isV3;
+    return {
+      v3: v3
+    };
+  },
+  // @ts-ignore
+  render: function render(createElement) {
+    var h = gh || createElement;
+    var _a = this.$props,
+      group = _a.group,
+      render = _a.render;
+    var defaulGroupStickyHeader = h("div", {
+      "class": "k-list-group-sticky-header"
+    }, [h("div", {
+      "class": "k-list-header-text"
+    }, [group])]);
+    return kendo_vue_common_1.getTemplate.call(this, {
+      h: h,
+      template: render,
+      defaultRendering: defaulGroupStickyHeader,
+      additionalProps: __assign({}, this.$props)
+    });
+  }
+};
+exports.GroupStickyHeaderVue2 = GroupStickyHeaderVue2;
+/**
+ * @hidden
+ */
+var GroupStickyHeader = GroupStickyHeaderVue2;
+exports.GroupStickyHeader = GroupStickyHeader;

package/dist/npm/common/List.d.ts

@@ -23,8 +23,10 @@ export interface ListProps {
     highlightSelected?: boolean;
     onClick?: (index: number, event: any) => void;
     itemRender?: any;
+    groupHeaderItemRender?: any;
     noDataRender?: any;
     scroller?: boolean;
+    groupField: string;
 }
 /**
  * @hidden