@progress/kendo-angular-grid 24.2.2 → 25.0.0-develop.2

package/selection/selection.service.d.ts

@@ -1,79 +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 { EventEmitter, OnDestroy } from '@angular/core';
-import { SelectableSettings, SelectionEvent } from './types';
-import { RowSelectableFn, RowSelectedFn } from '../rendering/common/row-class';
-import { RowArgs } from '../rendering/common/row-args';
-import { DomEventsService } from '../common/dom-events.service';
-import { LocalDataChangesService } from '../editing/local-data-changes.service';
-import { NavigationService } from '../navigation/navigation.service';
-import { SelectionAggregates } from '../aggregates/aggregate-types';
-import { ContextService } from '../common/provider.service';
-import { CellSelectionAggregateService } from '../aggregates/selection-aggregate.service';
-import * as i0 from "@angular/core";
-/**
- * @hidden
- */
-type SelectionServiceSettings = {
-    rowSelected: RowSelectedFn;
-    isRowSelectable: RowSelectableFn;
-    selectable: boolean | SelectableSettings;
-    view: {
-        accessor: Function;
-        at: Function;
-        length: number;
-    };
-};
-/**
- * @hidden
- */
-export declare class SelectionService implements OnDestroy {
-    private domEvents;
-    private aggregateService;
-    private localDataChangesService?;
-    private navigationService?;
-    private ctxService?;
-    changes: EventEmitter<SelectionEvent>;
-    lastSelectionStartIndex: any;
-    currentSelection: any[];
-    nonSelectableRows: Map<any, any>;
-    selectAllChecked: boolean;
-    settings: SelectionServiceSettings;
-    active: boolean;
-    aggregates: SelectionAggregates;
-    get enableMarquee(): boolean;
-    mouseDownEventArgs: any;
-    dragging: boolean;
-    get hasNonSelectable(): boolean;
-    private cellClickSubscription;
-    private mousedownSubscription;
-    private dataChangedSubscription;
-    private lastSelectionData;
-    private _selectAllState;
-    constructor(domEvents: DomEventsService, aggregateService: CellSelectionAggregateService, localDataChangesService?: LocalDataChangesService, navigationService?: NavigationService, ctxService?: ContextService);
-    init(settings: any): void;
-    isSelected(index: number): boolean;
-    handleClick(item: any, event: any): void;
-    toggle(item: any): any;
-    toggleByIndex(index: number): any;
-    select(item: any): any;
-    deselect(removedItem: any): void;
-    addAllTo(item: any, ctrlKey: boolean, preserveSelection?: boolean, shiftKey?: boolean): any;
-    updateAll(selectAllChecked: boolean): void;
-    selectRange(startIndex: number, endIndex: number, preserveSelection: boolean, existingSelections?: any[]): any;
-    setSelectionStart(row: RowArgs): void;
-    get selectAllState(): any;
-    get selected(): number[];
-    get options(): SelectableSettings;
-    ngOnDestroy(): void;
-    targetArgs(): any;
-    addSubscriptions(): void;
-    private getIterator;
-    private removeSubscriptions;
-    private syncCurrentSelection;
-    static ɵfac: i0.ɵɵFactoryDeclaration<SelectionService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<SelectionService>;
-}
-export {};

package/selection/types.d.ts

