@progress/kendo-angular-grid 21.2.0 → 21.3.0-develop.2

package/grid.component.d.ts

@@ -7,6 +7,7 @@ import { CellSelectedFn, GridSelectionItem, SelectableSettings, SelectionEvent }
 import { AfterContentInit, AfterViewInit, ElementRef, EventEmitter, OnChanges, OnDestroy, OnInit, Renderer2, QueryList, SimpleChange, NgZone, ChangeDetectorRef, TemplateRef, TrackByFunction, ViewContainerRef } from '@angular/core';
 import { FormGroup } from '@angular/forms';
 import { SortDescriptor, GroupDescriptor, CompositeFilterDescriptor } from '@progress/kendo-data-query';
+import { GridAIRequestResponseService } from './rendering/toolbar/tools/ai-assistant/ai-request-response.service';
 import { DetailTemplateDirective } from './rendering/details/detail-template.directive';
 import { ScrollMode } from './scrolling/scrollmode';
 import { SortSettings } from './columns/sort-settings';
@@ -55,6 +56,7 @@ import { ColumnReorderConfig } from './dragdrop/column-reorder-config';
 import { NavigationService } from './navigation/navigation.service';
 import { NavigationCell } from './navigation/navigation-cell.interface';
 import { NavigationRow } from './navigation/navigation-row.interface';
+import { IdService } from './common/id.service';
 import { ColumnInfoService } from "./common/column-info.service";
 import { ScrollRequestService, ScrollRequest, ScrollToItemRequest } from './scrolling/scroll-request.service';
 import { SortService } from './common/sort.service';
@@ -157,6 +159,8 @@ export declare class GridComponent implements AfterContentInit, AfterViewInit, O
     adaptiveGridService: AdaptiveGridService;
     rowReorderService: RowReorderService;
     private dataMappingService;
+    private aiRequestResponseService;
+    private idService;
     /**
      * Sets the data of the Grid. If you provide an array, the Grid gets the total count automatically.
      * ([more information and example]({% slug binding_grid %})).
@@ -741,7 +745,7 @@ export declare class GridComponent implements AfterContentInit, AfterViewInit, O
     private rowReorderSubscription;
     private rtl;
     private _rowSticky;
-    constructor(supportService: BrowserSupportService, selectionService: SelectionService, cellSelectionService: CellSelectionService, wrapper: ElementRef, groupInfoService: GroupInfoService, groupsService: GroupsService, changeNotification: ChangeNotificationService, detailsService: DetailsService, editService: EditService, filterService: FilterService, pdfService: PDFService, responsiveService: ResponsiveService, renderer: Renderer2, excelService: ExcelService, ngZone: NgZone, scrollSyncService: ScrollSyncService, domEvents: DomEventsService, columnResizingService: ColumnResizingService, changeDetectorRef: ChangeDetectorRef, columnReorderService: ColumnReorderService, columnInfoService: ColumnInfoService, navigationService: NavigationService, sortService: SortService, scrollRequestService: ScrollRequestService, localization: LocalizationService, ctx: ContextService, sizingService: SizingOptionsService, adaptiveGridService: AdaptiveGridService, rowReorderService: RowReorderService, dataMappingService: DataMappingService);
+    constructor(supportService: BrowserSupportService, selectionService: SelectionService, cellSelectionService: CellSelectionService, wrapper: ElementRef, groupInfoService: GroupInfoService, groupsService: GroupsService, changeNotification: ChangeNotificationService, detailsService: DetailsService, editService: EditService, filterService: FilterService, pdfService: PDFService, responsiveService: ResponsiveService, renderer: Renderer2, excelService: ExcelService, ngZone: NgZone, scrollSyncService: ScrollSyncService, domEvents: DomEventsService, columnResizingService: ColumnResizingService, changeDetectorRef: ChangeDetectorRef, columnReorderService: ColumnReorderService, columnInfoService: ColumnInfoService, navigationService: NavigationService, sortService: SortService, scrollRequestService: ScrollRequestService, localization: LocalizationService, ctx: ContextService, sizingService: SizingOptionsService, adaptiveGridService: AdaptiveGridService, rowReorderService: RowReorderService, dataMappingService: DataMappingService, aiRequestResponseService: GridAIRequestResponseService, idService: IdService);
     /**
      * Expands the master row at the specified data row index ([see example]({% slug hierarchy_grid %})).
      *
@@ -784,6 +788,42 @@ export declare class GridComponent implements AfterContentInit, AfterViewInit, O
      * @hidden
      */
     resetGroupsState(): void;
