@progress/kendo-angular-grid 19.3.0-develop.2 → 19.3.0-develop.21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@progress/kendo-angular-grid",
-  "version": "19.3.0-develop.2",
+  "version": "19.3.0-develop.21",
   "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": 1751964779,
+      "publishDate": 1754395862,
       "licensingDocsUrl": "https://www.telerik.com/kendo-angular-ui/my-license/"
     }
   },
@@ -38,29 +38,30 @@
     "@angular/platform-browser": "16 - 20",
     "@progress/kendo-data-query": "^1.0.0",
     "@progress/kendo-drawing": "^1.21.0",
-    "@progress/kendo-licensing": "^1.5.0",
-    "@progress/kendo-angular-buttons": "19.3.0-develop.2",
-    "@progress/kendo-angular-common": "19.3.0-develop.2",
-    "@progress/kendo-angular-dateinputs": "19.3.0-develop.2",
-    "@progress/kendo-angular-layout": "19.3.0-develop.2",
-    "@progress/kendo-angular-navigation": "19.3.0-develop.2",
-    "@progress/kendo-angular-dropdowns": "19.3.0-develop.2",
-    "@progress/kendo-angular-excel-export": "19.3.0-develop.2",
-    "@progress/kendo-angular-icons": "19.3.0-develop.2",
-    "@progress/kendo-angular-inputs": "19.3.0-develop.2",
-    "@progress/kendo-angular-intl": "19.3.0-develop.2",
-    "@progress/kendo-angular-l10n": "19.3.0-develop.2",
-    "@progress/kendo-angular-label": "19.3.0-develop.2",
-    "@progress/kendo-angular-pager": "19.3.0-develop.2",
-    "@progress/kendo-angular-pdf-export": "19.3.0-develop.2",
-    "@progress/kendo-angular-popup": "19.3.0-develop.2",
-    "@progress/kendo-angular-toolbar": "19.3.0-develop.2",
-    "@progress/kendo-angular-utils": "19.3.0-develop.2",
+    "@progress/kendo-licensing": "^1.7.0",
+    "@progress/kendo-angular-buttons": "19.3.0-develop.21",
+    "@progress/kendo-angular-common": "19.3.0-develop.21",
+    "@progress/kendo-angular-dateinputs": "19.3.0-develop.21",
+    "@progress/kendo-angular-layout": "19.3.0-develop.21",
+    "@progress/kendo-angular-navigation": "19.3.0-develop.21",
+    "@progress/kendo-angular-dropdowns": "19.3.0-develop.21",
+    "@progress/kendo-angular-excel-export": "19.3.0-develop.21",
+    "@progress/kendo-angular-icons": "19.3.0-develop.21",
+    "@progress/kendo-angular-inputs": "19.3.0-develop.21",
+    "@progress/kendo-angular-conversational-ui": "19.3.0-develop.21",
+    "@progress/kendo-angular-intl": "19.3.0-develop.21",
+    "@progress/kendo-angular-l10n": "19.3.0-develop.21",
+    "@progress/kendo-angular-label": "19.3.0-develop.21",
+    "@progress/kendo-angular-pager": "19.3.0-develop.21",
+    "@progress/kendo-angular-pdf-export": "19.3.0-develop.21",
+    "@progress/kendo-angular-popup": "19.3.0-develop.21",
+    "@progress/kendo-angular-toolbar": "19.3.0-develop.21",
+    "@progress/kendo-angular-utils": "19.3.0-develop.21",
     "rxjs": "^6.5.3 || ^7.0.0"
   },
   "dependencies": {
     "tslib": "^2.3.1",
-    "@progress/kendo-angular-schematics": "19.3.0-develop.2",
+    "@progress/kendo-angular-schematics": "19.3.0-develop.21",
     "@progress/kendo-common": "^1.0.1",
     "@progress/kendo-file-saver": "^1.0.0"
   },

package/rendering/cell.component.d.ts

@@ -2,7 +2,7 @@
 * Copyright © 2025 Progress Software Corporation. All rights reserved.
 * Licensed under commercial license. See LICENSE.md in the project root for more information
 *-------------------------------------------------------------------------------------------*/