@@ -1,174 +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 { SelectionAggregate, SelectionAggregates } from '../aggregates/aggregate-types';
-import { ColumnComponent } from './../columns/column.component';
-import { RowArgs } from './../rendering/common/row-args';
-/**
- * Represents the callback used by the [`cellSelected`](https://www.telerik.com/kendo-angular-ui/components/grid/api/gridcomponent#cellselected) property. ([See example](https://www.telerik.com/kendo-angular-ui/components/grid/selection/custom-selection#setting-the-selected-cells)).
- *
- * @param row The row arguments.
- * @param column The column component.
- * @param colIndex The column index.
- * @returns An object with `selected` and `item` properties.
- */
-export type CellSelectedFn = (row: RowArgs, column: ColumnComponent, colIndex: number) => {
-    selected: boolean;
-    item: CellSelectionItem;
-};
-/**
- * Provides arguments for the Grid [`selectionChange`](https://www.telerik.com/kendo-angular-ui/components/grid/api/gridcomponent#selectionchange) event.
- */
-export interface SelectionEvent {
-    /**
-     * Contains the cell selection aggregates.
-     */
-    cellAggregates?: SelectionAggregates;
-    /**
-     * Lists the row items added to the selection.
-     */
-    selectedRows?: RowArgs[];
-    /**
-     * Lists the row items removed from the selection.
-     */
-    deselectedRows?: RowArgs[];
-    /**
-     * Lists the cell items added to the selection.
-     */
-    selectedCells?: CellSelectionItem[];
-    /**
-     * Lists the cell items removed from the selection.
-     */
-    deselectedCells?: CellSelectionItem[];
-    /**
-     * Shows the state of the `Ctrl` key (or the `Command` key on a Mac) during selection.
-     */
-    ctrlKey?: boolean;
-    /**
-     * Shows the state of the `Shift` key during selection.
-     */
-    shiftKey?: boolean;
-    /**
-     * Represents the initially clicked row in a `Shift`+click range row selection.
-     */
-    rangeStartRow?: RowArgs;
-    /**
-     * Represents the item in a `Shift`+click range row selection.
-     */
-    rangeEndRow?: RowArgs;
-    /**
-     * Represents the initially clicked cell in a `Shift`+click range cell selection.
-     */
-    rangeStartCell?: CellSelectionItem;
-    /**
-     * Represents the cell in a `Shift`+click range cell selection.
-     */
-    rangeEndCell?: CellSelectionItem;
-}
-/**
- * Configures the selection functionality of the Grid. ([See example](https://www.telerik.com/kendo-angular-ui/components/grid/selection#setup)).
- *
- * @example
- * ```html
- * <kendo-grid [data]="gridData" [selectable]="{ checkboxOnly: true, mode: 'multiple' }">
- *   <kendo-grid-column field="ProductID"> </kendo-grid-column>
- *   <kendo-grid-column field="ProductName"> </kendo-grid-column>
- * </kendo-grid>
- * ```
- */
-export interface SelectableSettings {
-    /**
-     * Enables selection aggregates. By default, this property is set to `false`.
-     * If you set `cellAggregates` to `true`, the Grid calculates all aggregate options.
-     * Pass an array of [`SelectionAggregate`](https://www.telerik.com/kendo-angular-ui/components/grid/api/selectionaggregate) type options to choose which aggregates to calculate.
-     *
-     */
-    cellAggregates?: boolean | SelectionAggregate[];
-    /**
-     * Enables selection.
-     *
-     */
-    enabled?: boolean;
-    /**
-     * Allows selection only through clicking a checkbox.
-     * When enabled, clicking the row does not select it.
-     * This applies if at least one checkbox column exists.
-     *
-     */
-    checkboxOnly?: boolean;
-    /**
-     * Sets the selectable mode.
-     *
-     */
-    mode?: SelectableMode;
-    /**
-     * Enables cell selection.
-     *
-     */
-    cell?: boolean;
-    /**
-     * Enables drag selection.
-     *
-     */
-    drag?: boolean;
-    /**
-     * Requires a meta key (`Ctrl` or `Command`) to select multiple items. By default, you must press a meta key to add a new row or cell to the selection.
-     *
-     */
-    metaKeyMultiSelect?: boolean;
-    /**
-     * Preserves the existing selection when you perform a new range selection.
-     *
-     */
-    multipleRanges?: boolean;
-}
-/**
- * Lists the available selection modes. [See example](https://www.telerik.com/kendo-angular-ui/components/grid/selection/row-selection).
- *
- * The available values are:
- * * `single`&mdash;Enables single selection. Clicking the selected row does not deselect it. [See example](https://www.telerik.com/kendo-angular-ui/components/grid/selection/row-selection#single-row-selection).
- * * `multiple`&mdash;Enables multiple selection. [See example](https://www.telerik.com/kendo-angular-ui/components/grid/selection/row-selection#multiple-rows-selection).
- *
- * @example
- * ```html
- * <kendo-grid [selectable]="{mode: 'multiple'}"></kendo-grid>
- * ```
- */
-export type SelectableMode = "single" | "multiple";
-/**
- * Lists the possible states of the select-all checkbox.
- *
- * @example
- * ```html
- *  <kendo-grid-column>
- *   <ng-template kendoGridHeaderTemplate>
- *     <input
- *       kendoGridSelectAllCheckbox
- *       state="indeterminate"
- *       ...
- *     />
- *    </ng-template>
- *  <kendo-grid-column>
- * ```
- */
-export type SelectAllCheckboxState = "checked" | "unchecked" | "indeterminate";
-/**
- * Describes the Grid cell selection item type.
- */
-export interface CellSelectionItem {
-    /**
-     * Identifies the selected item.
-     */
-    itemKey?: any;
-    /**
-     * Identifies the selected item column.
-     */
-    columnKey?: any;
-}
-/**
- * Lists the possible data types of the Grid selection items.
- *
- * @hidden
- */
-export type GridSelectionItem = number | RowArgs | CellSelectionItem;