+    /**
+     * Builds the request body for the AI service based on the provided prompt message.
+     * Allows developers to construct their own AI service requests.
+     *
+     * @param promptMessage - The prompt message to send to the AI service.
+     * @returns The request body object ready to be sent to the AI service.
+     *
+     * @example
+     * ```ts
+     * const requestBody = this.grid.getAIRequest('Sort by Product Name ascending');
+     *
+     * // Send to your AI service
+     * this.http.post('https://your-ai-service.com/api', requestBody).subscribe(response => {
+     *   this.grid.handleAIResponse(response);
+     * });
+     * ```
+     */
+    getAIRequest(promptMessage: string): any;
+    /**
+     * Processes an AI service response and applies the commands to the Grid.
+     * Allows developers to handle their own AI service responses manually.
+     *
+     * @param response - The AI service response containing optional message and commands array.
+     *
+     * @example
+     * ```ts
+     * const response = {
+     *   message: 'Applying sorting',
+     *   commands: [
+     *     { type: 'GridSort', sort: { field: 'ProductName', dir: 'asc' }, message: 'Sorted by Product Name' }
+     *   ]
+     * };
+     * this.grid.handleAIResponse(response);
+     * ```
+     */
+    handleAIResponse(response: any): void;
     /**
      * @hidden
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@progress/kendo-angular-grid",
-  "version": "21.2.0",
+  "version": "21.3.0-develop.2",
   "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",
@@ -73,7 +73,7 @@
     "package": {
       "productName": "Kendo UI for Angular",
       "productCode": "KENDOUIANGULAR",
-      "publishDate": 1764751621,
+      "publishDate": 1764927764,
       "licensingDocsUrl": "https://www.telerik.com/kendo-angular-ui/my-license/"
     }
   },
@@ -84,34 +84,34 @@
     "@angular/forms": "18 - 21",
     "@angular/platform-browser": "18 - 21",
     "@progress/kendo-data-query": "^1.0.0",
-    "@progress/kendo-drawing": "^1.21.0",
+    "@progress/kendo-drawing": "^1.23.1",
     "@progress/kendo-licensing": "^1.7.0",
-    "@progress/kendo-angular-buttons": "21.2.0",
-    "@progress/kendo-angular-common": "21.2.0",
-    "@progress/kendo-angular-dateinputs": "21.2.0",
-    "@progress/kendo-angular-layout": "21.2.0",
-    "@progress/kendo-angular-navigation": "21.2.0",
-    "@progress/kendo-angular-dropdowns": "21.2.0",
-    "@progress/kendo-angular-excel-export": "21.2.0",
-    "@progress/kendo-angular-icons": "21.2.0",
-    "@progress/kendo-angular-indicators": "21.2.0",
-    "@progress/kendo-angular-inputs": "21.2.0",
-    "@progress/kendo-angular-conversational-ui": "21.2.0",
-    "@progress/kendo-angular-intl": "21.2.0",
-    "@progress/kendo-angular-l10n": "21.2.0",
-    "@progress/kendo-angular-label": "21.2.0",
-    "@progress/kendo-angular-menu": "21.2.0",
-    "@progress/kendo-angular-pager": "21.2.0",
-    "@progress/kendo-angular-pdf-export": "21.2.0",
-    "@progress/kendo-angular-popup": "21.2.0",
-    "@progress/kendo-angular-toolbar": "21.2.0",
-    "@progress/kendo-angular-upload": "21.2.0",
-    "@progress/kendo-angular-utils": "21.2.0",
+    "@progress/kendo-angular-buttons": "21.3.0-develop.2",
+    "@progress/kendo-angular-common": "21.3.0-develop.2",
+    "@progress/kendo-angular-dateinputs": "21.3.0-develop.2",
+    "@progress/kendo-angular-layout": "21.3.0-develop.2",
+    "@progress/kendo-angular-navigation": "21.3.0-develop.2",
+    "@progress/kendo-angular-dropdowns": "21.3.0-develop.2",
+    "@progress/kendo-angular-excel-export": "21.3.0-develop.2",
+    "@progress/kendo-angular-icons": "21.3.0-develop.2",
+    "@progress/kendo-angular-indicators": "21.3.0-develop.2",
+    "@progress/kendo-angular-inputs": "21.3.0-develop.2",
+    "@progress/kendo-angular-conversational-ui": "21.3.0-develop.2",
+    "@progress/kendo-angular-intl": "21.3.0-develop.2",
+    "@progress/kendo-angular-l10n": "21.3.0-develop.2",
+    "@progress/kendo-angular-label": "21.3.0-develop.2",
+    "@progress/kendo-angular-menu": "21.3.0-develop.2",
+    "@progress/kendo-angular-pager": "21.3.0-develop.2",
+    "@progress/kendo-angular-pdf-export": "21.3.0-develop.2",
+    "@progress/kendo-angular-popup": "21.3.0-develop.2",
+    "@progress/kendo-angular-toolbar": "21.3.0-develop.2",
+    "@progress/kendo-angular-upload": "21.3.0-develop.2",
+    "@progress/kendo-angular-utils": "21.3.0-develop.2",
     "rxjs": "^6.5.3 || ^7.0.0"
   },
   "dependencies": {
     "tslib": "^2.3.1",
-    "@progress/kendo-angular-schematics": "21.2.0",
+    "@progress/kendo-angular-schematics": "21.3.0-develop.2",
     "@progress/kendo-common": "^1.0.1",
     "@progress/kendo-file-saver": "^1.0.0"
   },

package/rendering/toolbar/tools/ai-assistant/ai-assistant.component.d.ts

@@ -9,6 +9,7 @@ import { ContextService } from './../../../../common/provider.service';
 import { ColumnInfoService } from './../../../../common/column-info.service';
 import { AIAssistantToolbarDirective } from './ai-tool.directive';
 import { GridAIAssistantPromptSettings, GridAIRequestOptions } from './models';
+import { GridAIRequestResponseService } from './ai-request-response.service';
 import * as i0 from "@angular/core";
 /**
  * @hidden
@@ -18,6 +19,7 @@ export declare class AiAssistantComponent implements OnDestroy, AfterViewInit {
     private ctx;
     private columnInfoService;
     private zone;
+    private aiRequestResponseService;
     aiPrompt: AIPromptComponent;
     activeView: number;
     requestUrl: string;
@@ -32,9 +34,8 @@ export declare class AiAssistantComponent implements OnDestroy, AfterViewInit {
     private loadingOutput;
     private columns;
     private leafColumns;
-    private columnsTree;
     private idCounter;
-    constructor(http: HttpClient, ctx: ContextService, columnInfoService: ColumnInfoService, zone: NgZone);
+    constructor(http: HttpClient, ctx: ContextService, columnInfoService: ColumnInfoService, zone: NgZone, aiRequestResponseService: GridAIRequestResponseService);
     ngAfterViewInit(): void;
     ngOnDestroy(): void;
     message(message: string): string;
@@ -45,27 +46,6 @@ export declare class AiAssistantComponent implements OnDestroy, AfterViewInit {
     private handleError;
     private deleteLoadingOutput;
     private unsubscribeCurrentRequest;
-    private processArrayResponse;
-    private processCommands;
-    private runExportWithFileName;
-    private processPageCommand;
-    private processPageSizeCommand;
-    private emitGridPageChange;
-    private ensurePageSizeOption;
-    private getCurrentPageSizeValue;
-    private getTotalItemsCount;
-    private getSelectionInstance;
-    private updateLastMessage;
-    private getHighlightItems;
-    private processSelectionResponse;
-    private mapHighlightItemsToSelection;
-    private applySelectionState;
-    private replaceQuotedColumnId;
-    private isColumnCommand;
-    private getColumnReplacement;
-    private processHighlightResponse;
-    private processFilterResponse;
-    private changeColumnPosition;
     static ɵfac: i0.ɵɵFactoryDeclaration<AiAssistantComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<AiAssistantComponent, "ng-component", never, {}, {}, never, never, true, never>;
 }

package/rendering/toolbar/tools/ai-assistant/ai-request-response.service.d.ts

@@ -0,0 +1,61 @@
+/**-----------------------------------------------------------------------------------------
+* Copyright © 2025 Progress Software Corporation. All rights reserved.
+* Licensed under commercial license. See LICENSE.md in the project root for more information
+*-------------------------------------------------------------------------------------------*/
+import { NgZone } from '@angular/core';
+import { ColumnInfoService } from './../../../../common/column-info.service';
+import { ContextService } from './../../../../common/provider.service';
+import { GridAICommand } from './models';
+import * as i0 from "@angular/core";
+/**
+ * @hidden
+ *
+ * Service that builds AI requests and processes AI responses for the Grid.
+ * Used internally by both the Grid component and the AI Assistant tool.
+ */
+export declare class GridAIRequestResponseService {
+    private ctx;
+    private columnInfoService;
+    private zone;
+    constructor(ctx: ContextService, columnInfoService: ColumnInfoService, zone: NgZone);
+    /**
+     * Builds the request body for the AI service based on the Grid's column structure.
+     * Returns a column descriptor tree that includes column metadata for the AI service.
+     */
+    buildRequestBody(promptMessage: string, role?: string): any;
+    /**
+     * Builds a nested column descriptor tree based on the Grid's column structure.
+     * Includes root columns and their nested children (for ColumnGroup and SpanColumn).
+     */
+    private buildColumnDescriptors;
+    /**
+     * Processes AI response commands and applies them to the Grid.
+     * Returns an array of display messages for each command.
+     */
+    processCommands(commands: GridAICommand[], columns: {
+        field: string;
+    }[], leafColumns: any[]): string[];
+    private executeCommands;
+    private processArrayResponse;
+    private runExportWithFileName;
+    private processPageCommand;
+    private processPageSizeCommand;
+    private emitGridPageChange;
+    private ensurePageSizeOption;
+    private getCurrentPageSizeValue;
+    private getTotalItemsCount;
+    private getSelectionInstance;
+    private updateLastMessage;
+    private isColumnCommand;
+    private getColumnReplacement;
+    private replaceQuotedColumnId;
+    private getHighlightItems;
+    private processSelectionResponse;
+    private mapHighlightItemsToSelection;
+    private applySelectionState;
+    private processHighlightResponse;
+    private processFilterResponse;
+    private changeColumnPosition;
+    static ɵfac: i0.ɵɵFactoryDeclaration<GridAIRequestResponseService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<GridAIRequestResponseService>;
+}

