@progress/kendo-angular-grid 14.4.0-develop.9 → 15.0.0-develop.2

package/esm2020/common/clipboard.service.mjs

@@ -0,0 +1,218 @@
+/**-----------------------------------------------------------------------------------------
+* Copyright © 2024 Progress Software Corporation. All rights reserved.
+* Licensed under commercial license. See LICENSE.md in the project root for more information
+*-------------------------------------------------------------------------------------------*/
+import { Injectable } from '@angular/core';
+import { ColumnComponent } from '../columns/column.component';
+import { isPresent } from '@progress/kendo-angular-common';
+import { ContextService } from './provider.service';
+import { groupBy } from '@progress/kendo-data-query';
+import * as i0 from "@angular/core";
+import * as i1 from "./provider.service";
+/**
+ * @hidden
+ */
+export class ClipboardService {
+    constructor(contextService) {
+        this.contextService = contextService;
+        this.itemToString = (item, cols) => {
+            if (!cols.length) {
+                return null;
+            }
+            return cols.map(col => item[col.field]).join(`\t`);
+        };
+    }
+    createClipboardData(data, columns, options) {
+        let result = {
+            gridItems: [],
+            dataString: ''
+        };
+        const fieldCols = columns.flatMap(c => c instanceof ColumnComponent && isPresent(c.field) ? [c] : []);
+        const clipboardData = { items: [], dataStrings: [] };
+        const colFields = fieldCols.map(c => c.field);
+        if (options.wholeRow) {
+            this.targetColField = fieldCols[0]?.field;
+            this.targetRowIndex = data[0].dataRowIndex;
+            data.forEach(item => {
+                clipboardData.items.push({ dataItem: { ...item.dataItem }, fields: colFields });
+                clipboardData.dataStrings.push(this.itemToString(item.dataItem, fieldCols));
+            });
+            result = {
+                gridItems: options.operationType === 'cut' ? clipboardData.items.map(item => {
+                    item.fields.forEach(field => item.dataItem[field] = null);
+                    return item;
+                }) : [...clipboardData.items],
+                dataString: options.copyHeaders ? this.addHeaders(clipboardData.dataStrings.join(`\r\n`), fieldCols) : clipboardData.dataStrings.join(`\n`)
+            };
+        }
+        else {
+            if (options.target === 'selection') {
+                const { tabular, groups } = this.groupSelection();
+                const selectionDirective = this.contextService.grid.selectionDirective;
+                const colIdentifier = selectionDirective.columnKey;
+                if (tabular) {
+                    const selectionKeys = groups[0].items.map(item => item.columnKey);
+                    const selectedFieldCols = columns.flatMap((c, i) => (c instanceof ColumnComponent && c.field) && selectionKeys.find(k => typeof colIdentifier === 'function' ? k === colIdentifier(c, i) : k === i) ? [c] : []);
+                    const selectedColFields = selectedFieldCols.map(c => c.field);
+                    this.targetColField = selectedColFields[0];
+                    result.dataString = data.flatMap(item => {
+                        const itemString = this.itemToString(item.dataItem, selectedFieldCols);
+                        const existingItem = isPresent(itemString);
+                        if (!isPresent(this.targetRowIndex) && isPresent(itemString)) {
+                            this.targetRowIndex = item.dataRowIndex;
+                        }
+                        if (options.operationType === 'cut') {
+                            selectedColFields.forEach(f => item.dataItem[f] = null);
+                        }
+                        result.gridItems.push({
+                            dataItem: item.dataItem,
+                            fields: selectedColFields
+                        });
+                        return existingItem ? [itemString] : [];
+                    }).join(`\r\n`);
+                    if (options.copyHeaders) {
+                        result.dataString = this.addHeaders(result.dataString, selectedFieldCols);
+                    }
+                }
+                else { // split per row (uneven rows)
+                    const rowIdentifier = selectionDirective.selectionKey;
+                    result.dataString = data.flatMap(item => {
+                        // determine cols per item
+                        const key = rowIdentifier ?
+                            typeof rowIdentifier === 'string' ? item.dataItem[rowIdentifier] : rowIdentifier({ index: item.dataRowIndex, dataItem: item.dataItem }) :
+                            item.dataRowIndex;
+                        const selectionKeys = groups.find(gr => gr.value === key).items.map(item => item.columnKey);
+                        const selectedFieldCols = columns.flatMap((c, i) => (c instanceof ColumnComponent && c.field) && selectionKeys.find(k => typeof colIdentifier === 'function' ? k === colIdentifier(c, i) : k === i) ? [c] : []);
+                        const selectedColFields = selectedFieldCols.map(c => c.field);
+                        if (!this.targetColField) {
+                            this.targetColField = selectedColFields[0];
+                        }
+                        const itemString = this.itemToString(item.dataItem, selectedFieldCols);
+                        const existingItem = isPresent(itemString);
+                        if (!isPresent(this.targetRowIndex) && existingItem) {
+                            this.targetRowIndex = item.dataRowIndex;
+                        }
+                        if (existingItem) {
+                            if (options.operationType === 'cut') {
+                                selectedColFields.forEach(f => item.dataItem[f] = null);
+                            }
+                            result.gridItems.push({
+                                dataItem: item.dataItem,
+                                fields: selectedColFields
+                            });
+                        }
+                        return existingItem ? options.copyHeaders ? [this.addHeaders(itemString, selectedFieldCols)] : [itemString] : [];
+                    }).join(`\r\n`);
+                }
+            }
+            else {
+                const item = data[0];
+                const col = columns[item.colIndex];
+                const colField = col.field;
+                const title = col.title;
+                const copiedData = item.dataItem[colField];
+                this.targetRowIndex = item.dataRowIndex;
+                this.targetColField = colField;
+                if (options.operationType === 'cut' && colField) {
+                    item.dataItem[colField] = null;
+                }
+                result = {
+                    gridItems: [{
+                            dataItem: item.dataItem,
+                            fields: colField ? [colField] : []
+                        }],
+                    dataString: options.copyHeaders ? [title || colField, copiedData].join(`\r\n`) : colField ? copiedData : ``
+                };
+            }
+        }
+        return result;
+    }
+    getGridData(data, columns, targetType, targetRowIndex, options) {
+        const separator = data.includes(`\r\n`) ? `\r\n` : data.includes(`\n`) ? `\n` : null;
+        const dataRows = separator ? data.split(separator) : [data];
+        this.targetRowIndex = targetRowIndex;
+        if (targetType === 'activeCell') {
+            if (options.wholeRow) {
+                this.targetColField = columns.find(c => c instanceof ColumnComponent && c.field)?.field;
+            }
+            else {
+                const activeCellIndex = this.contextService.grid.activeCell.colIndex;
+                for (let i = 0; i < columns.length; i++) {
+                    const col = columns[i];
+                    if (col instanceof ColumnComponent && col.field && i >= activeCellIndex) {
+                        this.targetColField = col.field;
+                        break;
+                    }
+                }
+            }
+        }
+        else {
+            if (options.wholeRow || !options.isCellSelection) {
+                this.targetColField = (columns.filter(c => c instanceof ColumnComponent && c.field))[0]['field'];
+            }
+            else {
+                const { groups } = this.groupSelection();
+                const selectionDirective = this.contextService.grid.selectionDirective;
+                const colIdentifier = selectionDirective.columnKey;
+                const visibleCols = columns.filter(c => c.isVisible);
+                const selectionKeys = groups[0].items.map(item => item.columnKey);
+                const selectedFieldCols = visibleCols.flatMap((c, i) => (c instanceof ColumnComponent && c.field) && selectionKeys.find(k => typeof colIdentifier === 'function' ? k === colIdentifier(c, i) : k === i) ? [c] : []);
+                const selectedColFields = selectedFieldCols.map(c => c.field);
+                this.targetColField = selectedColFields[0];
+            }
+        }
+        const items = dataRows.map(rowString => {
+            const cells = rowString.includes(`\t`) ? rowString.split(`\t`) : [rowString];
+            const colFields = columns.flatMap(c => (c instanceof ColumnComponent) && c.field ? [c.field] : []);
+            const targetColFieldIndex = colFields.indexOf(this.targetColField);
+            const affectedFields = colFields.slice(targetColFieldIndex, targetColFieldIndex + cells.length);
+            const item = {};
+            colFields.slice(targetColFieldIndex, targetColFieldIndex + cells.length).forEach((colField, index) => item[colField] = cells[index]);
+            return {
+                dataItem: item,
+                fields: affectedFields
+            };
+        });
+        return items;
+    }
+    groupSelection() {
+        const selection = this.contextService.grid.selection;
+        const groups = groupBy(selection, [{ field: 'itemKey' }])
+            .map(gr => {
+            gr.items.sort((a, b) => a.columnKey - b.columnKey);
+            return gr;
+        });
+        for (let i = 1; i < groups.length; i++) {
+            if (!this.areEqual(groups[i].items, groups[i - 1].items)) {
+                return {
+                    tabular: false,
+                    groups
+                };
+            }
+        }
+        return {
+            tabular: true,
+            groups
+        };
+    }
+    areEqual(arr1, arr2) {
+        if (arr1.length !== arr2.length) {
+            return false;
+        }
+        for (let i = 0; i < arr1.length; i++) {
+            if (arr1[i].columnKey !== arr2[i].columnKey) {
+                return false;
+            }
+        }
+        return true;
+    }
+    addHeaders(initialData, cols) {
+        const headersRowData = cols.map(c => c.title || c.field).join(`\t`);
+        return `${headersRowData}\r\n${initialData}`;
+    }
+}
+ClipboardService.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "13.3.12", ngImport: i0, type: ClipboardService, deps: [{ token: i1.ContextService }], target: i0.ɵɵFactoryTarget.Injectable });
+ClipboardService.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "13.3.12", ngImport: i0, type: ClipboardService });
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImport: i0, type: ClipboardService, decorators: [{
+            type: Injectable
+        }], ctorParameters: function () { return [{ type: i1.ContextService }]; } });

