@progress/kendo-angular-grid 19.0.0-develop.10 → 19.0.0-develop.12

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@progress/kendo-angular-grid",
-  "version": "19.0.0-develop.10",
+  "version": "19.0.0-develop.12",
   "description": "Kendo UI Grid for Angular - high performance data grid with paging, filtering, virtualization, CRUD, and more.",
   "license": "SEE LICENSE IN LICENSE.md",
   "author": "Progress",
@@ -26,7 +26,7 @@
     "package": {
       "productName": "Kendo UI for Angular",
       "productCode": "KENDOUIANGULAR",
-      "publishDate": 1746795205,
+      "publishDate": 1747069795,
       "licensingDocsUrl": "https://www.telerik.com/kendo-angular-ui/my-license/"
     }
   },
@@ -39,28 +39,28 @@
     "@progress/kendo-data-query": "^1.0.0",
     "@progress/kendo-drawing": "^1.21.0",
     "@progress/kendo-licensing": "^1.5.0",
-    "@progress/kendo-angular-buttons": "19.0.0-develop.10",
-    "@progress/kendo-angular-common": "19.0.0-develop.10",
-    "@progress/kendo-angular-dateinputs": "19.0.0-develop.10",
-    "@progress/kendo-angular-layout": "19.0.0-develop.10",
-    "@progress/kendo-angular-dropdowns": "19.0.0-develop.10",
-    "@progress/kendo-angular-excel-export": "19.0.0-develop.10",
-    "@progress/kendo-angular-icons": "19.0.0-develop.10",
-    "@progress/kendo-angular-inputs": "19.0.0-develop.10",
-    "@progress/kendo-angular-indicators": "19.0.0-develop.10",
-    "@progress/kendo-angular-intl": "19.0.0-develop.10",
-    "@progress/kendo-angular-l10n": "19.0.0-develop.10",
-    "@progress/kendo-angular-label": "19.0.0-develop.10",
-    "@progress/kendo-angular-pager": "19.0.0-develop.10",
-    "@progress/kendo-angular-pdf-export": "19.0.0-develop.10",
-    "@progress/kendo-angular-popup": "19.0.0-develop.10",
-    "@progress/kendo-angular-toolbar": "19.0.0-develop.10",
-    "@progress/kendo-angular-utils": "19.0.0-develop.10",
+    "@progress/kendo-angular-buttons": "19.0.0-develop.12",
+    "@progress/kendo-angular-common": "19.0.0-develop.12",
+    "@progress/kendo-angular-dateinputs": "19.0.0-develop.12",
+    "@progress/kendo-angular-layout": "19.0.0-develop.12",
+    "@progress/kendo-angular-dropdowns": "19.0.0-develop.12",
+    "@progress/kendo-angular-excel-export": "19.0.0-develop.12",
+    "@progress/kendo-angular-icons": "19.0.0-develop.12",
+    "@progress/kendo-angular-inputs": "19.0.0-develop.12",
+    "@progress/kendo-angular-indicators": "19.0.0-develop.12",
+    "@progress/kendo-angular-intl": "19.0.0-develop.12",
+    "@progress/kendo-angular-l10n": "19.0.0-develop.12",
+    "@progress/kendo-angular-label": "19.0.0-develop.12",
+    "@progress/kendo-angular-pager": "19.0.0-develop.12",
+    "@progress/kendo-angular-pdf-export": "19.0.0-develop.12",
+    "@progress/kendo-angular-popup": "19.0.0-develop.12",
+    "@progress/kendo-angular-toolbar": "19.0.0-develop.12",
+    "@progress/kendo-angular-utils": "19.0.0-develop.12",
     "rxjs": "^6.5.3 || ^7.0.0"
   },
   "dependencies": {
     "tslib": "^2.3.1",
-    "@progress/kendo-angular-schematics": "19.0.0-develop.10",
+    "@progress/kendo-angular-schematics": "19.0.0-develop.12",
     "@progress/kendo-common": "^1.0.1",
     "@progress/kendo-file-saver": "^1.0.0"
   },

package/pdf/pdf-command-tool.directive.d.ts

@@ -2,8 +2,11 @@
 * Copyright © 2025 Progress Software Corporation. All rights reserved.
 * Licensed under commercial license. See LICENSE.md in the project root for more information
 *-------------------------------------------------------------------------------------------*/
