@progress/kendo-angular-spreadsheet 24.2.2 → 25.0.0-develop.1

package/models/cell-editor-options.d.ts

@@ -1,38 +0,0 @@
-/**-----------------------------------------------------------------------------------------
-* Copyright © 2026 Progress Software Corporation. All rights reserved.
-* Licensed under commercial license. See LICENSE.md in the project root for more information
-*-------------------------------------------------------------------------------------------*/
-import { SVGIcon } from "@progress/kendo-svg-icons";
-/**
- * Represents the configuration object for defining custom cell editors.
- * Use this interface to render specific cell editors when you focus a cell or a range.
- */
-export interface SpreadsheetCellEditorOptions {
-    /**
-     * Sets the unique name of the cell editor.
-     * Use this name when you specify the editor for a cell or a range.
-     *
-     * Please note that `_validation_list` and `_validation_date` are reserved names for built-in editors.
-     */
-    name: string;
-    /**
-     * Sets the component to use as a cell editor.
-     */
-    component?: any;
-    /**
-     * Provides the actions that the cell editor can use.
-     * The `name` property must match an event name of the editor component.
-     */
-    actions?: Array<{
-        name: string;
-        handler: Function;
-    }>;
-    /**
-     * Sets the name of an existing icon from a Kendo UI theme.
-     */
-    icon?: string;
-    /**
-     * Sets the [`SVGIcon`](https://www.telerik.com/kendo-angular-ui/components/icons/api/svgicon) to render.
-     */
-    svgIcon?: SVGIcon;
-}

package/models/events.d.ts

@@ -1,239 +0,0 @@
-/**-----------------------------------------------------------------------------------------
-* 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, 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.
- */
-export interface SpreadsheetChangeEvent {
-    /**
-     * Specifies the selected `Range` in the active sheet.
-     */
-    range: Range;
-    /**
-     * Specifies the `SpreadsheetWidget` instance used in the Spreadsheet component.
-     */
-    sender: SpreadsheetWidget;
-}
-/**
- * Provides the event data for the Spreadsheet `excelExport` event.
- */
-export interface SpreadsheetExcelExportEvent {
-    /**
-     * Specifies the `SpreadsheetWidget` instance.
-     */
-    sender: SpreadsheetWidget;
-    /**
-     * Specifies the Excel `Workbook` configuration object. Changes to the `Workbook` are reflected in the output Excel document.
-     */
-    workbook: Workbook;
-    /**
-     * Prevents the Spreadsheet from saving the generated file when invoked.
-     */
-    preventDefault: Function;
-}
-/**
- * Provides the event data for the Spreadsheet `pdfExport` event.
- */
-export declare class SpreadsheetPDFExportEvent extends PreventableEvent {
-    /**
-     * Specifies the `SpreadsheetWidget` instance.
-     */
-    sender: SpreadsheetWidget;
-    /**
-     * @hidden
-     */
-    constructor(sender: SpreadsheetWidget);
-}
-/**
- * Provides the event data for the Spreadsheet `excelImport` event.
- */
-export interface SpreadsheetExcelImportEvent {
-    /**
-     * Specifies the `SpreadsheetWidget` instance.
-     */
-    sender: SpreadsheetWidget;
-    /**
-     * Specifies the selected file.
-     */
-    file: File | Blob;
-    /**
-     * Prevents the Spreadsheet from loading the selected file when invoked.
-     */
-    preventDefault: Function;
-}
-/**
- * Provides the event data for the Spreadsheet `activeSheetChange` event.
- */
-export interface SpreadsheetActiveSheetChangeEvent {
-    /**
-     * Specifies the `SpreadsheetWidget` instance.
-     */
-    sender: SpreadsheetWidget;
-    /**
-     * Specifies the new active sheet.
-     */
-    sheet: Sheet;
-}
-/**
- * Provides the event data for the Spreadsheet `cut`, `copy` and `paste` events.
- */
-export interface SpreadsheetClipboardEvent {
-    /**
-     * The `SpreadsheetWidget` instance which fired the event.
-     */
-    sender: SpreadsheetWidget;
-    /**
-     * The selected `Range` in the active sheet that is about to be copied.
-     */
-    range: Range;
-    /**
-     * The type of the clipboard event.
-     */
-    type: SpreadsheetClipboardEventType;
-    /**
-     * The clipboard content that is being copied, cut, or pasted.
-     */
-    clipboardContent: SpreadsheetClipboardContent;
-    /**
-     * Prevents the default action for the event.
-     * The Spreadsheet suppresses the built-in behavior that follows the event.
-     */
-    preventDefault: Function;
-    /**
-     * Returns `true` if any subscriber prevented the default action.
-     *
-     * @returns `true` if the default action was prevented, otherwise, `false`.
-     */
-    isDefaultPrevented: Function;
-}
-/**
- * Provides information about the clipboard content that is being copied, cut, or pasted, as well as about the merged cells within the selection.
- */
-export interface SpreadsheetClipboardContent {
-    /**
-     * The data that is being copied, cut, or pasted.
-     */
-    data: any[];
-    /**
-     * A collection representing the merged cells contained within the selected range.
-     */
-    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);
-}
-/**
- * Defines a context menu item in the Spreadsheet.
- */
-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).
- */
-export type SpreadsheetClipboardEventType = 'copy' | 'cut' | 'paste';