package/esm2020/common/dom-events.service.mjs

@@ -18,6 +18,7 @@ export class DomEventsService {
         this.focusIn = new EventEmitter();
         this.focusOut = new EventEmitter();
         this.windowBlur = new EventEmitter();
+        this.paste = new EventEmitter();
     }
 }
 DomEventsService.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "13.3.12", ngImport: i0, type: DomEventsService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });

package/esm2020/common/error-messages.mjs

@@ -7,5 +7,49 @@
  */
 export const ColumnMenuErrorMessages = {
     autoSizeColumn: 'The auto size column does not work with enabled virtual columns',
-    autoSizeAllColumns: 'The auto size all columns does not work with enabled virtual columns'
+    autoSizeAllColumns: 'The auto size all columns does not work with enabled virtual columns',
+    serviceInput: 'The service input of the predefined column menu components is mandatory.'
+};
+/**
+ * @hidden
+ */
+export const ClipboardErrorMessages = {
+    activeCellNavigable: 'Grid must be navigable to use "activeCell" as clipboard target type.',
+    selectionSelectable: 'Grid must be selectable to use "selection" as clipboard target type.'
+};
+/**
+ * @hidden
+ */
+export const ColumnConfigurationErrorMessages = {
+    fieldName: (field) => `Grid column field name '${field}' does not look like a valid JavaScript identifier.
+        Identifiers can contain only alphanumeric characters (including "$" or "_"), and may not start with a digit.
+        Please use only valid identifier names to ensure error-free operation.`,
+    width: (value, parsedValue) => `Expected numeric value for column width, but got a string "${value}". Treating as ${parsedValue}px.`,
+    invalidColumn: (column) => `Invalid column ${column}.`,
+    requiredWidth: (columnType) => `${columnType} columns feature requires all columns to have set width.`,
+    requiredScroll: (columnType) => `${columnType} columns are only supported when scrolling is enabled.`,
+    groupColumnContent: 'ColumnGroupComponent should contain ColumnComponent or CommandColumnComponent.',
+    lockedParent: 'Locked child columns require their parent columns to be locked.',
+    columnNested: 'Columns can be nested only inside ColumnGroupComponent',
+    nestedInside: (nestedColumnNameType, parentColumnType) => `${nestedColumnNameType} cannot be nested inside ${parentColumnType}.`
+};
+/**
+ * @hidden
+ */
+export const GridConfigurationErrorMessages = {
+    functionType: (propName, fn) => `${propName} must be a function, but received ${JSON.stringify(fn)}.`,
+    incompatibleFeatures: (feat1Name, feat2Name) => `'Having both ${feat1Name} and ${feat2Name} is not supported.'`,
+    nonLockedColumnPresent: 'There should be at least one non-locked column',
+    rowHeightVirtual: 'Row height and detail row height settings require virtual scrolling mode to be enabled.',
+    focusNavigable: 'The Grid should be configured as navigable to control focus',
+    expandCollapseMethods: (expandMethodName, collapseMethodName, directiveName, callbackName) => `The ${expandMethodName} and ${collapseMethodName} methods should not be called
+        when using the ${directiveName} directive or the ${callbackName} callback.
+        These methods are provided only for backwards compatibility with legacy versions.`,
+    requiredEditService: `The default edit service of the editing directives works only when binding to plain array.
+        Please provide an editService.`,
+    requiredModule: (exportedType, moduleName, componentSelector) => `Creating ${exportedType} requires including the ${moduleName} and adding the ${componentSelector} component.`,
+    groupBindingDirectives: `Using the "kendoGridGroupBinding" directive in combination with the "kendoGridExpandGroupBy" directive
+        or the "isGroupExpanded" callback is not supported. To use grouping with the "kendoGridGroupBinding" directive,
+        set the Grid "groupable" property to "true".`,
+    unsupportedMethod: (methodName, suggestedMethodName) => `Using ${methodName} in this context is not supported. Use ${suggestedMethodName} instead.`
 };

