@progress/kendo-angular-spreadsheet 23.3.0-develop.22 → 23.3.0-develop.23

package/README.md

@@ -19,13 +19,23 @@ The Kendo UI for Angular Spreadsheet allows you to create, edit, and manipulate
 
 Among the many features which the Kendo UI for Angular Spreadsheet delivers are:
 
-* Toolbar Tools—The Spreadsheet component provides a variety of built-in tools that help you to create, edit, and style the sheet data. [Read more about the built-in toolbar tools of the Spreadsheet...](https://www.telerik.com/kendo-angular-ui/components/spreadsheet/tools)
+* Data Binding—The Spreadsheet loads data through the `sheets` property which accepts a collection of `SheetDescriptor` objects that define the rows, cells, columns, and formatting for each sheet. [Read more about data binding in the Spreadsheet...](https://www.telerik.com/kendo-angular-ui/components/spreadsheet/data-binding)
+* Importing and Exporting Data—The Spreadsheet supports importing and exporting data in `.xlsx` (Excel) and JSON formats, and exporting the active worksheet to PDF. [Read more about data import and export in the Spreadsheet...](https://www.telerik.com/kendo-angular-ui/components/spreadsheet/data-import-export)
+* Menu and Toolbar Tools—The Spreadsheet component provides a variety of built-in menu and toolbar tools that help you to create, edit, and style the sheet data. [Read more about the built-in menu and toolbar tools of the Spreadsheet...](https://www.telerik.com/kendo-angular-ui/components/spreadsheet/tools)
+* Filtering and Sorting—The Spreadsheet provides filtering and sorting capabilities to help you manage large datasets. [Read more about filtering and sorting in the Spreadsheet...](https://www.telerik.com/kendo-angular-ui/components/spreadsheet/filtering-sorting)
+* Data Validation—The Spreadsheet provides a built-in data validation tool that allows you to restrict the type of data that can be entered into a cell or range of cells. [Read more about the data validation tool of the Spreadsheet...](https://www.telerik.com/kendo-angular-ui/components/spreadsheet/validations)
+* Custom Cell Editors—The Spreadsheet allows you to create custom cell editors that extend the built-in editing capabilities with specialized input controls for specific data types. [Read more about implementing custom cell editors for the Spreadsheet...](https://www.telerik.com/kendo-angular-ui/components/spreadsheet/custom-cell-editors)
+* Disabled Cells—The Spreadsheet lets you mark individual cells or ranges as disabled to prevent users from modifying protected data. [Read more about disabling cells in the Spreadsheet...](https://www.telerik.com/kendo-angular-ui/components/spreadsheet/disabled-cells)
+* Cell Comments—The Spreadsheet allows you to attach text comments to individual cells as annotations that provide additional context. [Read more about cell comments in the Spreadsheet...](https://www.telerik.com/kendo-angular-ui/components/spreadsheet/cell-comments)
 * Action Bar—The Spreadsheet action bar allows you to control the cell selection and calculate cell values by entering formulas into the dedicated formula input. [Read more about the action bar capabilities of the Spreadsheet...](https://www.telerik.com/kendo-angular-ui/components/spreadsheet/action-bar)
+* Built-in Formulas—The Spreadsheet supports a comprehensive set of built-in formulas for mathematical, statistical, logical, text, and date operations. [Read more about the built-in formulas of the Spreadsheet...](https://www.telerik.com/kendo-angular-ui/components/spreadsheet/built-in-formulas)
 * Sheets Bar—The sheets bar provides a convenient way to rename, duplicate, and delete sheets as necessary. [Read more about the sheets bar options of the Spreadsheet...](https://www.telerik.com/kendo-angular-ui/components/spreadsheet/sheets-bar)
+* Context Menu—The Spreadsheet context menu provides quick access to common actions. You can modify the context menu items, add custom actions, or prevent the menu from opening. [Read more about the context menu of the Spreadsheet...](https://www.telerik.com/kendo-angular-ui/components/spreadsheet/context-menu)
 * Appearance—You can use the options provided by the Spreadsheet component to customize its appearance. [Read more about the customizable appearance of the Spreadsheet...](https://www.telerik.com/kendo-angular-ui/components/spreadsheet/appearance)
 * Events—The Spreadsheet exposes several events to let you easily handle any file operations logic. [Read more about the events of the Spreadsheet...](https://www.telerik.com/kendo-angular-ui/components/spreadsheet/events)
-* Accessibility—The Spreadsheet is accessible for screen readers and supports WAI-ARIA attributes. [Read more about the accessibility of the Spreadsheet...](https://www.telerik.com/kendo-angular-ui/components/spreadsheet/accessibility)
 * Keyboard Navigation—The Spreadsheet supports a number of keyboard shortcuts which allow users to accomplish various commands. [Read more about the keyboard navigation of the Spreadsheet...](https://www.telerik.com/kendo-angular-ui/components/spreadsheet/keyboard-navigation)
+* Globalization—The Spreadsheet provides internationalization, localization, and right-to-left support to adapt the component to different languages and cultures. [Read more about the globalization of the Spreadsheet...](https://www.telerik.com/kendo-angular-ui/components/spreadsheet/globalization)
+* Accessibility—The Spreadsheet is accessible for screen readers and supports WAI-ARIA attributes. [Read more about the accessibility of the Spreadsheet...](https://www.telerik.com/kendo-angular-ui/components/spreadsheet/accessibility)
 
 ## Support Options
 

package/default-context-menu-items.d.ts

@@ -0,0 +1,17 @@
+/**-----------------------------------------------------------------------------------------
+* Copyright © 2026 Progress Software Corporation. All rights reserved.
+* Licensed under commercial license. See LICENSE.md in the project root for more information
+*-------------------------------------------------------------------------------------------*/
+import { SpreadsheetContextMenuAction } from "./models";
+/**
+ * @hidden
+ */
+export declare const COMMON_ITEMS: SpreadsheetContextMenuAction[];
+/**
+ * @hidden
+ */
+export declare const ROWHEADER_ITEMS: SpreadsheetContextMenuAction[];
+/**
+ * @hidden
+ */
+export declare const COLUMNHEADER_ITEMS: SpreadsheetContextMenuAction[];

package/fesm2022/progress-kendo-angular-spreadsheet.mjs

@@ -48,8 +48,8 @@ const packageMetadata = {
     productName: 'Kendo UI for Angular',
     productCode: 'KENDOUIANGULAR',
     productCodes: ['KENDOUIANGULAR'],
-    publishDate: 1774956619,
-    version: '23.3.0-develop.22',
+    publishDate: 1775110795,
+    version: '23.3.0-develop.23',
     licensingDocsUrl: 'https://www.telerik.com/kendo-angular-ui/my-license/?utm_medium=product&utm_source=kendoangular&utm_campaign=kendo-ui-angular-purchase-license-keys-warning',
 };
 
@@ -192,6 +192,43 @@ class SpreadsheetPDFExportEvent extends PreventableEvent {
         this.sender = sender;
     }
 }
+/**
+ * Provides the event data for the Spreadsheet `contextMenu` event.
+ */
+class SpreadsheetContextMenuEvent extends PreventableEvent {
+    /**
+     * The context menu items for the current selection.
+     */
+    items;
+    /**
+     * The Spreadsheet component instance.
+     */
+    spreadsheet;
+    /**
+     * The Spreadsheet Range object representing the currently selected cells.
+     * Provides methods to apply values, formatting, and styling to the Spreadsheet cells using the original event's data.
+     */
+    range;
+    /**
+     * Represents the Rectangle object that provides position and dimension information about the active range, useful for custom positioning logic.
+     */
+    rect;
+    /**
+     * The current Spreadsheet View instance, giving access to the broader Spreadsheet context.
+     */
+    view;
+    /**
+     * The type of target that opens the context menu.
+     */
+    targetType;
+    /**
+    * @hidden
+    */
+    constructor(options) {
+        super();
+        Object.assign(this, options);
+    }
+}
 
 /**
  * @hidden
@@ -5657,6 +5694,19 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.20", ngImpo
                 }]
         }], ctorParameters: () => [{ type: i1$3.ToolBarDropDownButtonComponent }, { type: SpreadsheetLocalizationService }, { type: SpreadsheetService }] });
 
+/**
+ * @hidden
+ */
+const COMMON_ITEMS = ['copy', 'cut', 'paste', 'separator', 'mergeAll', 'mergeHorizontally', 'mergeVertically', 'unmerge', 'separator', 'insertLink'];
+/**
+ * @hidden
+ */
+const ROWHEADER_ITEMS = ['separator', 'addRowAbove', 'addRowBelow', 'deleteRow', 'hideRow', 'unhideRow'];
+/**
+ * @hidden
+ */
+const COLUMNHEADER_ITEMS = ['separator', 'addColumnLeft', 'addColumnRight', 'deleteColumn', 'hideColumn', 'unhideColumn'];
+
 /**
  * Represents the [Kendo UI Spreadsheet component for Angular](https://www.telerik.com/kendo-angular-ui/components/spreadsheet).
  *
@@ -5684,7 +5734,7 @@ class SpreadsheetComponent {
     formulaCellInputRef;
     nameBoxRef;
     dialogContainer;
-    contextMenu;
+    contextMenuComponent;
     filterMenuTemplate;
     hostClass = true;
     role = 'application';
@@ -5869,6 +5919,10 @@ class SpreadsheetComponent {
      * Fires when a clipboard action (cut, copy, or paste) occurs in the Spreadsheet.
      */
     clipboard = new EventEmitter();
+    /**
+     * Fires when the user right-clicks within the Spreadsheet view and before the context menu is opened.
+     */
+    contextMenu = new EventEmitter();
     formulaFxIcon = formulaFxIcon;
     folderOpenIcon = folderOpenIcon;
     downloadIcon = downloadIcon;
@@ -6041,17 +6095,41 @@ class SpreadsheetComponent {
         }
         const selection = this.spreadsheetWidget.activeSheet().select();
         const { topLeft, bottomRight } = selection;
-        const isRange = e.targetType === 'cell' && (topLeft.row !== bottomRight.row || topLeft.col !== bottomRight.col);
-        const targetType = isRange ? 'range' : e.targetType;
-        const isSingleCell = topLeft.row === bottomRight.row && topLeft.col === bottomRight.col;
-        const isVerticalOnly = topLeft.col === bottomRight.col && topLeft.row !== bottomRight.row;
-        const isHorizontalOnly = topLeft.row === bottomRight.row && topLeft.col !== bottomRight.col;
+        const isRange = e.targetType === 'cell' && (topLeft?.row !== bottomRight?.row || topLeft?.col !== bottomRight?.col);
+        let targetType = isRange ? 'range' : e.targetType;
+        if (targetType === 'columnheader') {
+            targetType = 'columnHeader';
+        }
+        else if (targetType === 'rowheader') {
+            targetType = 'rowHeader';
+        }
+        const isSingleCell = topLeft?.row === bottomRight?.row && topLeft?.col === bottomRight?.col;
+        const isVerticalOnly = topLeft?.col === bottomRight?.col && topLeft?.row !== bottomRight?.row;
+        const isHorizontalOnly = topLeft?.row === bottomRight?.row && topLeft?.col !== bottomRight?.col;
         this.contextMenuItems = this.contextMenuItemsForTarget(targetType, e.showUnhide, e.showUnmerge, {
             isSingleCell,
             isVerticalOnly,
             isHorizontalOnly
         });
-        this.contextMenu.show({ top: e.originalEvent.pageY, left: e.originalEvent.pageX });
+        const eventArgs = {
+            targetType,
+            view: this.spreadsheetWidget.view,
+            spreadsheet: this,
+            range: selection,
+            rect: this.spreadsheetWidget.view.activeCellRectangle(),
+            items: this.contextMenuItems
+        };
+        const event = new SpreadsheetContextMenuEvent(eventArgs);
+        this.contextMenu.emit(event);
+        if (!event.isDefaultPrevented()) {
+            this.contextMenuItems = event.items.map(item => {
+                if (item.type === 'custom') {
+                    return item;
+                }
+                return this.getDefaultItemPerAction(item.type, { disableAllMerge: isSingleCell, isVerticalOnly, isHorizontalOnly, unmerge: e.showUnmerge, unhide: e.showUnhide });
+            });
+            this.contextMenuComponent.show({ top: e.originalEvent.pageY, left: e.originalEvent.pageX });
+        }
     }
     /**
      * @hidden
@@ -6070,7 +6148,8 @@ class SpreadsheetComponent {
      */
     onContextMenuSelect(e) {
         let command;
-        switch (e.item.id) {
+        let customAction;
+        switch (e.item.type) {
             case 'cut':
                 command = { command: 'ToolbarCutCommand', options: { workbook: this.spreadsheetWidget.workbook } };
                 break;
@@ -6122,10 +6201,23 @@ class SpreadsheetComponent {
             case 'addColumnRight':
                 command = { command: 'AddColumnCommand', options: { value: 'right' } };
                 break;
+            case 'custom':
+                customAction = e.item.action;
         }
         if (command) {
             this.spreadsheetWidget.executeCommand(command);
         }
+        else if (customAction) {
+            const activeSheet = this.spreadsheetWidget.activeSheet();
+            const actionContext = {
+                item: e.item,
+                spreadsheet: this,
+                range: activeSheet.range(activeSheet.activeCell()),
+                rect: this.spreadsheetWidget.view.activeCellRectangle(),
+                view: this.spreadsheetWidget.view
+            };
+            customAction(actionContext);
+        }
     }
     /**
      * @hidden
@@ -6393,120 +6485,48 @@ class SpreadsheetComponent {
     contextMenuItemsForTarget(target, unhide, unmerge, selectionInfo = { isSingleCell: false, isVerticalOnly: false, isHorizontalOnly: false }) {
         const { isSingleCell, isVerticalOnly, isHorizontalOnly } = selectionInfo;
         const disableAllMerge = isSingleCell;
-        const commonItems = [{
-                text: this.messageFor('copy'),
-                icon: commandIcons.copy,
-                svgIcon: commandSVGIcons.copy,
-                id: 'copy'
-            }, {
-                text: this.messageFor('cut'),
-                icon: commandIcons.cut,
-                svgIcon: commandSVGIcons.cut,
-                id: 'cut'
-            }, {
-                text: this.messageFor('paste'),
-                icon: commandIcons.paste,
-                svgIcon: commandSVGIcons.paste,
-                id: 'paste',
-                disabled: true
-            }, {
-                separator: true
-            }, {
-                text: this.messageFor('mergeAll'),
-                icon: commandIcons.mergeAll,
-                svgIcon: commandSVGIcons.mergeAll,
-                id: 'mergeAll',
-                disabled: disableAllMerge
-            }, {
-                text: this.messageFor('mergeHorizontally'),
-                icon: commandIcons.mergeHorizontally,
-                svgIcon: commandSVGIcons.mergeHorizontally,
-                id: 'mergeHorizontally',
-                disabled: disableAllMerge || isVerticalOnly
-            }, {
-                text: this.messageFor('mergeVertically'),
-                icon: commandIcons.mergeVertically,
-                svgIcon: commandSVGIcons.mergeVertically,
-                id: 'mergeVertically',
-                disabled: disableAllMerge || isHorizontalOnly
-            }, {
-                text: this.messageFor('unmerge'),
-                icon: commandIcons.unmerge,
-                svgIcon: commandSVGIcons.unmerge,
-                id: 'unmerge',
-                disabled: !unmerge
-            }, {
-                separator: true
-            }, {
-                text: this.messageFor('insertLink'),
-                icon: commandIcons.insertLink,
-                svgIcon: commandSVGIcons.insertLink,
-                id: 'insertLink'
-            }];
-        if (target === 'rowheader') {
-            commonItems.push({
-                separator: true
-            }, {
-                text: this.messageFor('addRowAbove'),
-                icon: commandIcons.addRowAbove,
-                svgIcon: commandSVGIcons.addRowAbove,
-                id: 'addRowAbove',
-            }, {
-                text: this.messageFor('addRowBelow'),
-                icon: commandIcons.addRowBelow,
-                svgIcon: commandSVGIcons.addRowBelow,
-                id: 'addRowBelow',
-            }, {
-                text: this.messageFor('deleteRow'),
-                icon: commandIcons.deleteRow,
-                svgIcon: commandSVGIcons.deleteRow,
-                id: 'deleteRow',
-            }, {
-                text: this.messageFor('hideRow'),
-                icon: commandIcons.hideRow,
-                svgIcon: commandSVGIcons.hideRow,
-                id: 'hideRow',
-            }, {
-                text: this.messageFor('unhideRow'),
-                icon: commandIcons.unhideRow,
-                svgIcon: commandSVGIcons.unhideRow,
-                id: 'unhideRow',
-                disabled: !unhide
-            });
+        const commonItems = COMMON_ITEMS.map(actionType => this.getDefaultItemPerAction(actionType, { disableAllMerge, isVerticalOnly, isHorizontalOnly, unmerge, unhide }));
+        if (target === 'rowHeader') {
+            const rowHeaderItems = ROWHEADER_ITEMS.map(actionType => this.getDefaultItemPerAction(actionType, { disableAllMerge, isVerticalOnly, isHorizontalOnly, unmerge, unhide }));
+            commonItems.push(...rowHeaderItems);
         }
-        if (target === 'columnheader') {
-            commonItems.push({
-                separator: true
-            }, {
-                text: this.messageFor('addColumnLeft'),
-                icon: commandIcons.addColumnLeft,
-                svgIcon: commandSVGIcons.addColumnLeft,
-                id: 'addColumnLeft',
-            }, {
-                text: this.messageFor('addColumnRight'),
-                icon: commandIcons.addColumnRight,
-                svgIcon: commandSVGIcons.addColumnRight,
-                id: 'addColumnRight',
-            }, {
-                text: this.messageFor('deleteColumn'),
-                icon: commandIcons.deleteColumn,
-                svgIcon: commandSVGIcons.deleteColumn,
-                id: 'deleteColumn',
-            }, {
-                text: this.messageFor('hideColumn'),
-                icon: commandIcons.hideColumn,
-                svgIcon: commandSVGIcons.hideColumn,
-                id: 'hideColumn',
-            }, {
-                text: this.messageFor('unhideColumn'),
-                icon: commandIcons.unhideColumn,
-                svgIcon: commandSVGIcons.unhideColumn,
-                id: 'unhideColumn',
-                disabled: !unhide
-            });
+        if (target === 'columnHeader') {
+            const columnHeaderItems = COLUMNHEADER_ITEMS.map(actionType => this.getDefaultItemPerAction(actionType, { disableAllMerge, isVerticalOnly, isHorizontalOnly, unmerge, unhide }));
+            commonItems.push(...columnHeaderItems);
         }
         return commonItems;
     }
+    getDefaultItemPerAction(actionType, selectionInfo) {
+        return {
+            type: actionType,
+            text: this.messageFor(actionType),
+            icon: commandIcons[actionType],
+            svgIcon: commandSVGIcons[actionType],
+            disabled: this.getActionDisabledState(actionType, selectionInfo),
+            separator: actionType === 'separator',
+            action: undefined
+        };
+    }
+    getActionDisabledState(actionType, selectionInfo) {
+        const { disableAllMerge, isVerticalOnly, isHorizontalOnly, unmerge, unhide } = selectionInfo;
+        switch (actionType) {
+            case 'paste':
+                return true;
+            case 'mergeAll':
+                return disableAllMerge;
+            case 'mergeHorizontally':
+                return disableAllMerge || isVerticalOnly;
+            case 'mergeVertically':
+                return disableAllMerge || isHorizontalOnly;
+            case 'unmerge':
+                return !unmerge;
+            case 'unhideRow':
+            case 'unhideColumn':
+                return !unhide;
+            default:
+                return false;
+        }
+    }
     openLinkDialog() {
         const hasLink = isPresent(this.currentRange?.link());
         const dialogSettings = {
@@ -6912,7 +6932,7 @@ class SpreadsheetComponent {
         return false;
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.20", ngImport: i0, type: SpreadsheetComponent, deps: [{ token: i0.NgZone }, { token: i1$4.IntlService }, { token: i0.ElementRef }, { token: i1.LocalizationService }, { token: SpreadsheetService }, { token: SpreadsheetToolsService }, { token: ErrorHandlingService }, { token: i1$2.DialogService }, { token: i1$1.PopupService }, { token: i0.ViewContainerRef }, { token: i0.ChangeDetectorRef }], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "19.2.20", type: SpreadsheetComponent, isStandalone: true, selector: "kendo-spreadsheet", inputs: { menuItems: "menuItems", overflow: "overflow", formulaListMaxHeight: "formulaListMaxHeight", activeSheet: "activeSheet", sheets: "sheets", columns: "columns", columnWidth: "columnWidth", defaultCellStyle: "defaultCellStyle", headerHeight: "headerHeight", headerWidth: "headerWidth", rowHeight: "rowHeight", rows: "rows", cellEditors: "cellEditors", images: "images", pdfExportSettings: "pdfExportSettings", excelExportSettings: "excelExportSettings", excel: "excel" }, outputs: { change: "change", formatChange: "formatChange", selectionChange: "selectionChange", excelExport: "excelExport", excelImport: "excelImport", pdfExport: "pdfExport", activeSheetChange: "activeSheetChange", clipboard: "clipboard" }, host: { properties: { "class.k-spreadsheet": "this.hostClass", "attr.role": "this.role" } }, providers: [
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "19.2.20", type: SpreadsheetComponent, isStandalone: true, selector: "kendo-spreadsheet", inputs: { menuItems: "menuItems", overflow: "overflow", formulaListMaxHeight: "formulaListMaxHeight", activeSheet: "activeSheet", sheets: "sheets", columns: "columns", columnWidth: "columnWidth", defaultCellStyle: "defaultCellStyle", headerHeight: "headerHeight", headerWidth: "headerWidth", rowHeight: "rowHeight", rows: "rows", cellEditors: "cellEditors", images: "images", pdfExportSettings: "pdfExportSettings", excelExportSettings: "excelExportSettings", excel: "excel" }, outputs: { change: "change", formatChange: "formatChange", selectionChange: "selectionChange", excelExport: "excelExport", excelImport: "excelImport", pdfExport: "pdfExport", activeSheetChange: "activeSheetChange", clipboard: "clipboard", contextMenu: "contextMenu" }, host: { properties: { "class.k-spreadsheet": "this.hostClass", "attr.role": "this.role" } }, providers: [
             SpreadsheetLocalizationService,
             SpreadsheetService,
             {
@@ -6926,7 +6946,7 @@ class SpreadsheetComponent {
             SpreadsheetToolsService,
             PopupService,
             ErrorHandlingService
-        ], viewQueries: [{ propertyName: "formulaBarInputRef", first: true, predicate: ["formulaBar"], descendants: true, read: FormulaInputDirective }, { propertyName: "formulaCellInputRef", first: true, predicate: ["formulaCell"], descendants: true, read: FormulaInputDirective }, { propertyName: "nameBoxRef", first: true, predicate: ["nameBox"], descendants: true }, { propertyName: "dialogContainer", first: true, predicate: ["dialogContainer"], descendants: true, read: ViewContainerRef }, { propertyName: "contextMenu", first: true, predicate: ["contextMenu"], descendants: true }, { propertyName: "filterMenuTemplate", first: true, predicate: ["filterMenuTemplate"], descendants: true }], exportAs: ["kendo-spreadsheet"], usesOnChanges: true, ngImport: i0, template: `
+        ], viewQueries: [{ propertyName: "formulaBarInputRef", first: true, predicate: ["formulaBar"], descendants: true, read: FormulaInputDirective }, { propertyName: "formulaCellInputRef", first: true, predicate: ["formulaCell"], descendants: true, read: FormulaInputDirective }, { propertyName: "nameBoxRef", first: true, predicate: ["nameBox"], descendants: true }, { propertyName: "dialogContainer", first: true, predicate: ["dialogContainer"], descendants: true, read: ViewContainerRef }, { propertyName: "contextMenuComponent", first: true, predicate: ["contextMenu"], descendants: true }, { propertyName: "filterMenuTemplate", first: true, predicate: ["filterMenuTemplate"], descendants: true }], exportAs: ["kendo-spreadsheet"], usesOnChanges: true, ngImport: i0, template: `
         <ng-container
           kendoSpreadsheetLocalizedMessages
           i18n-background="kendo.spreadsheet.background|The title of the tool that changes the text background color."
@@ -7992,7 +8012,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.20", ngImpo
             }], dialogContainer: [{
                 type: ViewChild,
                 args: ['dialogContainer', { read: ViewContainerRef }]
-            }], contextMenu: [{
+            }], contextMenuComponent: [{
                 type: ViewChild,
                 args: ['contextMenu']
             }], filterMenuTemplate: [{
@@ -8054,6 +8074,8 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.20", ngImpo
                 type: Output
             }], clipboard: [{
                 type: Output
+            }], contextMenu: [{
+                type: Output
             }] } });
 
 /**
@@ -8235,5 +8257,5 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.20", ngImpo
  * Generated bundle index. Do not edit.
  */
 
-export { CustomMessagesComponent, FormulaInputDirective, FormulaListComponent, KENDO_SPREADSHEET, NameBoxComponent, SheetsBarComponent, SpreadsheetAddColumnLeftButtonDirective, SpreadsheetAddColumnRightButtonDirective, SpreadsheetAddRowAboveButtonDirective, SpreadsheetAddRowBelowButtonDirective, SpreadsheetBackColorComponent, SpreadsheetBoldDirective, SpreadsheetComponent, SpreadsheetDataValidationDirective, SpreadsheetDecreaseDecimalDirective, SpreadsheetDecreaseFontSizeDirective, SpreadsheetDeleteColumnButtonDirective, SpreadsheetDeleteRowButtonDirective, SpreadsheetFilterDirective, SpreadsheetFontFamilyComponent, SpreadsheetFontSizeComponent, SpreadsheetForeColorComponent, SpreadsheetFormatDirective, SpreadsheetGridLinesDirective, SpreadsheetHorizontalTextAlignDirective, SpreadsheetIncreaseDecimalDirective, SpreadsheetIncreaseFontSizeDirective, SpreadsheetInsertLinkDirective, SpreadsheetItalicDirective, SpreadsheetLoadFileComponent, SpreadsheetMergeDirective, SpreadsheetModule, SpreadsheetPDFExportDirective, SpreadsheetPDFExportEvent, SpreadsheetRedoDirective, SpreadsheetSaveFileDirective, SpreadsheetSortDirective, SpreadsheetTextAlignDirective, SpreadsheetTextWrapDirective, SpreadsheetUnderlineDirective, SpreadsheetUndoDirective, SpreadsheetVerticalTextAlignDirective };
+export { CustomMessagesComponent, FormulaInputDirective, FormulaListComponent, KENDO_SPREADSHEET, NameBoxComponent, SheetsBarComponent, SpreadsheetAddColumnLeftButtonDirective, SpreadsheetAddColumnRightButtonDirective, SpreadsheetAddRowAboveButtonDirective, SpreadsheetAddRowBelowButtonDirective, SpreadsheetBackColorComponent, SpreadsheetBoldDirective, SpreadsheetComponent, SpreadsheetContextMenuEvent, SpreadsheetDataValidationDirective, SpreadsheetDecreaseDecimalDirective, SpreadsheetDecreaseFontSizeDirective, SpreadsheetDeleteColumnButtonDirective, SpreadsheetDeleteRowButtonDirective, SpreadsheetFilterDirective, SpreadsheetFontFamilyComponent, SpreadsheetFontSizeComponent, SpreadsheetForeColorComponent, SpreadsheetFormatDirective, SpreadsheetGridLinesDirective, SpreadsheetHorizontalTextAlignDirective, SpreadsheetIncreaseDecimalDirective, SpreadsheetIncreaseFontSizeDirective, SpreadsheetInsertLinkDirective, SpreadsheetItalicDirective, SpreadsheetLoadFileComponent, SpreadsheetMergeDirective, SpreadsheetModule, SpreadsheetPDFExportDirective, SpreadsheetPDFExportEvent, SpreadsheetRedoDirective, SpreadsheetSaveFileDirective, SpreadsheetSortDirective, SpreadsheetTextAlignDirective, SpreadsheetTextWrapDirective, SpreadsheetUnderlineDirective, SpreadsheetUndoDirective, SpreadsheetVerticalTextAlignDirective };
 

package/index.d.ts

@@ -8,7 +8,7 @@ export { FormulaListComponent } from './action-bar/list.component';
 export { FormulaInputDirective } from './action-bar/formula-input.directive';
 export { NameBoxComponent } from './action-bar/namebox.component';
 export { SheetsBarComponent } from './sheets-bar/sheets-bar.component';
-export { SheetInfo, SpreadsheetMainMenuItem as ToolbarTab, SpreadsheetChangeEvent, SpreadsheetActiveSheetChangeEvent, SpreadsheetExcelExportEvent, SpreadsheetExcelImportEvent, SpreadsheetClipboardEvent, SpreadsheetMainMenuItem, SpreadsheetCellEditorOptions, SpreadsheetCellEditorHandlerArgs, Rectangle, SpreadsheetClipboardContent, SpreadsheetClipboardEventType, SpreadsheetPaperSize, PDFExportSettings, SpreadsheetPDFExportEvent, PDFMargin } from './models';
+export { SheetInfo, SpreadsheetMainMenuItem as ToolbarTab, SpreadsheetChangeEvent, SpreadsheetActiveSheetChangeEvent, SpreadsheetExcelExportEvent, SpreadsheetExcelImportEvent, SpreadsheetClipboardEvent, SpreadsheetMainMenuItem, SpreadsheetCellEditorOptions, SpreadsheetCellEditorHandlerArgs, Rectangle, SpreadsheetClipboardContent, SpreadsheetClipboardEventType, SpreadsheetPaperSize, PDFExportSettings, SpreadsheetPDFExportEvent, PDFMargin, SpreadsheetContextMenuAction, SpreadsheetContextMenuEvent, SpreadsheetContextMenuItem, SpreadsheetContextMenuTarget, ContextMenuActionFn, ContextMenuArgs } from './models';
 export * from './tools';
 export * from './directives';
 export { CustomMessagesComponent } from './localization/custom-messages.component';

package/models/events.d.ts

@@ -2,8 +2,11 @@
 * Copyright © 2026 Progress Software Corporation. All rights reserved.
 * Licensed under commercial license. See LICENSE.md in the project root for more information
 *-------------------------------------------------------------------------------------------*/
-import { Range, Sheet, SpreadsheetWidget, Workbook } from "@progress/kendo-spreadsheet-common";
+import { Range, Sheet, SpreadsheetWidget, Workbook, View } from "@progress/kendo-spreadsheet-common";
 import { PreventableEvent } from "@progress/kendo-angular-common";
+import { SpreadsheetComponent } from "../spreadsheet.component";
+import { Rectangle } from "./cell-editor-action-args";
+import { SVGIcon } from "@progress/kendo-svg-icons";
 /**
  * Provides the event data for the Spreadsheet `change` event.
  */
@@ -122,6 +125,111 @@ export interface SpreadsheetClipboardContent {
      */
     mergedCells: string[];
 }
+/**
+ * Provides the event data for the Spreadsheet `contextMenu` event.
+ */
+export declare class SpreadsheetContextMenuEvent extends PreventableEvent {
+    /**
+     * The context menu items for the current selection.
+     */
+    items: Array<SpreadsheetContextMenuItem>;
+    /**
+     * The Spreadsheet component instance.
+     */
+    spreadsheet: SpreadsheetComponent;
+    /**
+     * The Spreadsheet Range object representing the currently selected cells.
+     * Provides methods to apply values, formatting, and styling to the Spreadsheet cells using the original event's data.
+     */
+    range: Range;
+    /**
+     * Represents the Rectangle object that provides position and dimension information about the active range, useful for custom positioning logic.
+     */
+    rect: Rectangle;
+    /**
+     * The current Spreadsheet View instance, giving access to the broader Spreadsheet context.
+     */
+    view: View;
+    /**
+     * The type of target that opens the context menu.
+     */
+    targetType: SpreadsheetContextMenuTarget;
+    /**
+    * @hidden
+    */
+    constructor(options: any);
+}
+export interface SpreadsheetContextMenuItem {
+    /**
+     * The context menu item type.
+     */
+    type: SpreadsheetContextMenuAction;
+    /**
+     * Sets the unique identifier for the context menu item.
+     */
+    id?: string | number;
+    /**
+     * Specifies the item text.
+     */
+    text?: string;
+    /**
+     * Specifies the name of the font icon that will be rendered for the item.
+     */
+    icon?: string;
+    /**
+     * Defines an SVGIcon that will be rendered for the item using a KendoSVGIcon component.
+     */
+    svgIcon?: SVGIcon;
+    /**
+     * Specifies if the item is disabled.
+     */
+    disabled?: boolean;
+    /**
+     * Specifies if this is a separator item. If set to true, other fields are disregarded.
+     */
+    separator?: boolean;
+    /**
+     * Sets a function that will be invoked when the item is selected.
+     */
+    action?: ContextMenuActionFn;
+}
+/**
+ * Provides the arguments for the callback function of a context menu item.
+ */
+export interface ContextMenuArgs {
+    /**
+     * The item that triggered the action.
+     */
+    item: SpreadsheetContextMenuItem;
+    /**
+     * The Spreadsheet component instance.
+     */
+    spreadsheet: SpreadsheetComponent;
+    /**
+     * The Spreadsheet Range object representing the currently selected cells. Provides methods to apply values, formatting, and styling to the Spreadsheet cells using the original event's data.
+     */
+    range: Range;
+    /**
+     * Represents the Rectangle object that provides position and dimension information about the active range, useful for custom positioning logic.
+     */
+    rect: Rectangle;
+    /**
+     * The current Spreadsheet View instance, giving access to the broader Spreadsheet context.
+     */
+    view: View;
+}
+/**
+ * Represents the callback that will be invoked when a context menu item is selected.
+ */
+export type ContextMenuActionFn = (context: ContextMenuArgs) => void;
+/**
+ * Defines the possible values for the `targetType` that triggered opening of the context menu.
+ */
+export type SpreadsheetContextMenuTarget = 'cell' | 'range' | 'rowHeader' | 'columnHeader';
+/**
+ * Defines the possible values for the `type` property of a context menu item.
+ */
+export type SpreadsheetContextMenuAction = 'copy' | 'paste' | 'cut' | 'mergeAll' | 'mergeHorizontally' | 'mergeVertically' | 'unmerge' | 'insertLink' | 'separator' | 'addRowAbove' | 'addRowBelow' | 'deleteRow' | 'hideRow' | 'unhideRow' | 'addColumnLeft' | 'addColumnRight' | 'deleteColumn' | 'hideColumn' | 'unhideColumn' | 'custom';
 /**
  * Defines the possible values for the `type` property of [`SpreadsheetClipboardEvent`](https://www.telerik.com/kendo-angular-ui/components/spreadsheet/api/spreadsheetclipboardevent).
  */

package/package-metadata.mjs

@@ -7,7 +7,7 @@ export const packageMetadata = {
   "productCodes": [
     "KENDOUIANGULAR"
   ],
-  "publishDate": 1774956619,
-  "version": "23.3.0-develop.22",
+  "publishDate": 1775110795,
+  "version": "23.3.0-develop.23",
   "licensingDocsUrl": "https://www.telerik.com/kendo-angular-ui/my-license/?utm_medium=product&utm_source=kendoangular&utm_campaign=kendo-ui-angular-purchase-license-keys-warning"
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@progress/kendo-angular-spreadsheet",
-  "version": "23.3.0-develop.22",
+  "version": "23.3.0-develop.23",
   "description": "A Spreadsheet Component for Angular",
   "license": "SEE LICENSE IN LICENSE.md",
   "author": "Progress",
@@ -19,7 +19,7 @@
     "package": {
       "productName": "Kendo UI for Angular",
       "productCode": "KENDOUIANGULAR",
-      "publishDate": 1774956619,
+      "publishDate": 1775110795,
       "licensingDocsUrl": "https://www.telerik.com/kendo-angular-ui/my-license/?utm_medium=product&utm_source=kendoangular&utm_campaign=kendo-ui-angular-purchase-license-keys-warning"
     }
   },
@@ -29,26 +29,26 @@
     "@angular/core": "19 - 21",
     "@angular/platform-browser": "19 - 21",
     "@progress/kendo-licensing": "^1.10.0",
-    "@progress/kendo-angular-buttons": "23.3.0-develop.22",
-    "@progress/kendo-angular-common": "23.3.0-develop.22",
-    "@progress/kendo-angular-dialog": "23.3.0-develop.22",
-    "@progress/kendo-angular-dropdowns": "23.3.0-develop.22",
-    "@progress/kendo-angular-icons": "23.3.0-develop.22",
-    "@progress/kendo-angular-inputs": "23.3.0-develop.22",
-    "@progress/kendo-angular-treeview": "23.3.0-develop.22",
-    "@progress/kendo-angular-dateinputs": "23.3.0-develop.22",
-    "@progress/kendo-angular-intl": "23.3.0-develop.22",
-    "@progress/kendo-angular-l10n": "23.3.0-develop.22",
-    "@progress/kendo-angular-label": "23.3.0-develop.22",
-    "@progress/kendo-angular-layout": "23.3.0-develop.22",
-    "@progress/kendo-angular-menu": "23.3.0-develop.22",
-    "@progress/kendo-angular-popup": "23.3.0-develop.22",
-    "@progress/kendo-angular-toolbar": "23.3.0-develop.22",
+    "@progress/kendo-angular-buttons": "23.3.0-develop.23",
+    "@progress/kendo-angular-common": "23.3.0-develop.23",
+    "@progress/kendo-angular-dialog": "23.3.0-develop.23",
+    "@progress/kendo-angular-dropdowns": "23.3.0-develop.23",
+    "@progress/kendo-angular-icons": "23.3.0-develop.23",
+    "@progress/kendo-angular-inputs": "23.3.0-develop.23",
+    "@progress/kendo-angular-treeview": "23.3.0-develop.23",
+    "@progress/kendo-angular-dateinputs": "23.3.0-develop.23",
+    "@progress/kendo-angular-intl": "23.3.0-develop.23",
+    "@progress/kendo-angular-l10n": "23.3.0-develop.23",
+    "@progress/kendo-angular-label": "23.3.0-develop.23",
+    "@progress/kendo-angular-layout": "23.3.0-develop.23",
+    "@progress/kendo-angular-menu": "23.3.0-develop.23",
+    "@progress/kendo-angular-popup": "23.3.0-develop.23",
+    "@progress/kendo-angular-toolbar": "23.3.0-develop.23",
     "rxjs": "^6.5.3 || ^7.0.0"
   },
   "dependencies": {
     "tslib": "^2.3.1",
-    "@progress/kendo-angular-schematics": "23.3.0-develop.22",
+    "@progress/kendo-angular-schematics": "23.3.0-develop.23",
     "@progress/jszip-esm": "^1.0.3",
     "@progress/kendo-common": "^1.0.1",
     "@progress/kendo-date-math": "^1.5.10",

package/schematics/ngAdd/index.js

@@ -11,8 +11,8 @@ function default_1(options) {
             // Peer dependency of icons
             '@progress/kendo-svg-icons': '^4.0.0',
             // peer deps of the dropdowns
-            '@progress/kendo-angular-navigation': '23.3.0-develop.22',
-            '@progress/kendo-angular-treeview': '23.3.0-develop.22'
+            '@progress/kendo-angular-navigation': '23.3.0-develop.23',
+            '@progress/kendo-angular-treeview': '23.3.0-develop.23'
         } });
     return (0, schematics_1.externalSchematic)('@progress/kendo-angular-schematics', 'ng-add', finalOptions);
 }

package/spreadsheet.component.d.ts

@@ -9,11 +9,11 @@ import { IntlService } from '@progress/kendo-angular-intl';
 import { SVGIcon } from '@progress/kendo-svg-icons';
 import { LocalizationService } from '@progress/kendo-angular-l10n';
 import { PopupService } from '@progress/kendo-angular-popup';
-import { ContextMenuSelectEvent, MenuItem } from '@progress/kendo-angular-menu';
+import { ContextMenuSelectEvent } from '@progress/kendo-angular-menu';
 import { DialogService } from '@progress/kendo-angular-dialog';
 import { SpreadsheetService } from './common/spreadsheet.service';
 import { SpreadsheetToolsService } from './tools/tools.service';
-import { FilterMenuItem, SheetInfo, SpreadsheetActiveSheetChangeEvent, SpreadsheetCellEditorOptions, SpreadsheetChangeEvent, SpreadsheetExcelExportEvent, SpreadsheetExcelImportEvent, SpreadsheetPDFExportEvent, SpreadsheetMainMenuItem, SpreadsheetClipboardEvent, PDFExportSettings } from './models';
+import { FilterMenuItem, SheetInfo, SpreadsheetActiveSheetChangeEvent, SpreadsheetCellEditorOptions, SpreadsheetChangeEvent, SpreadsheetExcelExportEvent, SpreadsheetExcelImportEvent, SpreadsheetPDFExportEvent, SpreadsheetMainMenuItem, SpreadsheetClipboardEvent, PDFExportSettings, SpreadsheetContextMenuEvent, SpreadsheetContextMenuItem } from './models';
 import { ErrorHandlingService } from './common/error-handling.service';
 import { CheckedState } from '@progress/kendo-angular-treeview';
 import * as i0 from "@angular/core";
@@ -44,7 +44,7 @@ export declare class SpreadsheetComponent implements AfterViewInit, OnChanges, O
     private formulaCellInputRef;
     private nameBoxRef;
     dialogContainer: ViewContainerRef;
-    private contextMenu;
+    private contextMenuComponent;
     filterMenuTemplate: TemplateRef<any>;
     hostClass: boolean;
     role: string;
@@ -193,6 +193,10 @@ export declare class SpreadsheetComponent implements AfterViewInit, OnChanges, O
      * Fires when a clipboard action (cut, copy, or paste) occurs in the Spreadsheet.
      */
     clipboard: EventEmitter<SpreadsheetClipboardEvent>;
+    /**
+     * Fires when the user right-clicks within the Spreadsheet view and before the context menu is opened.
+     */
+    contextMenu: EventEmitter<SpreadsheetContextMenuEvent>;
     formulaFxIcon: SVGIcon;
     folderOpenIcon: SVGIcon;
     downloadIcon: SVGIcon;
@@ -210,7 +214,7 @@ export declare class SpreadsheetComponent implements AfterViewInit, OnChanges, O
      * @hidden
      */
     licenseMessage?: LicenseMessage;
-    contextMenuItems: MenuItem[];
+    contextMenuItems: SpreadsheetContextMenuItem[];
     sortMenuItems: FilterMenuItem[];
     conditionExpanded: boolean;
     valueExpanded: boolean;
@@ -300,6 +304,8 @@ export declare class SpreadsheetComponent implements AfterViewInit, OnChanges, O
     private onClipboardEvent;
     private get options();
     private contextMenuItemsForTarget;
+    private getDefaultItemPerAction;
+    private getActionDisabledState;
     private openLinkDialog;
     private configureSheets;
     private registerEditors;
@@ -316,5 +322,5 @@ export declare class SpreadsheetComponent implements AfterViewInit, OnChanges, O
     private findItemByText;
     private isIndeterminate;
     static ɵfac: i0.ɵɵFactoryDeclaration<SpreadsheetComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<SpreadsheetComponent, "kendo-spreadsheet", ["kendo-spreadsheet"], { "menuItems": { "alias": "menuItems"; "required": false; }; "overflow": { "alias": "overflow"; "required": false; }; "formulaListMaxHeight": { "alias": "formulaListMaxHeight"; "required": false; }; "activeSheet": { "alias": "activeSheet"; "required": false; }; "sheets": { "alias": "sheets"; "required": false; }; "columns": { "alias": "columns"; "required": false; }; "columnWidth": { "alias": "columnWidth"; "required": false; }; "defaultCellStyle": { "alias": "defaultCellStyle"; "required": false; }; "headerHeight": { "alias": "headerHeight"; "required": false; }; "headerWidth": { "alias": "headerWidth"; "required": false; }; "rowHeight": { "alias": "rowHeight"; "required": false; }; "rows": { "alias": "rows"; "required": false; }; "cellEditors": { "alias": "cellEditors"; "required": false; }; "images": { "alias": "images"; "required": false; }; "pdfExportSettings": { "alias": "pdfExportSettings"; "required": false; }; "excelExportSettings": { "alias": "excelExportSettings"; "required": false; }; "excel": { "alias": "excel"; "required": false; }; }, { "change": "change"; "formatChange": "formatChange"; "selectionChange": "selectionChange"; "excelExport": "excelExport"; "excelImport": "excelImport"; "pdfExport": "pdfExport"; "activeSheetChange": "activeSheetChange"; "clipboard": "clipboard"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SpreadsheetComponent, "kendo-spreadsheet", ["kendo-spreadsheet"], { "menuItems": { "alias": "menuItems"; "required": false; }; "overflow": { "alias": "overflow"; "required": false; }; "formulaListMaxHeight": { "alias": "formulaListMaxHeight"; "required": false; }; "activeSheet": { "alias": "activeSheet"; "required": false; }; "sheets": { "alias": "sheets"; "required": false; }; "columns": { "alias": "columns"; "required": false; }; "columnWidth": { "alias": "columnWidth"; "required": false; }; "defaultCellStyle": { "alias": "defaultCellStyle"; "required": false; }; "headerHeight": { "alias": "headerHeight"; "required": false; }; "headerWidth": { "alias": "headerWidth"; "required": false; }; "rowHeight": { "alias": "rowHeight"; "required": false; }; "rows": { "alias": "rows"; "required": false; }; "cellEditors": { "alias": "cellEditors"; "required": false; }; "images": { "alias": "images"; "required": false; }; "pdfExportSettings": { "alias": "pdfExportSettings"; "required": false; }; "excelExportSettings": { "alias": "excelExportSettings"; "required": false; }; "excel": { "alias": "excel"; "required": false; }; }, { "change": "change"; "formatChange": "formatChange"; "selectionChange": "selectionChange"; "excelExport": "excelExport"; "excelImport": "excelImport"; "pdfExport": "pdfExport"; "activeSheetChange": "activeSheetChange"; "clipboard": "clipboard"; "contextMenu": "contextMenu"; }, never, never, true, never>;
 }