package/models/filter-menu-item.d.ts

@@ -1,14 +0,0 @@
-/**-----------------------------------------------------------------------------------------
-* Copyright © 2026 Progress Software Corporation. All rights reserved.
-* Licensed under commercial license. See LICENSE.md in the project root for more information
-*-------------------------------------------------------------------------------------------*/
-import { SVGIcon } from "@progress/kendo-svg-icons";
-/**
- * @hidden
- */
-export interface FilterMenuItem {
-    text: string;
-    icon?: string;
-    svgIcon?: SVGIcon;
-    content?: any;
-}

package/models/index.d.ts

@@ -1,12 +0,0 @@
-/**-----------------------------------------------------------------------------------------
-* Copyright © 2026 Progress Software Corporation. All rights reserved.
-* Licensed under commercial license. See LICENSE.md in the project root for more information
-*-------------------------------------------------------------------------------------------*/
-export * from './sheet-info';
-export * from './main-menu-item';
-export * from './events';
-export * from './cell-editor-options';
-export * from './cell-editor-action-args';
-export * from './filter-menu-item';
-export * from './range-filter-value';
-export * from './pdf-export';

package/models/main-menu-item.d.ts

@@ -1,20 +0,0 @@
-/**-----------------------------------------------------------------------------------------
-* Copyright © 2026 Progress Software Corporation. All rights reserved.
-* Licensed under commercial license. See LICENSE.md in the project root for more information
-*-------------------------------------------------------------------------------------------*/
-/**
- * The configuration object for customizing the built-in menu items.
- * Lets you render a specific set of menu items in the desired order and choose the initially active one.
- */
-export interface SpreadsheetMainMenuItem {
-    /**
-     * Specifies the built-in menu item identifier.
-     */
-    id: 'file' | 'home' | 'insert' | 'format' | 'view' | 'data';
-    /**
-     * Determines if the menu item is initially active.
-     * If no item is set as active, the first one is active by default.
-     * If more than one item is set as active, the first of them is active.
-     */
-    active?: boolean;
-}

package/models/pdf-export.d.ts