package/schematics/ngAdd/index.js

@@ -9,19 +9,19 @@ 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': '21.2.0',
-            '@progress/kendo-angular-navigation': '21.2.0',
+            '@progress/kendo-angular-treeview': '21.3.0-develop.2',
+            '@progress/kendo-angular-navigation': '21.3.0-develop.2',
             // peer dependency of kendo-angular-inputs
-            '@progress/kendo-angular-dialog': '21.2.0',
+            '@progress/kendo-angular-dialog': '21.3.0-develop.2',
             // peer dependency of kendo-angular-icons
             '@progress/kendo-svg-icons': '^4.0.0',
             // peer dependency of kendo-angular-layout
-            '@progress/kendo-angular-progressbar': '21.2.0',
+            '@progress/kendo-angular-progressbar': '21.3.0-develop.2',
             // transitive peer dependencies from toolbar
-            '@progress/kendo-angular-indicators': '21.2.0',
+            '@progress/kendo-angular-indicators': '21.3.0-develop.2',
             // transitive peer dependencies from conversational-ui
-            '@progress/kendo-angular-menu': '21.2.0',
-            '@progress/kendo-angular-upload': '21.2.0'
+            '@progress/kendo-angular-menu': '21.3.0-develop.2',
+            '@progress/kendo-angular-upload': '21.3.0-develop.2'
         } });
     return (0, schematics_1.externalSchematic)('@progress/kendo-angular-schematics', 'ng-add', finalOptions);
 }