package/state-management/grid-state.models.d.ts

@@ -1,71 +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 { CompositeFilterDescriptor, State } from "@progress/kendo-data-query";
-import { GridDataResult } from "../data/data.collection";
-import { PreventableEvent } from "@progress/kendo-angular-common";
-/**
- * Describes the state of a Grid column that users can change.
- */
-export interface ColumnState {
-    /**
-     * The column identifier that is unique in the scope of its `GridComponent` owner.
-     */
-    id: string;
-    /**
-     * The column width in pixels.
-     */
-    width?: number;
-    /**
-     * The column visibility state.
-     */
-    hidden?: boolean;
-    /**
-     * The column locked state.
-     */
-    locked?: boolean;
-    /**
-     * The column sticky state.
-     */
-    sticky?: boolean;
-    /**
-     * The order index of the column.
-     */
-    orderIndex?: number;
-}
-/**
- * Describes the state of the Grid component.
- * Includes the current `State`, data, columns and search state.
- */
-export interface GridState extends State {
-    /**
-     * The state of all columns in the Grid.
-     */
-    columnsState?: ColumnState[];
-    /**
-     * The current data in the Grid.
-     */
-    currentData?: Array<any> | GridDataResult | null;
-    /**
-     * The descriptors used for searching.
-     */
-    searchFilter?: CompositeFilterDescriptor;
-}
-/**
- * Provides arguments for the `undo` and `redo` events.
- */
-export declare class UndoRedoEvent extends PreventableEvent {
-    /**
-     * The event data for the action that changed the state.
-     */
-    readonly originalEvent: any;
-    /**
-     * The Grid state and rendered data at the time of the action.
-     */
-    readonly gridState: GridState;
-    /**
-     * @hidden
-     */
-    constructor({ originalEvent, gridState }: any);
-}

package/state-management/redo-command-tool.d.ts

@@ -1,46 +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 { ToolBarButtonComponent } from '@progress/kendo-angular-toolbar';
-import { UndoRedoService } from './undo-redo.service';
-import * as i0 from "@angular/core";
-/**
- * Represents the command that triggers the redo action in the Grid.
- * Apply this directive to any `kendo-toolbar-button` inside a ToolbarComponent in the Grid.
- *
- * When users click the toolbar button with this directive, the
- * [`redo`](https://www.telerik.com/kendo-angular-ui/components/grid/api/undoredodirective#redo) event is triggered.
- *
- * @example
- * ```html
- * <kendo-grid>
- *      <kendo-toolbar>
- *         <kendo-toolbar-button kendoGridRedoTool></kendo-toolbar-button>
- *      </kendo-toolbar>
- * </kendo-grid>
- * ```
- */
-export declare class RedoCommandToolbarDirective {
-    private undoRedoService;
-    private host;
-    private subs;
-    /**
-     * @hidden
-     */
-    constructor(undoRedoService: UndoRedoService, host: ToolBarButtonComponent);
-    /**
-     * @hidden
-     */
-    ngOnInit(): void;
-    /**
-     * @hidden
-     */
-    ngOnDestroy(): void;
-    /**
-     * @hidden
-     */
-    onClick(e: any): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<RedoCommandToolbarDirective, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<RedoCommandToolbarDirective, "[kendoGridRedoTool]", never, {}, {}, never, never, true, never>;
-}