package/esm2020/databinding.directive.mjs

@@ -171,11 +171,12 @@ export class DataBindingDirective {
     }
 }
 DataBindingDirective.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "13.3.12", ngImport: i0, type: DataBindingDirective, deps: [{ token: i1.GridComponent }, { token: i0.ChangeDetectorRef }, { token: i2.LocalDataChangesService }, { token: i3.RowReorderService }], target: i0.ɵɵFactoryTarget.Directive });
-DataBindingDirective.ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "12.0.0", version: "13.3.12", type: DataBindingDirective, selector: "[kendoGridBinding]", inputs: { skip: "skip", sort: "sort", filter: "filter", pageSize: "pageSize", group: "group", data: ["kendoGridBinding", "data"] }, usesOnChanges: true, ngImport: i0 });
+DataBindingDirective.ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "12.0.0", version: "13.3.12", type: DataBindingDirective, selector: "[kendoGridBinding]", inputs: { skip: "skip", sort: "sort", filter: "filter", pageSize: "pageSize", group: "group", data: ["kendoGridBinding", "data"] }, exportAs: ["kendoGridBinding"], usesOnChanges: true, ngImport: i0 });
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImport: i0, type: DataBindingDirective, decorators: [{
             type: Directive,
             args: [{
-                    selector: '[kendoGridBinding]'
+                    selector: '[kendoGridBinding]',
+                    exportAs: 'kendoGridBinding'
                 }]
         }], ctorParameters: function () { return [{ type: i1.GridComponent }, { type: i0.ChangeDetectorRef }, { type: i2.LocalDataChangesService }, { type: i3.RowReorderService }]; }, propDecorators: { skip: [{
                 type: Input

package/esm2020/editing-directives/local-edit.service.mjs

@@ -3,6 +3,7 @@
 * Licensed under commercial license. See LICENSE.md in the project root for more information
 *-------------------------------------------------------------------------------------------*/
 import { isDevMode } from '@angular/core';
+import { GridConfigurationErrorMessages } from '../common/error-messages';
 /**
  * @hidden
  */
@@ -52,8 +53,7 @@ export class LocalEditService {
             return data;
         }
         if (isDevMode()) {
-            throw new Error('The default edit service of the editing directives works only when binding to plain array.' +
-                'Please provide an editService.');
+            throw new Error(GridConfigurationErrorMessages.requiredEditService);
         }
         return [];
     }

package/esm2020/excel/excel.service.mjs

@@ -3,6 +3,7 @@
 * Licensed under commercial license. See LICENSE.md in the project root for more information
 *-------------------------------------------------------------------------------------------*/
 import { EventEmitter, Injectable, isDevMode } from '@angular/core';
+import { GridConfigurationErrorMessages } from '../common/error-messages';
 import * as i0 from "@angular/core";
 /**
  * @hidden
@@ -15,7 +16,7 @@ export class ExcelService {
     save(component) {
         if (this.saveToExcel.observers.length === 0) {
             if (isDevMode()) {
-                throw new Error('Saving excel requires including the ExcelModule and adding the <kendo-grid-excel> component.');
+                throw new Error(GridConfigurationErrorMessages.requiredModule('excel', 'ExcelModule', '<kendo-grid-excel>'));
             }
         }
         else {

package/esm2020/filtering/cell/autocomplete-filter-cell.component.mjs

@@ -75,7 +75,7 @@ AutoCompleteFilterCellComponent.ɵcmp = i0.ɵɵngDeclareComponent({ minVersion:
                 [value]="currentFilter?.value">
             </kendo-autocomplete>
         </kendo-grid-filter-wrapper-cell>
-    `, isInline: true, components: [{ type: i5.FilterCellWrapperComponent, selector: "kendo-grid-filter-wrapper-cell", inputs: ["showOperators"] }, { type: i6.AutoCompleteComponent, selector: "kendo-autocomplete", inputs: ["highlightFirst", "showStickyHeader", "focusableId", "data", "value", "valueField", "placeholder", "adaptiveMode", "title", "subtitle", "popupSettings", "listHeight", "loading", "clearButton", "suggest", "disabled", "itemDisabled", "readonly", "tabindex", "tabIndex", "filterable", "virtual", "size", "rounded", "fillMode"], outputs: ["valueChange", "filterChange", "open", "opened", "close", "closed", "focus", "blur"], exportAs: ["kendoAutoComplete"] }], directives: [{ type: i7.FilterInputDirective, selector: "[kendoFilterInput]", inputs: ["filterDelay", "columnLabel", "value"] }] });
+    `, isInline: true, components: [{ type: i5.FilterCellWrapperComponent, selector: "kendo-grid-filter-wrapper-cell", inputs: ["showOperators"] }, { type: i6.AutoCompleteComponent, selector: "kendo-autocomplete", inputs: ["highlightFirst", "showStickyHeader", "focusableId", "data", "value", "valueField", "placeholder", "adaptiveMode", "title", "subtitle", "popupSettings", "listHeight", "loading", "clearButton", "suggest", "disabled", "itemDisabled", "readonly", "tabindex", "tabIndex", "filterable", "virtual", "size", "rounded", "fillMode"], outputs: ["valueChange", "filterChange", "open", "opened", "close", "closed", "focus", "blur", "inputFocus", "inputBlur"], exportAs: ["kendoAutoComplete"] }], directives: [{ type: i7.FilterInputDirective, selector: "[kendoFilterInput]", inputs: ["filterDelay", "columnLabel", "value"] }] });
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImport: i0, type: AutoCompleteFilterCellComponent, decorators: [{
             type: Component,
             args: [{

package/esm2020/filtering/cell/numeric-filter-cell.component.mjs

@@ -101,7 +101,7 @@ NumericFilterCellComponent.ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "12.0
                 </kendo-numerictextbox-messages>
             </kendo-numerictextbox>
         </kendo-grid-filter-wrapper-cell>
-    `, isInline: true, components: [{ type: i4.FilterCellWrapperComponent, selector: "kendo-grid-filter-wrapper-cell", inputs: ["showOperators"] }, { type: i5.NumericTextBoxComponent, selector: "kendo-numerictextbox", inputs: ["focusableId", "disabled", "readonly", "title", "autoCorrect", "format", "max", "min", "decimals", "placeholder", "step", "spinners", "rangeValidation", "tabindex", "tabIndex", "changeValueOnScroll", "selectOnFocus", "value", "maxlength", "size", "rounded", "fillMode"], outputs: ["valueChange", "focus", "blur"], exportAs: ["kendoNumericTextBox"] }, { type: i5.NumericTextBoxCustomMessagesComponent, selector: "kendo-numerictextbox-messages" }], directives: [{ type: i6.FocusableDirective, selector: "[kendoGridFocusable],\n        [kendoGridEditCommand],\n        [kendoGridRemoveCommand],\n        [kendoGridSaveCommand],\n        [kendoGridCancelCommand],\n        [kendoGridSelectionCheckbox]\n    ", inputs: ["kendoGridFocusable"] }, { type: i7.FilterInputDirective, selector: "[kendoFilterInput]", inputs: ["filterDelay", "columnLabel", "value"] }] });
+    `, isInline: true, components: [{ type: i4.FilterCellWrapperComponent, selector: "kendo-grid-filter-wrapper-cell", inputs: ["showOperators"] }, { type: i5.NumericTextBoxComponent, selector: "kendo-numerictextbox", inputs: ["focusableId", "disabled", "readonly", "title", "autoCorrect", "format", "max", "min", "decimals", "placeholder", "step", "spinners", "rangeValidation", "tabindex", "tabIndex", "changeValueOnScroll", "selectOnFocus", "value", "maxlength", "size", "rounded", "fillMode"], outputs: ["valueChange", "focus", "blur", "inputFocus", "inputBlur"], exportAs: ["kendoNumericTextBox"] }, { type: i5.NumericTextBoxCustomMessagesComponent, selector: "kendo-numerictextbox-messages" }], directives: [{ type: i6.FocusableDirective, selector: "[kendoGridFocusable],\n        [kendoGridEditCommand],\n        [kendoGridRemoveCommand],\n        [kendoGridSaveCommand],\n        [kendoGridCancelCommand],\n        [kendoGridSelectionCheckbox]\n    ", inputs: ["kendoGridFocusable"] }, { type: i7.FilterInputDirective, selector: "[kendoFilterInput]", inputs: ["filterDelay", "columnLabel", "value"] }] });
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImport: i0, type: NumericFilterCellComponent, decorators: [{
             type: Component,
             args: [{

package/esm2020/filtering/menu/filter-menu-container.component.mjs

@@ -157,7 +157,7 @@ FilterMenuContainerComponent.ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "12
         MenuTabbingService
     ], viewQueries: [{ propertyName: "resetButton", first: true, predicate: ["resetButton"], descendants: true }, { propertyName: "filterButton", first: true, predicate: ["filterButton"], descendants: true }], ngImport: i0, template: `
         <form (submit)="submit()" (reset)="reset()"
-            class="k-filter-menu k-group k-reset k-state-border-up">
+            class="k-filter-menu">
             <div class="k-filter-menu-container">
                 <ng-container [ngSwitch]="hasTemplate">
                     <ng-container *ngSwitchCase="false">
@@ -203,7 +203,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImpo
                     selector: 'kendo-grid-filter-menu-container',
                     template: `
         <form (submit)="submit()" (reset)="reset()"
-            class="k-filter-menu k-group k-reset k-state-border-up">
+            class="k-filter-menu">
             <div class="k-filter-menu-container">
                 <ng-container [ngSwitch]="hasTemplate">
                     <ng-container *ngSwitchCase="false">

package/esm2020/filtering/menu/numeric-filter-menu-input.component.mjs

@@ -75,7 +75,7 @@ NumericFilterMenuInputComponent.ɵcmp = i0.ɵɵngDeclareComponent({ minVersion:
                 </kendo-numerictextbox-messages>
             </kendo-numerictextbox>
         </kendo-grid-filter-menu-input-wrapper>
-    `, isInline: true, components: [{ type: i2.FilterMenuInputWrapperComponent, selector: "kendo-grid-filter-menu-input-wrapper", inputs: ["filterService", "isFirstDropDown", "menuTabbingService", "currentFilter"] }, { type: i3.NumericTextBoxComponent, selector: "kendo-numerictextbox", inputs: ["focusableId", "disabled", "readonly", "title", "autoCorrect", "format", "max", "min", "decimals", "placeholder", "step", "spinners", "rangeValidation", "tabindex", "tabIndex", "changeValueOnScroll", "selectOnFocus", "value", "maxlength", "size", "rounded", "fillMode"], outputs: ["valueChange", "focus", "blur"], exportAs: ["kendoNumericTextBox"] }, { type: i3.NumericTextBoxCustomMessagesComponent, selector: "kendo-numerictextbox-messages" }], directives: [{ type: i4.FilterInputDirective, selector: "[kendoFilterInput]", inputs: ["filterDelay", "columnLabel", "value"] }] });
+    `, isInline: true, components: [{ type: i2.FilterMenuInputWrapperComponent, selector: "kendo-grid-filter-menu-input-wrapper", inputs: ["filterService", "isFirstDropDown", "menuTabbingService", "currentFilter"] }, { type: i3.NumericTextBoxComponent, selector: "kendo-numerictextbox", inputs: ["focusableId", "disabled", "readonly", "title", "autoCorrect", "format", "max", "min", "decimals", "placeholder", "step", "spinners", "rangeValidation", "tabindex", "tabIndex", "changeValueOnScroll", "selectOnFocus", "value", "maxlength", "size", "rounded", "fillMode"], outputs: ["valueChange", "focus", "blur", "inputFocus", "inputBlur"], exportAs: ["kendoNumericTextBox"] }, { type: i3.NumericTextBoxCustomMessagesComponent, selector: "kendo-numerictextbox-messages" }], directives: [{ type: i4.FilterInputDirective, selector: "[kendoFilterInput]", inputs: ["filterDelay", "columnLabel", "value"] }] });
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImport: i0, type: NumericFilterMenuInputComponent, decorators: [{
             type: Component,
             args: [{

package/esm2020/grid.component.mjs

@@ -77,6 +77,8 @@ import { DragTargetContainerDirective, DropTargetContainerDirective } from '@pro
 import { RowReorderService } from './row-reordering/row-reorder.service';
 import { StatusBarTemplateDirective } from './aggregates/status-bar-template.directive';
 import { CellSelectionAggregateService } from './aggregates/selection-aggregate.service';
+import { ClipboardService } from './common/clipboard.service';
+import { ColumnConfigurationErrorMessages, GridConfigurationErrorMessages } from './common/error-messages';
 import * as i0 from "@angular/core";
 import * as i1 from "./layout/browser-support.service";
 import * as i2 from "./selection/selection.service";
@@ -128,11 +130,7 @@ const createControl = (source) => (acc, key) => {
 const validateColumnsField = (columns) => expandColumns(columns.toArray())
     .filter(isColumnComponent)
     .filter(({ field }) => !isValidFieldName(field))
-    .forEach(({ field }) => console.warn(`
-                Grid column field name '${field}' does not look like a valid JavaScript identifier.
-                Identifiers can contain only alphanumeric characters (including "$" or "_"), and may not start with a digit.
-                Please use only valid identifier names to ensure error-free operation.
-            `));
+    .forEach(({ field }) => console.warn(ColumnConfigurationErrorMessages.fieldName(field)));
 const handleExpandCollapseGroupsService = (service, expandEmitter, collapseEmitter, map) => (service.changes.pipe(filter(({ group }) => isPresent(group)))
     .subscribe((x) => x.expand ? expandEmitter.emit(map(x)) : collapseEmitter.emit(map(x))));
 const handleExpandCollapseDetailsService = (service, expandEmitter, collapseEmitter, map) => (service.changes.pipe(filter(({ dataItem }) => isPresent(dataItem)))
@@ -647,7 +645,7 @@ export class GridComponent {
      */
     set rowClass(fn) {
         if (isDevMode() && typeof fn !== 'function') {
-            throw new Error(`rowClass must be a function, but received ${JSON.stringify(fn)}.`);
+            throw new Error(GridConfigurationErrorMessages.functionType('rowClass', fn));
         }
         this._rowClass = fn;
     }
@@ -660,7 +658,7 @@ export class GridComponent {
      */
     set rowSticky(fn) {
         if (isDevMode() && isPresent(fn) && typeof fn !== 'function') {
-            throw new Error(`rowSticky must be a function, but received ${JSON.stringify(fn)}.`);
+            throw new Error(GridConfigurationErrorMessages.functionType('rowSticky', fn));
         }
         if (isPresent(fn)) {
             this._rowSticky = fn;
@@ -676,7 +674,7 @@ export class GridComponent {
      */
     set rowSelected(fn) {
         if (isDevMode() && typeof fn !== 'function') {
-            throw new Error(`rowSelected must be a function, but received ${JSON.stringify(fn)}.`);
+            throw new Error(GridConfigurationErrorMessages.functionType('rowSelected', fn));
         }
         this._rowSelected = fn;
     }
@@ -693,7 +691,7 @@ export class GridComponent {
      */
     set cellSelected(fn) {
         if (isDevMode() && typeof fn !== 'function') {
-            throw new Error(`cellSelected must be a function, but received ${JSON.stringify(fn)}.`);
+            throw new Error(GridConfigurationErrorMessages.functionType('cellSelected', fn));
         }
         this._cellSelected = fn;
     }
@@ -712,6 +710,16 @@ export class GridComponent {
     get activeRow() {
         return this.navigationService.activeRow;
     }
+    /**
+     * Returns the current Grid selection.
+     *
+     * @hidden
+     */
+    get selection() {
+        return (this.selectable || this.selectionDirective) ?
+            this.defaultSelection ? this.defaultSelection.stateToArray() : this.selectionDirective.stateToArray() :
+            [];
+    }
     /**
      * Specifies if the loading indicator of the Grid will be displayed ([see example]({% slug binding_grid %})).
      *
@@ -1628,7 +1636,7 @@ export class GridComponent {
             instance = column;
         }
         if (!instance && isDevMode()) {
-            throw new Error(`Invalid column ${column}`);
+            throw new Error(ColumnConfigurationErrorMessages.invalidColumn(column));
         }
         return instance;
     }
@@ -1637,43 +1645,43 @@ export class GridComponent {
             const locked = this.lockedLeafColumns.length || (this.columnMenu && this.columnMenu.lock);
             const stickyColumns = this.stickyColumns.length || (this.columnMenu && this.columnMenu.stick);
             if (locked && this.detailTemplate) {
-                throw new Error('Having both detail template and locked columns is not supported.');
+                throw new Error(GridConfigurationErrorMessages.incompatibleFeatures('detail template', 'locked columns'));
             }
             if (stickyColumns && this.detailTemplate) {
-                throw new Error('Having both detail template and sticky columns is not supported.');
+                throw new Error(GridConfigurationErrorMessages.incompatibleFeatures('detail template', 'sticky columns'));
             }
             if (this.lockedLeafColumns.length && !this.nonLockedLeafColumns.length) {
-                throw new Error('There should be at least one non-locked column');
+                throw new Error(GridConfigurationErrorMessages.nonLockedColumnPresent);
             }
             if ((locked || this.virtualColumns) && expandColumns(this.columnList.toArray()).filter(column => !column.width && !isColumnGroupComponent(column)).length) {
-                throw new Error((locked ? 'Locked' : 'Virtual') + ' columns feature requires all columns to have set width.');
+                throw new Error(ColumnConfigurationErrorMessages.requiredWidth(locked ? 'Locked' : 'Virtual'));
             }
             if (locked && !this.isScrollable) {
-                throw new Error('Locked columns are only supported when scrolling is enabled.');
+                throw new Error(ColumnConfigurationErrorMessages.requiredScroll('Locked'));
+            }
+            if (stickyColumns && !this.isScrollable) {
+                throw new Error(ColumnConfigurationErrorMessages.requiredScroll('Sticky'));
             }
             if (this.columnList.filter(isColumnGroupComponent).filter((x) => !x.hasChildren).length) {
-                throw new Error('ColumnGroupComponent should contain ColumnComponent or CommandColumnComponent.');
+                throw new Error(ColumnConfigurationErrorMessages.groupColumnContent);
             }
             if (this.columnList.filter(x => x.locked && x.parent && !x.parent.isLocked).length) {
-                throw new Error('Locked child columns require their parent columns to be locked.');
+                throw new Error(ColumnConfigurationErrorMessages.lockedParent);
             }
             if ((this.rowHeight || this.detailRowHeight) && !this.isVirtual) {
-                throw new Error('Row height and detail row height settings require virtual scrolling mode to be enabled.');
+                throw new Error(GridConfigurationErrorMessages.rowHeightVirtual);
             }
             if (stickyColumns && expandColumns(this.columnList.toArray()).filter(column => !column.width && !isColumnGroupComponent(column)).length) {
-                throw new Error('Sticky columns feature requires all columns to have set width.');
-            }
-            if (stickyColumns && !this.isScrollable) {
-                throw new Error('Sticky columns are only supported when scrolling is enabled.');
+                throw new Error(ColumnConfigurationErrorMessages.requiredWidth('Sticky'));
             }
             if (stickyColumns && this.virtualColumns) {
-                throw new Error('Having both sticky columns and column virtualization is not supported.');
+                throw new Error(GridConfigurationErrorMessages.incompatibleFeatures('sticky columns', 'column virtualization'));
             }
             if (this.rowSticky && this.scrollable === 'virtual') {
-                throw new Error('Having both sticky rows and row virtualization (scrollable="virtual") is not supported.');
+                throw new Error(GridConfigurationErrorMessages.incompatibleFeatures('sticky rows', 'row virtualization (scrollable="virtual")'));
             }
             if (this.rowSticky && this.groupable) {
-                throw new Error('Having both sticky rows and grouping is not supported.');
+                throw new Error(GridConfigurationErrorMessages.incompatibleFeatures('sticky rows', 'grouping'));
             }
             validateColumnsField(this.columnList);
         }
@@ -1872,7 +1880,7 @@ export class GridComponent {
     }
     assertNavigable() {
         if (isDevMode() && !this.navigationService.enabled) {
-            throw new Error('The Grid should be configured as navigable to control focus');
+            throw new Error(GridConfigurationErrorMessages.focusNavigable);
         }
     }
     navigationMetadata() {
@@ -1944,9 +1952,7 @@ export class GridComponent {
     toggleDetailRowLegacy(index, expand) {
         const hasCallback = typeof this.isDetailExpanded === 'function';
         if (isDevMode() && hasCallback) {
-            throw new Error('The expandRow and collapseRow methods should not be called when using the ' +
-                'kendoGridDetailsExpandBy directive or the isDetailExpanded callback. ' +
-                'These methods are provided only for backwards compatibility with legacy versions.');
+            throw new Error(GridConfigurationErrorMessages.expandCollapseMethods('expandRow', 'collapseRow', 'kendoGridDetailsExpandBy', 'isDetailExpanded'));
         }
         if (!isDevMode() && hasCallback) {
             return;
@@ -1958,9 +1964,7 @@ export class GridComponent {
     toggleGroupRowLegacy(index, expand) {
         const hasCallback = typeof this.isGroupExpanded === 'function';
         if (isDevMode() && hasCallback) {
-            throw new Error('The expandGroup and collapseGroup methods should not be called when using the ' +
-                'kendoGridExpandGroupBy directive or the isGroupExpanded callback. ' +
-                'These methods are provided only for backwards compatibility with legacy versions.');
+            throw new Error(GridConfigurationErrorMessages.expandCollapseMethods('expandGroup', 'collapseGroup', 'kendoGridExpandGroupBy', 'isGroupExpanded'));
         }
         if (!isDevMode() && hasCallback) {
             return;
@@ -2034,7 +2038,8 @@ GridComponent.ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "12.0.0", version:
         SortService,
         ContextService,
         SizingOptionsService,
-        RowReorderService
+        RowReorderService,
+        ClipboardService
     ], queries: [{ propertyName: "columns", predicate: ColumnBase }, { propertyName: "detailTemplateChildren", predicate: DetailTemplateDirective }, { propertyName: "cellLoadingTemplateChildren", predicate: CellLoadingTemplateDirective }, { propertyName: "loadingTemplateChildren", predicate: LoadingTemplateDirective }, { propertyName: "statusBarTemplateChildren", predicate: StatusBarTemplateDirective }, { propertyName: "noRecordsTemplateChildren", predicate: NoRecordsTemplateDirective }, { propertyName: "pagerTemplateChildren", predicate: PagerTemplateDirective }, { propertyName: "toolbarTemplateChildren", predicate: ToolbarTemplateDirective }, { propertyName: "columnMenuTemplates", predicate: ColumnMenuTemplateDirective }], viewQueries: [{ propertyName: "lockedHeader", first: true, predicate: ["lockedHeader"], descendants: true }, { propertyName: "header", first: true, predicate: ["header"], descendants: true }, { propertyName: "ariaRoot", first: true, predicate: ["ariaRoot"], descendants: true, static: true }, { propertyName: "dragTargetContainer", first: true, predicate: DragTargetContainerDirective, descendants: true }, { propertyName: "dropTargetContainer", first: true, predicate: DropTargetContainerDirective, descendants: true }, { propertyName: "footer", predicate: ["footer"], descendants: true }], exportAs: ["kendoGrid"], usesOnChanges: true, ngImport: i0, template: `
         <ng-container kendoGridLocalizedMessages
             i18n-groupPanelEmpty="kendo.grid.groupPanelEmpty|The label visible in the Grid group panel when it is empty"
@@ -2662,7 +2667,8 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImpo
                         SortService,
                         ContextService,
                         SizingOptionsService,
-                        RowReorderService
+                        RowReorderService,
+                        ClipboardService
                     ],
                     selector: 'kendo-grid',
                     template: `