@@ -1,62 +0,0 @@
-/**-----------------------------------------------------------------------------------------
-* Copyright © 2026 Progress Software Corporation. All rights reserved.
-* Licensed under commercial license. See LICENSE.md in the project root for more information
-*-------------------------------------------------------------------------------------------*/
-import { pdf } from '@progress/kendo-drawing';
-/**
- * Configures the PDF export settings of the Spreadsheet.
- */
-export interface PDFExportSettings {
-    /**
-     * Sets the paper size for the PDF document.
-     * The value can be a `SpreadsheetPaperSize` or an array of two numbers (width and height in points).
-     *
-     * @default 'A4'
-     */
-    paperSize?: SpreadsheetPaperSize | [number, number];
-    /**
-     * If `false`, sets the page orientation to `portrait`. The default page orientation is `landscape`.
-     *
-     * @default true
-     */
-    landscape?: boolean;
-    /**
-     * Specifies the margins of the page. The supported units are `"mm"`, `"cm"`,`"in"`, and `"pt"`.
-     * Numbers are treated as points (`"pt"`).
-     *
-     * @default '1cm'
-     */
-    margin?: string | number | PDFMargin;
-    /**
-     * Scales the content to fit page width.
-     *
-     * @default false
-     */
-    fitWidth?: boolean;
-    /**
-     * Sets a scale factor for the PDF output. Use this to make the PDF content smaller or larger.
-     *
-     * @default 1
-     */
-    scale?: number;
-    /**
-     * Sets the title metadata for the PDF document. If not set, the title is the same as the file name.
-     */
-    title?: string;
-    /**
-     * Sets the name of the exported PDF file.
-     *
-     * @default 'Workbook.pdf'
-     */
-    fileName?: string;
-}
-/**
- * The paper size.
- */
-export type SpreadsheetPaperSize = 'A0' | 'A1' | 'A2' | 'A3' | 'A4' | 'A5' | 'A6' | 'A7' | 'A8' | 'A9' | 'A10' | 'B0' | 'B1' | 'B2' | 'B3' | 'B4' | 'B5' | 'B6' | 'B7' | 'B8' | 'B9' | 'B10' | 'C0' | 'C1' | 'C2' | 'C3' | 'C4' | 'C5' | 'C6' | 'C7' | 'C8' | 'C9' | 'C10' | 'Executive' | 'Folio' | 'Legal' | 'Letter' | 'Tabloid';
-/**
- * Defines the page margins for the PDF export.
- * Accepts numbers or strings with units.
- */
-export interface PDFMargin extends pdf.PageMargin {
-}

package/models/range-filter-value.d.ts

@@ -1,15 +0,0 @@
-/**-----------------------------------------------------------------------------------------
-* Copyright © 2026 Progress Software Corporation. All rights reserved.
-* Licensed under commercial license. See LICENSE.md in the project root for more information
-*-------------------------------------------------------------------------------------------*/
-/**
- * @hidden
- */
-export interface RangeFilterValue {
-    dataType?: string;
-    value?: any;
-    unformattedValue?: any;
-    text?: string;
-    checked?: boolean;
-    items?: RangeFilterValue[];
-}

package/models/sheet-info.d.ts

@@ -1,26 +0,0 @@
-/**-----------------------------------------------------------------------------------------
-* Copyright © 2026 Progress Software Corporation. All rights reserved.
-* Licensed under commercial license. See LICENSE.md in the project root for more information
-*-------------------------------------------------------------------------------------------*/
-import { SheetDescriptor } from '@progress/kendo-spreadsheet-common';
-import { ListItemModel } from '@progress/kendo-angular-buttons';
-/**
- * @hidden
- */
-export type SheetAction = ListItemModel & {
-    commandName: string;
-    dialogButton?: string;
-    messageKey?: string;
-};
-/**
- * @hidden
- */
-export type SheetInfo = SheetDescriptor & {
-    last: boolean;
-    first: boolean;
-    text: string;
-    sheetActions: SheetAction[];
-    inEdit?: boolean;
-    active?: boolean;
-    index?: number;
-};

package/package-metadata.d.ts

@@ -1,9 +0,0 @@
-/**-----------------------------------------------------------------------------------------
-* Copyright © 2026 Progress Software Corporation. All rights reserved.
-* Licensed under commercial license. See LICENSE.md in the project root for more information
-*-------------------------------------------------------------------------------------------*/
-import { type PackageMetadata } from '@progress/kendo-licensing';
-/**
- * @hidden
- */
-export declare const packageMetadata: PackageMetadata;

package/sheets-bar/action-dialog.component.d.ts

@@ -1,19 +0,0 @@
-/**-----------------------------------------------------------------------------------------
-* Copyright © 2026 Progress Software Corporation. All rights reserved.
-* Licensed under commercial license. See LICENSE.md in the project root for more information
-*-------------------------------------------------------------------------------------------*/
-import { DialogRef, DialogContentBase } from '@progress/kendo-angular-dialog';
-import * as i0 from "@angular/core";
-/**
- * @hidden
- */
-export declare class ActionDialogComponent extends DialogContentBase {
-    dialog: DialogRef;
-    commandName: string;
-    value: any;
-    tabindex: number;
-    constructor(dialog: DialogRef);
-    setData(args: any): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<ActionDialogComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<ActionDialogComponent, "ng-component", never, {}, {}, never, never, true, never>;
-}