-import { DoCheck, TemplateRef } from '@angular/core';
+import { DoCheck, TemplateRef, OnChanges, AfterContentChecked } from '@angular/core';
 import { EditService } from '../editing/edit.service';
 import { ColumnComponent } from '../columns/column.component';
 import { FormGroup } from '@angular/forms';
@@ -14,7 +14,7 @@ import * as i0 from "@angular/core";
 /**
  * @hidden
  */
-export declare class CellComponent implements DoCheck {
+export declare class CellComponent implements DoCheck, OnChanges, AfterContentChecked {
     private editService;
     private idService;
     private ctx;

package/rendering/table-body.component.d.ts

@@ -52,6 +52,7 @@ export declare class TableBodyComponent implements OnInit, OnDestroy, OnChanges,
         cells?: any[];
         isExpanded?: boolean;
         showDataItem?: boolean;
+        isHighlighted?: boolean;
     }>;
     skip: number;
     selectable: SelectableSettings | boolean;

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

@@ -0,0 +1,49 @@
+/**-----------------------------------------------------------------------------------------
+* Copyright © 2025 Progress Software Corporation. All rights reserved.
+* Licensed under commercial license. See LICENSE.md in the project root for more information
+*-------------------------------------------------------------------------------------------*/
+import { OnDestroy, AfterViewInit } from '@angular/core';
+import { AIPromptComponent, PromptOutput, PromptRequestEvent } from '@progress/kendo-angular-conversational-ui';
+import { HttpClient } from '@angular/common/http';
+import { ContextService } from './../../../../common/provider.service';
+import { ColumnInfoService } from './../../../../common/column-info.service';
+import { AIAssistantToolbarDirective } from './ai-tool.directive';
+import { GridToolbarAIPromptSettings, GridToolbarAIRequestOptions } from './utils';
+import * as i0 from "@angular/core";
+/**
+ * @hidden
+ */
+export declare class AiAssistantComponent implements OnDestroy, AfterViewInit {
+    private http;
+    private ctx;
+    private columnInfoService;
+    aiPrompt: AIPromptComponent;
+    activeView: number;
+    promptOutputs: Array<PromptOutput>;
+    requestUrl: string;
+    requestOptions: GridToolbarAIRequestOptions;
+    aiPromptSettings: GridToolbarAIPromptSettings;
+    aiToolDirective: AIAssistantToolbarDirective;
+    streaming: boolean;
+    disabledGenerateButton: boolean;
+    private lastMessage;
+    private requestData;
+    private currentRequestSubscription;
+    private loadingOutput;
+    private columns;
+    private idCounter;
+    constructor(http: HttpClient, ctx: ContextService, columnInfoService: ColumnInfoService);
+    ngAfterViewInit(): void;
+    ngOnDestroy(): void;
+    message(message: string): string;
+    cancelRequest(): void;
+    onPromptRequest(ev: PromptRequestEvent): void;
+    private sendPromptRequest;
+    private processResponse;
+    private handleError;
+    private unsubscribeCurrentRequest;
+    private processArrayResponse;
+    private processFilterResponse;
+    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-tool.directive.d.ts

@@ -0,0 +1,119 @@
+/**-----------------------------------------------------------------------------------------
+* Copyright © 2025 Progress Software Corporation. All rights reserved.
+* Licensed under commercial license. See LICENSE.md in the project root for more information
+*-------------------------------------------------------------------------------------------*/
+import { NgZone, AfterViewInit, OnInit, OnDestroy, ChangeDetectorRef, EventEmitter } from '@angular/core';
+import { RefreshService, ToolBarButtonComponent } from '@progress/kendo-angular-toolbar';
+import { SVGIcon } from '@progress/kendo-svg-icons';
+import { ContextService } from '../../../../common/provider.service';
+import { ToolbarToolBase } from '../../../../common/toolbar-tool-base.directive';
+import { WindowService } from '@progress/kendo-angular-dialog';
+import { HttpErrorResponse, HttpResponse } from '@angular/common/http';
+import { GridToolbarAIOpenEvent, GridToolbarAIPromptSettings, GridToolbarAIWindowSettings, GridToolbarAIRequestData, GridToolbarAIRequestResponse, GridToolbarAIRequestOptions } from './utils';
+import * as i0 from "@angular/core";
+/**
+ * Represents an AI Assistant tool of the Grid.
+ * Use this directive on any `kendo-toolbar-button` inside a ToolbarComponent in the Grid.
+ *
+ * @example
+ * ```html-no-run
+ * <kendo-grid>
+ *      <kendo-toolbar>
+ *         <kendo-toolbar-button kendoGridAIAssistantTool></kendo-toolbar-button>
+ *      </kendo-toolbar>
+ * </kendo-grid>
+ * ```
+ * @remarks
+ * Applied to: {@link ToolBarButtonComponent}.
+ */
+export declare class AIAssistantToolbarDirective extends ToolbarToolBase implements OnInit, AfterViewInit, OnDestroy {
+    private windowService;
+    host: ToolBarButtonComponent;
+    ctx: ContextService;
+    zone: NgZone;
+    private refresh;
+    /**
+     * The URL to which the AI Assistant tool sends the AI request.
+     * - When you set this property, the AI Assistant tool sends and handles an HTTP request to the provided `requestUrl`. You can handle the `promptRequest` event to modify the request options before the tool sends it.
+     * - When you do not set this property, the AI Assistant tool does not send an HTTP request. You should handle the `promptRequest` event to send and handle a custom HTTP request.
+     */
+    requestUrl?: string;
+    /**
+     * Configures the request options that the AI Assistant tool sends with the AI request.
+     *
+     * @default
+     * ```typescript
+     * {
+     *   headers: new HttpHeaders({ 'Content-Type': 'application/json' }),
+     *   role: 'user',
+     *   method: 'POST',
+     *   responseType: 'json',
+     *   withCredentials: false
+     * }
+     * ```
+     */
+    requestOptions?: GridToolbarAIRequestOptions;
+    /**
+     * Configures the settings for the AI Assistant Window.
+     */
+    aiWindowSettings: GridToolbarAIWindowSettings;
+    /**
+     * Configures the settings for the AI prompt component that the AI Assistant Window component uses.
+     */
+    aiPromptSettings: GridToolbarAIPromptSettings;
+    /**
+     * Emits an event before the AI Assistant tool sends the AI request.
+     *  - When you provide a `requestUrl`, you can handle the event to modify the request options.
+     *  - When you do not provide a `requestUrl`, you can handle the event to perform an entirely custom request.
+     */
+    promptRequest: EventEmitter<{
+        requestData: GridToolbarAIRequestData;
+        isRetry: boolean;
+    }>;
+    /**
+     * Emits an event when the user clicks the cancel button.
+     */
+    cancelRequest: EventEmitter<undefined>;
+    /**
+     * Emits an event when the AI Assistant tool completes the AI request successfully.
+     * The event contains the response from the AI service.
+     */
+    responseSuccess: EventEmitter<HttpResponse<GridToolbarAIRequestResponse>>;
+    /**
+     * Emits an event when the AI Assistant tool completes the AI request with an error.
+     * The event contains the response from the AI service.
+     */
+    responseError: EventEmitter<HttpErrorResponse>;
+    /**
+     * Emits an event when the AI Assistant tool closes.
+     */
+    close: EventEmitter<undefined>;
+    /**
+     * Emits an event when the AI Assistant tool opens.
+     * The event contains the window instance and the AI prompt instance.
+     */
+    open: EventEmitter<GridToolbarAIOpenEvent>;
+    tableWizardIcon: SVGIcon;
+    private windowRef;
+    private subs;
+    private actionSheetCloseSub;
+    private emitOpenClose;
+    private defaultAiPromptSettings;
+    constructor(windowService: WindowService, host: ToolBarButtonComponent, ctx: ContextService, zone: NgZone, refresh: RefreshService, cdr: ChangeDetectorRef);
+    ngOnInit(): void;
+    ngAfterViewInit(): void;
+    ngOnDestroy(): void;
+    /**
+     * @hidden
+     */
+    onClick(): void;
+    /**
+     * Toggles the AI Assistant window.
+     */
+    toggleWindow(): void;
+    private openWindow;
+    private closeWindow;
+    private get buttonElement();
+    static ɵfac: i0.ɵɵFactoryDeclaration<AIAssistantToolbarDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<AIAssistantToolbarDirective, "[kendoGridAIAssistantTool]", never, { "requestUrl": { "alias": "requestUrl"; "required": false; }; "requestOptions": { "alias": "requestOptions"; "required": false; }; "aiWindowSettings": { "alias": "aiWindowSettings"; "required": false; }; "aiPromptSettings": { "alias": "aiPromptSettings"; "required": false; }; }, { "promptRequest": "promptRequest"; "cancelRequest": "cancelRequest"; "responseSuccess": "responseSuccess"; "responseError": "responseError"; "close": "close"; "open": "open"; }, never, never, true, never>;
+}

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

@@ -0,0 +1,110 @@
+/**-----------------------------------------------------------------------------------------
+* Copyright © 2025 Progress Software Corporation. All rights reserved.
+* Licensed under commercial license. See LICENSE.md in the project root for more information
+*-------------------------------------------------------------------------------------------*/
+import { HttpHeaders } from "@angular/common/http";
+import { AIPromptComponent, AIPromptSettings } from "@progress/kendo-angular-conversational-ui";
+import { WindowComponent, WindowSettings } from "@progress/kendo-angular-dialog";
+import { CompositeFilterDescriptor, FilterDescriptor, GroupDescriptor, SortDescriptor } from "@progress/kendo-data-query";
+/**
+ * Interface representing all configuration options of the Ai Assistant Window.
+ */
+export interface GridToolbarAIWindowSettings extends Omit<WindowSettings, 'content'> {
+}
+/**
+ * Interface representing all configuration options of the Ai Assistant Prompt.
+ */
+export interface GridToolbarAIPromptSettings extends Omit<AIPromptSettings, 'promptCommands'> {
+}
+/**
+ * Represents the event data when the AI Assistant window is opened.
+ */
+export interface GridToolbarAIOpenEvent {
+    aiWindow: WindowComponent;
+    aiPrompt: AIPromptComponent;
+}
+/**
+ * Represents the data sent in the AI request from the Grid Toolbar AI Assistant.
+ */
+export interface GridToolbarAIRequestData {
+    columns: Array<{
+        field: string;
+        title: string;
+    }>;
+    promptMessage: string;
+    url?: string;
+    requestOptions: {
+        role?: string;
+        headers?: HttpHeaders;
+        method?: string;
+        withCredentials?: boolean;
+        body?: any;
+        responseType?: 'json' | 'arraybuffer' | 'blob' | 'text';
+        [key: string]: any;
+    };
+}
+/**
+ * Represents the response from the AI request in the Grid Toolbar AI Assistant.
+ */
+export interface GridToolbarAIRequestResponse {
+    messages: string[];
+    sort?: SortDescriptor[];
+    filter?: CompositeFilterDescriptor;
+    group?: GroupDescriptor[];
+    highlight?: {
+        cells: {
+            [key: string]: boolean;
+        };
+        filters: FilterDescriptor[];
+        logic: 'and' | 'or';
+    }[];
+}
+/**
+ * Configuration options for the HTTP request.
+ */
+export interface GridToolbarAIRequestOptions {
+    /**
+     * HTTP headers to include with the request.
+     */
+    headers?: HttpHeaders;
+    /**
+     * The role of the user making the request, e.g., 'user', 'assistant'.
+     * @default 'user'
+     */
+    role?: string;
+    /**
+     * HTTP method to use for the request.
+     * @default 'POST'
+     */
+    method?: string;
+    /**
+     * Whether to include credentials (cookies, authorization headers) with the request.
+     * @default false
+     */
+    withCredentials?: boolean;
+    /**
+     * The expected response type.
+     * @default 'json'
+     */
+    responseType?: 'json' | 'arraybuffer' | 'blob' | 'text';
+    /**
+     * The body of the request.
+     */
+    body?: any;
+    /**
+     * Additional custom options that will be spread into the request configuration.
+     */
+    [key: string]: any;
+}
+/**
+ * @hidden
+ */
+export declare const DEFAULT_AI_REQUEST_OPTIONS: GridToolbarAIRequestOptions;
+/**
+ * @hidden
+ */
+export declare const convertDateStringsInFilter: (filter: any, columns: any[]) => any;
+/**
+ * @hidden
+ */
+export declare const isDateField: (fieldName: string, columns: any[]) => boolean;

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.3.0-develop.2',
-            '@progress/kendo-angular-navigation': '19.3.0-develop.2',
+            '@progress/kendo-angular-treeview': '19.3.0-develop.21',
+            '@progress/kendo-angular-navigation': '19.3.0-develop.21',
             // peer dependency of kendo-angular-inputs
-            '@progress/kendo-angular-dialog': '19.3.0-develop.2',
+            '@progress/kendo-angular-dialog': '19.3.0-develop.21',
             // peer dependency of kendo-angular-icons
             '@progress/kendo-svg-icons': '^4.0.0',
             // peer dependency of kendo-angular-layout
-            '@progress/kendo-angular-progressbar': '19.3.0-develop.2'
+            '@progress/kendo-angular-progressbar': '19.3.0-develop.21'
         } });
     return (0, schematics_1.externalSchematic)('@progress/kendo-angular-schematics', 'ng-add', finalOptions);
 }