package/state-management/undo-command-tool.d.ts

@@ -1,46 +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 { ToolBarButtonComponent } from '@progress/kendo-angular-toolbar';
-import { UndoRedoService } from './undo-redo.service';
-import * as i0 from "@angular/core";
-/**
- * Represents the command that triggers the undo action in the Grid.
- * Apply this directive to any `kendo-toolbar-button` inside a ToolbarComponent in the Grid.
- *
- * When users click the toolbar button with this directive, the
- * [`undo`](https://www.telerik.com/kendo-angular-ui/components/grid/api/undoredodirective#undo) event is triggered.
- *
- * @example
- * ```html
- * <kendo-grid>
- *      <kendo-toolbar>
- *         <kendo-toolbar-button kendoGridUndoTool></kendo-toolbar-button>
- *      </kendo-toolbar>
- * </kendo-grid>
- * ```
- */
-export declare class UndoCommandToolbarDirective {
-    private undoRedoService;
-    private host;
-    private subs;
-    /**
-     * @hidden
-     */
-    constructor(undoRedoService: UndoRedoService, host: ToolBarButtonComponent);
-    /**
-     * @hidden
-     */
-    ngOnInit(): void;
-    /**
-     * @hidden
-     */
-    ngOnDestroy(): void;
-    /**
-     * @hidden
-     */
-    onClick(e: any): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<UndoCommandToolbarDirective, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<UndoCommandToolbarDirective, "[kendoGridUndoTool]", never, {}, {}, never, never, true, never>;
-}

package/state-management/undo-redo.directive.d.ts

@@ -1,73 +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 { EventEmitter, OnDestroy, OnInit } from '@angular/core';
-import { GridComponent } from '../grid.component';
-import { UndoRedoEvent } from './grid-state.models';
-import { EditService } from '../editing/edit.service';
-import { UndoRedoService } from './undo-redo.service';
-import { ChangeNotificationService } from '../data/change-notification.service';
-import { ContextService } from '../common/provider.service';
-import { LocalDataChangesService } from '../editing/local-data-changes.service';
-import * as i0 from "@angular/core";
-/**
- * Represents the directive that manages undo-redo operations in the Grid.
- * Use this directive to enable undo and redo functionality for user actions in the Grid.
- *
- * @example
- * ```html
- * <kendo-grid [data]="data" kendoGridUndoRedo></kendo-grid>
- * ```
- * @remarks
- * Applied to: {@link GridComponent}.
- */
-export declare class UndoRedoDirective implements OnInit, OnDestroy {
-    private host;
-    private editService;
-    private undoRedoService;
-    private changeNotification;
-    private ctx?;
-    private localDataChangesService?;
-    /**
-     * Sets the maximum number of actions to keep in the undo-redo stack.
-     * @default 10
-     */
-    maxStoredStates: number;
-    /**
-     * Defines the property name of the data item unique key that will be used to identify the items when performing undo-redo actions.
-     */
-    itemIdKey: string | undefined;
-    /**
-     * Fires when you perform the undo action. Provides the Grid state to apply.
-     */
-    onUndo: EventEmitter<UndoRedoEvent>;
-    /**
-     * Fires when you perform the redo action. Provides the Grid state to apply.
-     */
-    onRedo: EventEmitter<UndoRedoEvent>;
-    /**
-     * Returns all undo-redo actions currently in the stack.
-     */
-    get undoRedoItems(): UndoRedoEvent[];
-    private stack;
-    private subs;
-    private addToState;
-    constructor(host: GridComponent, editService: EditService, undoRedoService: UndoRedoService, changeNotification: ChangeNotificationService, ctx?: ContextService, localDataChangesService?: LocalDataChangesService);
-    ngOnInit(): void;
-    ngAfterViewInit(): void;
-    ngOnDestroy(): void;
-    /**
-     * Re-applies the last action that you reverted with the `undo` method.
-     */
-    redo(): void;
-    /**
-     * Reverts the last user action that you performed.
-     */
-    undo(): void;
-    private updateUndoRedoDisabled;
-    private getGridDataItems;
-    private isDataStateChangeEvent;
-    static ɵfac: i0.ɵɵFactoryDeclaration<UndoRedoDirective, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<UndoRedoDirective, "[kendoGridUndoRedo]", ["kendoGridUndoRedo"], { "maxStoredStates": { "alias": "maxStoredStates"; "required": false; }; "itemIdKey": { "alias": "itemIdKey"; "required": false; }; }, { "onUndo": "undo"; "onRedo": "redo"; }, never, never, true, never>;
-}