+import { ChangeDetectorRef, NgZone } from '@angular/core';
 import { PDFService } from './pdf.service';
 import { ToolBarButtonComponent } from '@progress/kendo-angular-toolbar';
+import { ContextService } from '../common/provider.service';
+import { ToolbarToolBase } from '../common/toolbar-tool-base.directive';
 import * as i0 from "@angular/core";
 /**
  * Represents the `export-to-PDF` toolbar tool of the Grid.
@@ -25,13 +28,11 @@ import * as i0 from "@angular/core";
  * </kendo-grid>
  * ```
  */
-export declare class PDFCommandToolbarDirective {
+export declare class PDFCommandToolbarDirective extends ToolbarToolBase {
     private pdfService;
-    private host;
-    private clickSub;
-    constructor(pdfService: PDFService, host: ToolBarButtonComponent);
+    host: ToolBarButtonComponent;
+    constructor(pdfService: PDFService, host: ToolBarButtonComponent, ctx: ContextService, zone: NgZone, cdr: ChangeDetectorRef);
     ngOnInit(): void;
-    ngOnDestroy(): void;
     /**
      * @hidden
      */

package/rendering/cell.component.d.ts

@@ -44,7 +44,7 @@ export declare class CellComponent implements DoCheck {
     get selectionCheckboxId(): string;
     get selectionCheckboxLabel(): string;
     get isSpanColumn(): boolean;
-    get childColumns(): ColumnComponent[];
+    get children(): ColumnComponent[];
     get isRowReorderColumn(): boolean;
     get isRowSelectable(): boolean;
     private _rowIndex;

package/schematics/ngAdd/index.js

@@ -4,14 +4,14 @@ const schematics_1 = require("@angular-devkit/schematics");
 function default_1(options) {
     const finalOptions = Object.assign(Object.assign({}, options), { mainNgModule: 'GridModule', package: 'grid', peerDependencies: {
             // peer deps of the dropdowns
-            '@progress/kendo-angular-treeview': '19.0.0-develop.10',
-            '@progress/kendo-angular-navigation': '19.0.0-develop.10',
+            '@progress/kendo-angular-treeview': '19.0.0-develop.12',
+            '@progress/kendo-angular-navigation': '19.0.0-develop.12',
             // peer dependency of kendo-angular-inputs
-            '@progress/kendo-angular-dialog': '19.0.0-develop.10',
+            '@progress/kendo-angular-dialog': '19.0.0-develop.12',
             // peer dependency of kendo-angular-icons
             '@progress/kendo-svg-icons': '^4.0.0',
             // peer dependency of kendo-angular-layout
-            '@progress/kendo-angular-progressbar': '19.0.0-develop.10'
+            '@progress/kendo-angular-progressbar': '19.0.0-develop.12'
         } });
     return (0, schematics_1.externalSchematic)('@progress/kendo-angular-schematics', 'ng-add', finalOptions);
 }

package/selection/selection.service.d.ts

@@ -70,6 +70,7 @@ export declare class SelectionService implements OnDestroy {
     addSubscriptions(): void;
     private getIterator;
     private removeSubscriptions;
+    private syncCurrentSelection;
     static ɵfac: i0.ɵɵFactoryDeclaration<SelectionService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<SelectionService>;
 }

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

@@ -0,0 +1,58 @@
+/**-----------------------------------------------------------------------------------------
+* Copyright © 2025 Progress Software Corporation. All rights reserved.
+* Licensed under commercial license. See LICENSE.md in the project root for more information
+*-------------------------------------------------------------------------------------------*/
+import { State } from "@progress/kendo-data-query";
+import { GridDataResult } from "../data/data.collection";
+import { PreventableEvent } from "@progress/kendo-angular-common";
+/**
+ * Represent the state of each Grid column that can be changed by the user.
+ */
+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.
+     */
+    hidden?: boolean;
+    /**
+     * The column locked state.
+     */
+    locked?: boolean;
+    /**
+     * The column sticky state.
+     */
+    sticky?: boolean;
+    orderIndex?: number;
+}
+/**
+ * The state of the grid component.
+ * It includes the current `State`, data, and columns state.
+ */
+export interface GridState extends State {
+    columnsState?: ColumnState[];
+    currentData?: Array<any> | GridDataResult | null;
+}
+/**
+ * Arguments for the `undo` and `redo` events.
+ */
+export declare class UndoRedoEvent extends PreventableEvent {
+    /**
+     * The event data of the original action that triggered the state change.
+     */
+    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

@@ -0,0 +1,38 @@
+/**-----------------------------------------------------------------------------------------
+* Copyright © 2025 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 for triggering the redo action in the Grid.
+ * You can apply this directive to any `kendo-toolbar-button` element inside a
+ * ToolbarComponent used in the Grid.
+ *
+ * When the user clicks the toolbar button that is associated with the directive, the
+ * [redo]({% slug api_grid_undoredodirective %}#toc-redo) event is triggered.
+ *
+ * @example
+ * ```html-no-run
+ * <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;
+    constructor(undoRedoService: UndoRedoService, host: ToolBarButtonComponent);
+    ngOnInit(): void;
+    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

@@ -0,0 +1,38 @@
+/**-----------------------------------------------------------------------------------------
+* Copyright © 2025 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 for triggering the undo action in the Grid.
+ * You can apply this directive to any `kendo-toolbar-button` element inside a
+ * ToolbarComponent used in the Grid.
+ *
+ * When the user clicks the toolbar button that is associated with the directive, the
+ * [undo]({% slug api_grid_undoredodirective %}#toc-undo) event is triggered.
+ *
+ * @example
+ * ```html-no-run
+ * <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;
+    constructor(undoRedoService: UndoRedoService, host: ToolBarButtonComponent);
+    ngOnInit(): void;
+    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

@@ -0,0 +1,51 @@
+/**-----------------------------------------------------------------------------------------
+* Copyright © 2025 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 * as i0 from "@angular/core";
+export declare class UndoRedoDirective implements OnInit, OnDestroy {
+    private host;
+    private editService;
+    private undoRedoService;
+    private changeNotification;
+    /**
+     * Determines the maximum number of actions to keep in the undo-redo stack.
+     * @default 10
+     */
+    maxStoredStates: number;
+    /**
+     * Fires when undo action is performed. Exposes the state of the grid that will be applied.
+     */
+    onUndo: EventEmitter<UndoRedoEvent>;
+    /**
+     * Fires when undo action is performed. Exposes the state of the grid that will be applied.
+     */
+    onRedo: EventEmitter<UndoRedoEvent>;
+    /**
+     * Returns an array of all undo-redo actions that are currently in the stack.
+     */
+    get undoRedoItems(): UndoRedoEvent[];
+    private stack;
+    private subs;
+    private addToState;
+    constructor(host: GridComponent, editService: EditService, undoRedoService: UndoRedoService, changeNotification: ChangeNotificationService);
+    ngOnInit(): void;
+    ngOnDestroy(): void;
+    /**
+     * Re-applies the last action, reverted by the `undo` method.
+     */
+    redo(): void;
+    /**
+     * Reverts the last user action.
+     */
+    undo(): void;
+    private updateUndoRedoDisabled;
+    static ɵfac: i0.ɵɵFactoryDeclaration<UndoRedoDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<UndoRedoDirective, "[kendoGridUndoRedo]", ["kendoGridUndoRedo"], { "maxStoredStates": { "alias": "maxStoredStates"; "required": false; }; }, { "onUndo": "undo"; "onRedo": "redo"; }, never, never, true, never>;
+}

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

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

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

@@ -0,0 +1,104 @@
+/**-----------------------------------------------------------------------------------------
+* Copyright © 2025 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;
+    /**
+     * 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>[];
+}

package/utils.d.ts

@@ -4,7 +4,9 @@
 *-------------------------------------------------------------------------------------------*/
 import { QueryList, InjectionToken } from '@angular/core';
 import { Observable } from 'rxjs';
-import { ColumnBase, RowArgs } from '.';
+import { ColumnBase } from './columns/column-base';
+import { RowArgs } from './rendering/common/row-args';
+import { ColumnState } from './state-management/grid-state.models';
 export { isChanged, anyChanged, hasObservers } from '@progress/kendo-angular-common';
 /**
  * @hidden
@@ -93,6 +95,14 @@ export declare const replaceMessagePlaceholder: (message: string, name: string,
  * @hidden
  */
 export declare const recursiveFlatMap: (item: any) => any[];
+/**
+ * @hidden
+ */
+export declare const updateColumnFromState: (columnState: ColumnState, c: any) => void;
+/**
+ * @hidden
+ */
+export declare const recursiveColumnsFlatMap: (item: any) => any[];
 /**
  * @hidden
  */