package/sheets-bar/sheets-bar.component.d.ts

@@ -1,67 +0,0 @@
-/**-----------------------------------------------------------------------------------------
-* Copyright © 2026 Progress Software Corporation. All rights reserved.
-* Licensed under commercial license. See LICENSE.md in the project root for more information
-*-------------------------------------------------------------------------------------------*/
-import { AfterViewInit, ElementRef, NgZone, OnDestroy, QueryList, Renderer2, SimpleChanges } from '@angular/core';
-import { SheetDescriptor } from '@progress/kendo-spreadsheet-common';
-import { ButtonComponent, DropDownButtonComponent } from '@progress/kendo-angular-buttons';
-import { DialogService } from '@progress/kendo-angular-dialog';
-import { SelectEvent, TabStripComponent } from '@progress/kendo-angular-layout';
-import { SVGIcon } from '@progress/kendo-svg-icons';
-import { SheetInfo } from '../models/sheet-info';
-import { SpreadsheetService } from '../common/spreadsheet.service';
-import { SheetAction } from '../models/sheet-info';
-import { SpreadsheetLocalizationService } from '../localization/spreadsheet-localization.service';
-import * as i0 from "@angular/core";
-/**
- * @hidden
- */
-export declare class SheetsBarComponent implements AfterViewInit, OnDestroy {
-    private spreadsheetService;
-    private element;
-    private renderer;
-    private localization;
-    private dialogService;
-    private ngZone;
-    hostClasses: boolean;
-    trackByItemKey: (index: number, item: SheetInfo) => any;
-    sheets: SheetInfo[];
-    sheetDescriptors: SheetDescriptor[];
-    private subs;
-    private hiding;
-    constructor(spreadsheetService: SpreadsheetService, element: ElementRef, renderer: Renderer2, localization: SpreadsheetLocalizationService, dialogService: DialogService, ngZone: NgZone);
-    addButton: ButtonComponent;
-    menuButton: DropDownButtonComponent;
-    tabstrip: TabStripComponent;
-    actionDdbs: QueryList<DropDownButtonComponent>;
-    actionDdbRefs: QueryList<ElementRef>;
-    get activeSheet(): string;
-    plusIcon: SVGIcon;
-    menuIcon: SVGIcon;
-    chevronDownIcon: SVGIcon;
-    selected: boolean;
-    sheetsMenuList: any[];
-    private openedDdb;
-    private tabListSub;
-    private hiddenStateIcons;
-    private hiddenStateSVGIcons;
-    get tablistId(): string;
-    ngAfterViewInit(): void;
-    ngOnChanges(changes: SimpleChanges): void;
-    ngOnDestroy(): void;
-    onAddClick: () => void;
-    onTabSelect(ev: SelectEvent): void;
-    onOpen(ddb: DropDownButtonComponent): void;
-    onClose(): void;
-    onActionClick(dataItem: SheetAction, sheet: SheetInfo): void;
-    onMenuItemClick(item: any): void;
-    messageFor(key: string): string;
-    private openDialog;
-    private getCopyRegex;
-    private actionsCallback;
-    private selectSheet;
-    private onTabListKeyDown;
-    private notifySheetsChange;
-    static ɵfac: i0.ɵɵFactoryDeclaration<SheetsBarComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<SheetsBarComponent, "[kendoSpreadsheetSheetsBar]", never, { "sheets": { "alias": "sheets"; "required": false; }; "sheetDescriptors": { "alias": "sheetDescriptors"; "required": false; }; }, {}, never, never, true, never>;
-}

package/sheets-bar/utils.d.ts

@@ -1,10 +0,0 @@
-/**-----------------------------------------------------------------------------------------
-* Copyright © 2026 Progress Software Corporation. All rights reserved.
-* Licensed under commercial license. See LICENSE.md in the project root for more information
-*-------------------------------------------------------------------------------------------*/
-import { SheetDescriptor } from '@progress/kendo-spreadsheet-common';
-import { SheetAction, SheetInfo } from '../models';
-/**
- * @hidden
- */
-export declare const getSheetActions: (items: SheetDescriptor[] | SheetInfo[], item?: SheetDescriptor) => SheetAction[];