@progress/kendo-angular-grid 14.4.0-develop.14 → 14.4.0-develop.16

package/esm2020/common/clipboard.service.mjs

@@ -0,0 +1,191 @@
+/**-----------------------------------------------------------------------------------------
+* 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: ''
+        };
+        if (options.wholeRow) {
+            const fieldCols = columns.flatMap(c => c instanceof ColumnComponent && isPresent(c.field) ? [c] : []);
+            this.targetColField = fieldCols[0]?.field;
+            this.targetRowIndex = data[0].dataRowIndex;
+            const clipboardData = { items: [], dataStrings: [] };
+            const colFields = fieldCols.map(c => c.field);
+            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 {
+            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;
+                    }
+                    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) {
+                        result.gridItems.push({
+                            dataItem: item.dataItem,
+                            fields: selectedColFields
+                        });
+                    }
+                    return existingItem ? options.copyHeaders ? [this.addHeaders(itemString, selectedFieldCols)] : [itemString] : [];
+                }).join(`\r\n`);
+            }
+        }
+        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,50 @@
  */
 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 = {
+    clipboardTarget: 'The "clipboardTarget" option must be set for the ClipboardDirective to function as designed.',
+    activeCellNavigable: 'Grid must be navigable to use "activeCell" as clipboard target type.',
+    selectionStartSelectable: 'Grid must be selectable to use "selectionStart" 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/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: `

package/esm2020/grid.module.mjs

@@ -34,6 +34,7 @@ import { FilterMenuModule } from "./filtering/menu/filter-menu.module";
 import { ColumnMenuModule } from './column-menu/column-menu.module';
 import { GridToolbarFocusableDirective } from './rendering/toolbar/toolbar-focusable.directive';
 import { DragAndDropModule } from '@progress/kendo-angular-utils';
+import { GridClipboardDirective } from './common/clipboard.directive';
 import * as i0 from "@angular/core";
 import * as i1 from "./grouping/group-header-template.directive";
 import * as i2 from "./grouping/group-header-column-template.directive";
@@ -144,7 +145,8 @@ const exportedModules = [
     ...PagerModule.exports(),
     ...RowFilterModule.exports(),
     ...FilterMenuModule.exports(),
-    ...ColumnMenuModule.exports()
+    ...ColumnMenuModule.exports(),
+    GridClipboardDirective
 ];
 const declarations = [
     GridComponent,
@@ -165,7 +167,8 @@ const declarations = [
     GridSpacerComponent,
     GridToolbarFocusableDirective,
     StatusBarComponent,
-    StatusBarTemplateDirective
+    StatusBarTemplateDirective,
+    GridClipboardDirective
 ];
 /**
  * Represents the [NgModule](link:site.data.urls.angular['ngmoduleapi'])
@@ -209,7 +212,8 @@ GridModule.ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "12.0.0", version: "13
         GridSpacerComponent,
         GridToolbarFocusableDirective,
         StatusBarComponent,
-        StatusBarTemplateDirective], imports: [CommonModule,
+        StatusBarTemplateDirective,
+        GridClipboardDirective], imports: [CommonModule,
         GroupModule,
         SharedModule,
         BodyModule,
@@ -235,7 +239,7 @@ GridModule.ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "12.0.0", version: "13
         InCellEditingDirective,
         ExpandDetailsDirective,
         ExpandGroupDirective,
-        GridToolbarFocusableDirective, i1.GroupHeaderTemplateDirective, i2.GroupHeaderColumnTemplateDirective, i3.GroupFooterTemplateDirective, i4.ColumnComponent, i5.SpanColumnComponent, i6.ColumnGroupComponent, i7.FooterTemplateDirective, i8.DetailTemplateDirective, i9.FocusableDirective, i10.GridTableDirective, i11.CommandColumnComponent, i12.CheckboxColumnComponent, i13.SelectionCheckboxDirective, i14.CellTemplateDirective, i15.NoRecordsTemplateDirective, i16.EditTemplateDirective, i17.EditCommandDirective, i18.CancelCommandDirective, i19.SaveCommandDirective, i20.RemoveCommandDirective, i21.AddCommandDirective, i22.CellLoadingTemplateDirective, i23.LoadingTemplateDirective, i24.RowReorderColumnComponent, i25.HeaderTemplateDirective, i26.SelectAllCheckboxDirective, i27.PagerComponent, i28.PagerPrevButtonsComponent, i29.PagerNextButtonsComponent, i30.PagerNumericButtonsComponent, i31.PagerInputComponent, i32.PagerInfoComponent, i33.PagerPageSizesComponent, i34.PagerTemplateDirective, i35.PagerDropDownListDirective, i36.PagerInputDirective, i37.FilterRowComponent, i38.FilterCellComponent, i39.FilterCellTemplateDirective, i40.FilterCellOperatorsComponent, i41.StringFilterCellComponent, i42.NumericFilterCellComponent, i43.AutoCompleteFilterCellComponent, i44.BooleanFilterCellComponent, i45.DateFilterCellComponent, i40.FilterCellOperatorsComponent, i46.ContainsFilterOperatorComponent, i47.DoesNotContainFilterOperatorComponent, i48.EndsWithFilterOperatorComponent, i49.EqualFilterOperatorComponent, i50.IsEmptyFilterOperatorComponent, i51.IsNotEmptyFilterOperatorComponent, i52.IsNotNullFilterOperatorComponent, i53.IsNullFilterOperatorComponent, i54.NotEqualFilterOperatorComponent, i55.StartsWithFilterOperatorComponent, i56.GreaterFilterOperatorComponent, i57.GreaterOrEqualToFilterOperatorComponent, i58.LessFilterOperatorComponent, i59.LessOrEqualToFilterOperatorComponent, i60.AfterFilterOperatorComponent, i61.AfterEqFilterOperatorComponent, i62.BeforeEqFilterOperatorComponent, i63.BeforeFilterOperatorComponent, i64.StringFilterMenuComponent, i65.FilterMenuTemplateDirective, i66.NumericFilterMenuComponent, i67.DateFilterMenuComponent, i68.BooleanFilterMenuComponent, i69.FilterMenuDropDownListDirective, i70.BooleanFilterRadioButtonDirective, i40.FilterCellOperatorsComponent, i46.ContainsFilterOperatorComponent, i47.DoesNotContainFilterOperatorComponent, i48.EndsWithFilterOperatorComponent, i49.EqualFilterOperatorComponent, i50.IsEmptyFilterOperatorComponent, i51.IsNotEmptyFilterOperatorComponent, i52.IsNotNullFilterOperatorComponent, i53.IsNullFilterOperatorComponent, i54.NotEqualFilterOperatorComponent, i55.StartsWithFilterOperatorComponent, i56.GreaterFilterOperatorComponent, i57.GreaterOrEqualToFilterOperatorComponent, i58.LessFilterOperatorComponent, i59.LessOrEqualToFilterOperatorComponent, i60.AfterFilterOperatorComponent, i61.AfterEqFilterOperatorComponent, i62.BeforeEqFilterOperatorComponent, i63.BeforeFilterOperatorComponent, i71.ColumnChooserComponent, i72.ColumnMenuFilterComponent, i73.ColumnMenuItemComponent, i74.ColumnMenuItemContentTemplateDirective, i75.ColumnMenuSortComponent, i76.ColumnMenuLockComponent, i77.ColumnMenuStickComponent, i78.ColumnMenuPositionComponent, i79.ColumnMenuChooserComponent, i80.ColumnMenuTemplateDirective, i81.ColumnMenuContainerComponent, i82.ColumnMenuItemDirective, i83.ColumnMenuComponent, i84.ColumnMenuAutoSizeColumnComponent, i85.ColumnMenuAutoSizeAllColumnsComponent] });
+        GridToolbarFocusableDirective, i1.GroupHeaderTemplateDirective, i2.GroupHeaderColumnTemplateDirective, i3.GroupFooterTemplateDirective, i4.ColumnComponent, i5.SpanColumnComponent, i6.ColumnGroupComponent, i7.FooterTemplateDirective, i8.DetailTemplateDirective, i9.FocusableDirective, i10.GridTableDirective, i11.CommandColumnComponent, i12.CheckboxColumnComponent, i13.SelectionCheckboxDirective, i14.CellTemplateDirective, i15.NoRecordsTemplateDirective, i16.EditTemplateDirective, i17.EditCommandDirective, i18.CancelCommandDirective, i19.SaveCommandDirective, i20.RemoveCommandDirective, i21.AddCommandDirective, i22.CellLoadingTemplateDirective, i23.LoadingTemplateDirective, i24.RowReorderColumnComponent, i25.HeaderTemplateDirective, i26.SelectAllCheckboxDirective, i27.PagerComponent, i28.PagerPrevButtonsComponent, i29.PagerNextButtonsComponent, i30.PagerNumericButtonsComponent, i31.PagerInputComponent, i32.PagerInfoComponent, i33.PagerPageSizesComponent, i34.PagerTemplateDirective, i35.PagerDropDownListDirective, i36.PagerInputDirective, i37.FilterRowComponent, i38.FilterCellComponent, i39.FilterCellTemplateDirective, i40.FilterCellOperatorsComponent, i41.StringFilterCellComponent, i42.NumericFilterCellComponent, i43.AutoCompleteFilterCellComponent, i44.BooleanFilterCellComponent, i45.DateFilterCellComponent, i40.FilterCellOperatorsComponent, i46.ContainsFilterOperatorComponent, i47.DoesNotContainFilterOperatorComponent, i48.EndsWithFilterOperatorComponent, i49.EqualFilterOperatorComponent, i50.IsEmptyFilterOperatorComponent, i51.IsNotEmptyFilterOperatorComponent, i52.IsNotNullFilterOperatorComponent, i53.IsNullFilterOperatorComponent, i54.NotEqualFilterOperatorComponent, i55.StartsWithFilterOperatorComponent, i56.GreaterFilterOperatorComponent, i57.GreaterOrEqualToFilterOperatorComponent, i58.LessFilterOperatorComponent, i59.LessOrEqualToFilterOperatorComponent, i60.AfterFilterOperatorComponent, i61.AfterEqFilterOperatorComponent, i62.BeforeEqFilterOperatorComponent, i63.BeforeFilterOperatorComponent, i64.StringFilterMenuComponent, i65.FilterMenuTemplateDirective, i66.NumericFilterMenuComponent, i67.DateFilterMenuComponent, i68.BooleanFilterMenuComponent, i69.FilterMenuDropDownListDirective, i70.BooleanFilterRadioButtonDirective, i40.FilterCellOperatorsComponent, i46.ContainsFilterOperatorComponent, i47.DoesNotContainFilterOperatorComponent, i48.EndsWithFilterOperatorComponent, i49.EqualFilterOperatorComponent, i50.IsEmptyFilterOperatorComponent, i51.IsNotEmptyFilterOperatorComponent, i52.IsNotNullFilterOperatorComponent, i53.IsNullFilterOperatorComponent, i54.NotEqualFilterOperatorComponent, i55.StartsWithFilterOperatorComponent, i56.GreaterFilterOperatorComponent, i57.GreaterOrEqualToFilterOperatorComponent, i58.LessFilterOperatorComponent, i59.LessOrEqualToFilterOperatorComponent, i60.AfterFilterOperatorComponent, i61.AfterEqFilterOperatorComponent, i62.BeforeEqFilterOperatorComponent, i63.BeforeFilterOperatorComponent, i71.ColumnChooserComponent, i72.ColumnMenuFilterComponent, i73.ColumnMenuItemComponent, i74.ColumnMenuItemContentTemplateDirective, i75.ColumnMenuSortComponent, i76.ColumnMenuLockComponent, i77.ColumnMenuStickComponent, i78.ColumnMenuPositionComponent, i79.ColumnMenuChooserComponent, i80.ColumnMenuTemplateDirective, i81.ColumnMenuContainerComponent, i82.ColumnMenuItemDirective, i83.ColumnMenuComponent, i84.ColumnMenuAutoSizeColumnComponent, i85.ColumnMenuAutoSizeAllColumnsComponent, GridClipboardDirective] });
 GridModule.ɵinj = i0.ɵɵngDeclareInjector({ minVersion: "12.0.0", version: "13.3.12", ngImport: i0, type: GridModule, imports: [[
             CommonModule,
             GroupModule,

package/esm2020/grouping/group-scroll-binding.directive.mjs

@@ -9,6 +9,7 @@ import { filterBy, process } from "@progress/kendo-data-query";
 import { isPresent, isArray } from "../utils";
 import { diffFilters, cloneFilters } from "../common/filter-descriptor-differ";
 import { LocalDataChangesService } from "../editing/local-data-changes.service";
+import { GridConfigurationErrorMessages } from '../common/error-messages';
 import * as i0 from "@angular/core";
 import * as i1 from "../grid.component";
 import * as i2 from "../editing/local-data-changes.service";
@@ -193,9 +194,7 @@ export class GroupBindingDirective extends DataBindingDirective {
     }
     ngAfterContentInit() {
         if (isDevMode() && this.grid.isGroupExpanded) {
-            throw new Error('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`.');
+            throw new Error(GridConfigurationErrorMessages.groupBindingDirectives);
         }
     }
     groupExpand({ groupIndex }) {

package/esm2020/index.mjs

@@ -151,6 +151,8 @@ export { ColumnMenuComponent } from './column-menu/column-menu.component';
 export { ColumnLockedChangeEvent } from './column-menu/column-locked-change-event';
 export { ColumnStickyChangeEvent } from './column-menu/column-sticky-change-event';
 export { SinglePopupService, PopupCloseEvent } from './common/single-popup.service';
+// Clipboard
+export { GridClipboardDirective } from './common/clipboard.directive';
 // addresses error NG3001: Unsupported private class
 export { ColumnMenuTemplateDirective } from './column-menu/column-menu-template.directive';
 export { EditCommandDirective } from './editing/edit-command.directive';

package/esm2020/package-metadata.mjs

@@ -9,7 +9,7 @@ export const packageMetadata = {
     name: '@progress/kendo-angular-grid',
     productName: 'Kendo UI for Angular',
     productCodes: ['KENDOUIANGULAR', 'KENDOUICOMPLETE'],
-    publishDate: 1705930325,
-    version: '14.4.0-develop.14',
+    publishDate: 1706186543,
+    version: '14.4.0-develop.16',
     licensingDocsUrl: 'https://www.telerik.com/kendo-angular-ui/my-license/'
 };

package/esm2020/pdf/pdf.component.mjs

@@ -14,6 +14,7 @@ import { ColumnBase } from '../columns/column-base';
 import { PDFExportComponent } from '@progress/kendo-angular-pdf-export';
 import { isDocumentAvailable } from '@progress/kendo-angular-common';
 import { ContextService } from '../common/provider.service';
+import { GridConfigurationErrorMessages } from '../common/error-messages';
 import * as i0 from "@angular/core";
 import * as i1 from "./pdf.service";
 import * as i2 from "../scrolling/suspend.service";
@@ -61,13 +62,13 @@ export class PDFComponent extends PDFExportComponent {
      * @hidden
      */
     saveAs(_) {
-        throw new Error('Not supported. Use GridComponent.saveAsPDF');
+        throw new Error(GridConfigurationErrorMessages.unsupportedMethod('saveAs', 'GridComponent.saveAsPDF'));
     }
     /**
      * @hidden
      */
     export() {
-        throw new Error('Not supported. Use GridComponent.drawPDF');
+        throw new Error(GridConfigurationErrorMessages.unsupportedMethod('export', 'GridComponent.drawPDF'));
     }
     savePDF(component) {
         this.createPDF(component, this.draw);