package/selection/pair-set.d.ts

@@ -5,46 +5,74 @@
 /**
  * @hidden
  *
- * Quick look-up structure for combinations of keys.
- * Similar to the native JS Set, however, working with a couple of keys instead of with a single key.
+ * Quick look-up structure for combinations of keys or single keys.
+ * Similar to the native JS Set, however, working with single keys or a couple of keys.
  * Supports both primitive keys and object keys (compared by reference).
  */
 export declare class PairSet {
     /**
-     * Gets the total number of X/Y key pairs.
+     * Symbol used internally to represent "no Y key" when storing single X keys.
+     */
+    private static readonly SINGLE_KEY_SYMBOL;
+    /**
+     * Gets the total number of key entries (both single keys and key pairs).
      */
     get size(): number;
     /**
      * Holds a set of Y keys for each defined X key.
      * Each X key creates a map which holds a set of Y keys.
+     * For single keys, the Y value is the SINGLE_KEY_SYMBOL.
      *
-     * Map { 1 => Set { 1, 2, 3 } } // pairs: [1, 1], [1, 2], [1, 3]
+     * Map { 'foo' => Set { Symbol(SINGLE_KEY) } } // single key: {x: 'foo'}
+     * Map { 'foo2' => Set { 'bar', 'baz' } } // pairs: {x: 'foo2', y: 'bar'}, {x: 'foo2', y: 'baz'}
      */
     private keysX;
     /**
-     * Count the each added or deleted key manually to avoid iterating over all items when calling `this.size`.
+     * Count each added or deleted key manually to avoid iterating over all items when calling `this.size`.
      */
     private totalKeysCount;
     constructor(items?: any[], keyXField?: string, keyYField?: string);
+    /**
+     * Adds a single key entry.
+     */
+    addSingle(keyX: any): void;
     /**
      * Adds a couple of items identified as a combination.
      */
     add(keyX: any, keyY: any): void;
     /**
-     * Adds a combination of a couple of items identified together.
+     * Deletes a single key entry.
+     */
+    deleteSingle(keyX: any): void;
+    /**
+     * Deletes a combination of a couple of items identified together.
      */
     delete(keyX: any, keyY: any): void;
+    /**
+     * Checks whether a single key is stored.
+     */
+    hasSingle(keyX: any): boolean;
     /**
      * Checks whether the defined combination is stored.
      */
     has(keyX: any, keyY: any): boolean;
     /**
-     * Clears all key combinations.
+     * Checks whether any entry exists for the given X key (single or paired).
+     */
+    hasX(keyX: any): boolean;
+    /**
+     * Gets all Y keys for a given X key, excluding single key entries.
+     */
+    getYKeys(keyX: any): any[];
+    /**
+     * Clears all key combinations and single keys.
      */
     clear(): void;
     /**
      * Converts the persisted data structure to an array of objects,
      * using the provided field names for the object props.
+     * Single keys will only have the keyXField property.
+     * Pair keys will have both keyXField and keyYField properties.
      */
-    toArray(keyXField: string, keyYField: string): any[];
+    toArray(keyXField: string, keyYField?: string): any[];
 }

package/utils.d.ts

@@ -83,10 +83,6 @@ export declare const cancelAnimationFrame: any;
  * @hidden
  */
 export declare const nodesToArray: (nodes: NodeList) => HTMLElement[];
-/**
- * @hidden
- */
-export declare const replaceMessagePlaceholder: (message: string, name: string, value: string) => string;
 /**
  * @hidden
  */