package/state-management/undo-redo.service.d.ts

@@ -1,17 +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 { Subject } from 'rxjs';
-import * as i0 from "@angular/core";
-/**
- * @hidden
- */
-export declare class UndoRedoService {
-    originalEvent: any;
-    onUndo: Subject<undefined>;
-    onRedo: Subject<undefined>;
-    stackEndReached: Subject<'start' | 'end' | false>;
-    static ɵfac: i0.ɵɵFactoryDeclaration<UndoRedoService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<UndoRedoService>;
-}

package/state-management/undo-redo.stack.d.ts

@@ -1,106 +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
- * Represents a node in the undo-redo linked list.
- */
-export interface UndoRedoNode<T> {
-    /** The state data stored in the node */
-    state: T;
-    /** Reference to the previous node (the previous state) */
-    previous: UndoRedoNode<T> | null;
-    /** Reference to the next node (the next state) */
-    next: UndoRedoNode<T> | null;
-    /** Optional identifier for the node */
-    id?: string | number;
-}
-/**
- * @hidden
- * A linked-list based implementation of an undo-redo stack.
- * Maintains a chain of states that can be navigated forward and backward.
- */
-export declare class UndoRedoStack<T> {
-    private maxSize;
-    /** The current active node in the undo-redo history */
-    private currentNode;
-    /** The root node of the stack (first state) */
-    private rootNode;
-    /** Track the size of the stack */
-    private _size;
-    /**
-     * Creates a new UndoRedoStack.
-     * @param maxSize Optional maximum number of states to maintain (unlimited if not provided)
-     */
-    constructor(maxSize?: number);
-    /**
-     * Gets the current number of states in the stack
-     */
-    get size(): number;
-    /**
-     * Gets the current active state
-     */
-    get current(): T | null;
-    /**
-     * Checks if undo is available (if there's a previous state)
-     */
-    get canUndo(): boolean;
-    /**
-     * Checks if redo is available (if there's a next state)
-     */
-    get canRedo(): boolean;
-    /**
-     * Adds a new state to the undo-redo stack
-     * @param state The state to add
-     * @param id Optional identifier for the state
-     * @returns The newly created node
-     */
-    add(state: T, id?: string | number): UndoRedoNode<T>;
-    /**
-     * Finds a node by its identifier
-     * @param id The identifier to search for
-     * @returns The found node or null if not found
-     */
-    find(id: string | number): UndoRedoNode<T> | null;
-    /**
-     * Removes a node by its identifier
-     * @param id The identifier of the node to remove
-     * @returns True if the node was found and removed, false otherwise
-     */
-    remove(id: string | number): boolean;
-    /**
-     * Performs an undo operation, moving to the previous state
-     * @returns The previous state or null if can't undo
-     */
-    undo(): T | null;
-    peekNext(): T | null;
-    peekPrev(): T | null;
-    /**
-     * Performs a redo operation, moving to the next state
-     * @returns The next state or null if can't redo
-     */
-    redo(): T | null;
-    /**
-     * Clears all history
-     */
-    clear(): void;
-    /**
-     * Removes all states after the specified node
-     * @param node The node to truncate from
-     * @returns The number of nodes removed
-     */
-    private truncateForward;
-    /**
-     * Ensures the stack doesn't exceed the maximum size by removing oldest nodes
-     */
-    private enforceMaxSize;
-    /**
-     * Gets all states in the stack as an array (from oldest to newest)
-     */
-    toArray(): T[];
-    /**
-     * Gets the history nodes as an array (useful for debugging)
-     */
-    getNodes(): UndoRedoNode<T>[];
-}