@progress/kendo-angular-grid 19.1.2-develop.3 → 19.1.2-develop.5

package/columns/span-column.component.d.ts

@@ -14,20 +14,20 @@ import * as i0 from "@angular/core";
  */
 export declare function isSpanColumnComponent(column: any): column is SpanColumnComponent;
 /**
- * Represents a column which can be spanned over multiple data cells while the individual
- * header and footer cells are retained ([see example]({% slug spanned_columns_grid %})).
- * Enables you to achieve more flexible layout while keeping the built-in UI element for
+ * Represents a column that spans multiple data cells while keeping the individual
+ * header and footer cells ([see example]({% slug spanned_columns_grid %})).
+ * Use this column to create flexible layouts and keep built-in UI for
  * [sorting]({% slug sorting_grid %}), [filtering]({% slug filtering_grid %}), and
- * [grouping]({% slug grouping_grid %}). Wrap the columns that will be
- * merged inside the `<kendo-grid-span-column>` tag.
+ * [grouping]({% slug grouping_grid %}). Wrap the columns you want to merge inside the `<kendo-grid-span-column>` tag.
  *
+ * @example
  * ```html
  * <kendo-grid-span-column>
- *   <kendo-grid-column field="field1"></kendo-grid-column>
- *   <kendo-grid-column field="field2"></kendo-grid-column>
+ *   <kendo-grid-column field="ID"></kendo-grid-column>
+ *   <kendo-grid-column field="Name"></kendo-grid-column>
  *   <ng-template kendoGridCellTemplate let-dataItem>
- *     <h5>{{ dataItem.field1 }}</h5>
- *     <p>{{ dataItem.field2 }}</p>
+ *     <p>{{ dataItem.ID }}</p>
+ *     <p>{{ dataItem.Name }}</p>
  *   </ng-template>
  * </kendo-grid-span-column>
  * ```
@@ -73,8 +73,8 @@ export declare class SpanColumnComponent extends ColumnBase {
      */
     includeInChooser: boolean;
     /**
-     * Defines whether the edit template of the column will be rendered.
-     * To enable the editing functionality for a spanned column, set an edit template for it ([see example](slug:custom_reactive_editing_grid)).
+     * Sets whether the edit template of the column is rendered.
+     * To enable editing for a spanned column, set an edit template for it ([see example](slug:custom_reactive_editing_grid)).
      * @default false
      */
     set editable(value: boolean);

package/common/adaptiveness.service.d.ts

@@ -23,7 +23,7 @@ export declare class AdaptiveGridService {
     private ctx;
     private adaptiveService;
     /**
-     * Observable that emits when the ActionSheet's views change animation ends.
+     * Emits when the ActionSheet view animation ends.
      */
     get animationEnd(): Observable<void>;
     columnMenuService: ColumnMenuService;
@@ -40,7 +40,7 @@ export declare class AdaptiveGridService {
     resetFilter(): void;
     reset(): void;
     /**
-     * Emits an event to notify that the animation has ended.
+     * Notifies that the ActionSheet animation has ended.
      */
     notifyAnimationEnd(): void;
     get windowSize(): AdaptiveSize;

package/common/cell-click-event-args.interface.d.ts

@@ -4,7 +4,9 @@
 *-------------------------------------------------------------------------------------------*/
 import { GridComponent } from "../grid.component";
 /**
- * Arguments for the [`cellClick`](slug:api_grid_gridcomponent#toc-cellclick) event ([see example](slug:editing_incell_grid)).
+ * Provides arguments for the [`cellClick`](slug:api_grid_gridcomponent#toc-cellclick) event.
+ * Use this event to get details about the clicked cell in the Grid.
+ *
  */
 export interface CellClickEvent {
     /**
@@ -16,19 +18,19 @@ export interface CellClickEvent {
      */
     columnIndex: number;
     /**
-     * The data item that is associated with the row in which the clicked cell is located.
+     * The data item for the row containing the clicked cell.
      */
     dataItem: any;
     /**
-     * Indicates if the cell is being edited.
+     * Indicates if the cell is in edit mode.
      */
     isEdited: boolean;
     /**
-     * The DOM event that triggered the `cellClick` event.
+     * The original DOM event that triggered the cell click.
      */
     originalEvent: any;
     /**
-     * The row index for the operation.
+     * The row index of the clicked cell.
      */
     rowIndex: number;
     /**
@@ -36,7 +38,7 @@ export interface CellClickEvent {
      */
     sender: GridComponent;
     /**
-     * The type of the event that triggered the `cellClick` event.
+     * The type of event that triggered the cell click.
      */
     type: 'click' | 'contextmenu';
 }

package/common/clipboard-types.d.ts

@@ -3,100 +3,96 @@
 * Licensed under commercial license. See LICENSE.md in the project root for more information
 *-------------------------------------------------------------------------------------------*/
 /**
- * Represents the starting point (Grid cell) of the Grid clipboard operations.
+ * Specifies the starting point (Grid cell) for clipboard operations.
  */
 export type GridClipboardTargetType = 'selection' | 'activeCell';
 /**
- * The possible values of the Grid [`GridClipboardEvent`]({% slug api_grid_gridclipboardevent %}) `type` property.
+ * Defines the possible values for the `type` property of [`GridClipboardEvent`]({% slug api_grid_gridclipboardevent %}).
  */
 export type GridClipboardEventType = 'copy' | 'cut' | 'paste';
 /**
- * The Grid data items and their respective fields, affected by the current clipboard operation.
+ * Represents a Grid data item and its affected fields during a clipboard operation.
  */
 export interface GridClipboardItem {
+    /**
+     * The data item affected by the clipboard action.
+     */
     dataItem: any;
+    /**
+     * The fields of the data item affected by the clipboard action.
+     */
     fields: string[];
 }
 /**
- * The event data, exposed in the `GridClipboardDirective` `clipboard` event.
+ * Provides event data for the `clipboard` event of the `GridClipboardDirective`.
  */
 export interface GridClipboardEvent {
     /**
-     * The type of the original clipboard event.
+     * The type of the clipboard event.
      */
     type: GridClipboardEventType;
     /**
-     * The data of the original DOM event.
+     * The original DOM clipboard event.
      */
     originalEvent: ClipboardEvent;
     /**
-     * When the action is `copy` or `cut` - the Grid data, copied to the clipboard, in Excel-compatible format.
-     * When the action is `paste` - the current clipboard data, available in the original DOM event.
+     * The clipboard data as a string.
+     * When the action is `copy` or `cut`—contains the grid data copied to the clipboard, formatted for Excel compatibility..
+     * When the action is `paste`—contains the raw clipboard data extracted from the original DOM event.
      */
     clipboardData: string;
     /**
-     * The Grid data items and their respective fields, affected by the clipboard action.
+     * The affected Grid data items and fields.
      */
     gridData: GridClipboardItem[];
     /**
-     * The Grid cell used as a target of the current clipboard operation.
+     * The target cell for the clipboard operation.
      */
     target: GridClipboardTargetCell;
 }
 /**
- *
+ * Describes the target cell for a clipboard operation.
  */
 export interface GridClipboardTargetCell {
     /**
-     * The data index of the clipboard target cell parent row.
+     * The data row index of the target cell.
      */
     dataRowIndex: number;
     /**
-     * The field of the Grid column the clipboard target cell is in.
+     * The field of the column for the target cell.
      */
     colField: string;
     /**
-     * The Grid data item corresponding to the clipboard target cell.
+     * The data item for the target cell.
      */
     dataItem: any;
 }
 /**
- * The `GridClipboardDirective` settings.
+ * Configures the `GridClipboardDirective` settings.
  */
 export interface GridClipboardSettings {
     /**
-     * Determines whether the clipboard actions will affect the whole data row
-     * when it is either partially selected, or contains the active cell.
-     *
-     * Defaults to `false`.
+     * If set to `true`, clipboard actions affect the whole data row.
      */
     wholeRow?: boolean;
     /**
-     * Determines whether column titles or field names will be included in the generated data
-     * during the `copy` and `cut` actions.
+     * If set to `true`, includes column titles or field names in the clipboard data.
      *
-     * Defaults to `false`.
      */
     copyHeaders?: boolean;
     /**
-     * Determines whether the `copy` operation will modify the Clipboard content
-     * and trigger the `clipboard` event.
+     * If set to `true`, enables the `copy` operation.
      *
-     * Defaults to `true`.
      */
     copy?: boolean;
     /**
-     * Determines whether the `cut` operation will modify the Clipboard content
-     * and trigger the `clipboard` event.
+     * If set to `true`, enables the `cut` operation.
      *
-     * Defaults to `true`.
      */
     cut?: boolean;
     /**
-     * Determines whether the `paste` operation will modify the Clipboard content
-     * and trigger the `clipboard` event.
+     * If set to `true`, enables the `paste` operation.
      *
-     * Defaults to `true`.
      */
     paste?: boolean;
 }

package/common/clipboard.directive.d.ts

@@ -8,8 +8,14 @@ import { GridComponent } from '../grid.component';
 import { GridClipboardTargetType, GridClipboardEvent, GridClipboardSettings } from './clipboard-types';
 import * as i0 from "@angular/core";
 /**
- * The directive that enables the Grid built-in clipboard support. Allows copy, cut, and paste interactions
- * with the Grid.
+ * Enables built-in clipboard support for the Grid. Allows copy, cut, and paste interactions.
+ *
+ * @example
+ * ```html
+ * <kendo-grid kendoGridClipboard></kendo-grid>
+ * ```
+ * @remarks
+ * Applied to: {@link GridComponent}.
  */
 export declare class GridClipboardDirective implements AfterViewInit, OnDestroy {
     private host;
@@ -17,23 +23,21 @@ export declare class GridClipboardDirective implements AfterViewInit, OnDestroy
     private renderer;
     private zone;
     /**
-     * Determines the target of the clipboard operation ([see example]({% slug clipboard_grid %}#toc-clipboard-target)). The possible options are:
-     * - `activeCell`
-     * - `selection`
+     * Sets the clipboard operation target. Possible values are `'activeCell'` and `'selection'`.([See example]({% slug clipboard_grid %}#toc-clipboard-target))
      *
      * @default 'selection'
      */
     set clipboardTarget(value: GridClipboardTargetType);
     get clipboardTarget(): GridClipboardTargetType;
     /**
-     * The `GridClipboardDirective` settings.
+     * Configures the clipboard directive settings.
      *
-     * @default { wholeRow: false, copyHeaders: false copy: true, cut: true, paste: true }
+     * @default { wholeRow: false, copyHeaders: false, copy: true, cut: true, paste: true }
      */
     set clipboardSettings(value: GridClipboardSettings);
     get clipboardSettings(): GridClipboardSettings;
     /**
-     * Fires when the user performs `cut`, `copy` or `paste` action within the Grid content area.
+     * Fires when a clipboard action (`cut`, `copy`, or `paste`) occurs in the Grid.
      */
     clipboard: EventEmitter<GridClipboardEvent>;
     private _target;

package/common/create-form-group.d.ts

@@ -5,6 +5,8 @@
 import { FormGroup } from "@angular/forms";
 import { CreateFormGroupArgs } from "../editing-directives/create-form-group-args.interface";
 /**
- * The function that creates the `FormGroup` for the edited model.
+ * Defines a function that creates a `FormGroup` for the edited model.
+ * @param args The arguments for creating the form group.
+ * @returns The created `FormGroup`.
  */
 export type CreateFormGroup = (args: CreateFormGroupArgs) => FormGroup;

package/common/fetch-data-callback.d.ts

@@ -6,7 +6,9 @@ import { ExcelExportData } from "@progress/kendo-angular-excel-export";
 import { Observable } from "rxjs";
 import { GridComponent } from "../grid.component";
 /**
- * The function that is used to get the exported data options. By default, uses the current data and group of the Grid.
- * To export data that is different from the current Grid data, provide a custom function. [See example](slug:excelexport_grid#toc-exporting-specific-data)
+ * Defines a function that returns the exported data options for the Grid.
+ * Use this callback to provide custom data for export. [See example](slug:excelexport_grid#toc-exporting-specific-data).
+ * @param component The Grid component.
+ * @returns The exported data.
  */
 export type FetchDataCallback = (component: GridComponent) => ExcelExportData | Promise<ExcelExportData> | Observable<ExcelExportData>;

package/common/field-datatype.d.ts

@@ -3,7 +3,7 @@
 * Licensed under commercial license. See LICENSE.md in the project root for more information
 *-------------------------------------------------------------------------------------------*/
 /**
- * The data type of the field, associated with a Grid column.
- * Used to determine the built-in editing and filtering UI for the supported most frequently used data types.
+ * Specifies the data type of a field for a Grid column.
+ * Use this type to determine the editing and filtering UI.
  */
 export type FieldDataType = 'text' | 'numeric' | 'date' | 'boolean';

package/common/pager-settings.d.ts

@@ -3,28 +3,27 @@
 * Licensed under commercial license. See LICENSE.md in the project root for more information
 *-------------------------------------------------------------------------------------------*/
 /**
- * The type of the Grid pager.
+ * Defines the type of the Grid pager.
  *
  * The available values are:
- * * `numeric`—Buttons with numbers.
- * * `input`—Input for typing the page number.
+ * * `numeric`—Shows buttons with numbers.
+ * * `input`—Shows an input for typing the page number.
  *
  * @example
  * ```html
  * <kendo-grid [pageable]="{ type: 'numeric' }">
  *   <kendo-grid-column field="ProductID"></kendo-grid-column>
- *   ...
  * </kendo-grid>
  * ```
  */
 export type PagerType = 'numeric' | 'input';
 /**
- * The position of the Grid pager.
+ * Sets the position of the Grid pager.
  *
  * The available values are:
- * * `top`&mdash;The pager is rendered above the Grid headers.
- * * `bottom`&mdash;(Default) The pager is rendered below the data table.
- * * `both`&mdash;Two pagers are rendered - one above the Grid headers, and one - below the data table.
+ * * `top`&mdash;Renders the pager above the Grid headers.
+ * * `bottom`&mdash;(Default) Renders the pager below the data table.
+ * * `both`&mdash;Renders two pagers: one above the Grid headers and one below the data table.
  *
  * @example
  * ```html
@@ -36,19 +35,32 @@ export type PagerType = 'numeric' | 'input';
  */
 export type PagerPosition = 'top' | 'bottom' | 'both';
 /**
- * The pager settings of the Grid ([see example](slug:paging_grid_settings)).
+ * Configures the pager settings of the Grid ([see example](slug:paging_grid_settings)).
+ *
+ * @example
+ * ```typescript
+ * public pagerSettings: PagerSettings = {
+ *   buttonCount: 5,
+ *   info: true,
+ *   type: 'numeric',
+ *   pageSizes: [5, 10, 20],
+ *   previousNext: true,
+ *   responsive: true,
+ *   position: 'bottom'
+ * };
+ * ```
  */
 export interface PagerSettings {
     /**
-     * Sets the maximum numeric buttons count before the buttons are collapsed.
+     * Sets the maximum number of numeric buttons before collapsing them.
      */
     buttonCount?: number;
     /**
-     * Toggles the information about the current page and the total number of records.
+     * Shows information about the current page and the total number of records.
      */
     info?: boolean;
     /**
-     * Defines the type of the Grid pager.
+     * Sets the type of the Grid pager.
      */
     type?: PagerType;
     /**
@@ -56,30 +68,34 @@ export interface PagerSettings {
      */
     pageSizes?: boolean | Array<number>;
     /**
-     * Toggles the **Previous** and **Next** buttons.
+     * Shows the **Previous** and **Next** buttons.
      */
     previousNext?: boolean;
     /**
-     * Toggles the built-in responsive behavior of the Pager.
-     * Available in version `5.0.0` and above ([see example](slug:paging_grid_settings)).
+     * Enables the built-in responsive behavior of the Pager.
      */
     responsive?: boolean;
     /**
-     * Defines the Pager position relative to the Grid data table.
-     * The possible values are 'top', 'bottom', and 'both' ([see example](slug:paging_grid_settings)).
+     * Sets the Pager position relative to the Grid data table.
+     * The possible values are `'top'`, `'bottom'`, and `'both'` ([see example](slug:paging_grid_settings)).
      */
     position?: PagerPosition;
 }
 /**
- * The interface of the `PageSizeItem` options of the `PagerPageSizesComponent`.
+ * Describes the `PageSizeItem` options for the `PagerPageSizesComponent`.
+ *
+ * @example
+ * ```typescript
+ * const pageSizeItem: PageSizeItem = { text: 'Show All', value: 'all' };
+ * ```
  */
 export interface PageSizeItem {
     /**
-     * The text that will be displayed for each option in the pager's PageSize selector.
+     * Sets the text for each option in the pager's PageSize selector.
      */
     text: string;
     /**
-     * The value used as the page size. When set to `all`, the page size will be set to match the Grid data `total`.
+     * Sets the value used as the page size. If set to `'all'`, the page size matches the Grid data `total`.
      */
     value: number | 'all';
 }

package/common/preventable-event.d.ts

@@ -9,16 +9,12 @@ export declare abstract class PreventableEvent {
     private prevented;
     /**
      * Prevents the default action for a specified event.
-     * In this way, the source component suppresses
-     * the built-in behavior that follows the event.
+     * In this way, the source component suppresses the built-in behavior that follows the event.
      */
     preventDefault(): void;
     /**
-     * Returns a respective boolean if the event was prevented
-     * by any of its subscribers.
-     *
-     * @returns `true` if the default action was prevented.
-     * Otherwise, returns `false`.
+     * Returns whether the default action for a specified event was prevented.
+     * @returns `true` if the default action was prevented. Otherwise, returns `false`.
      */
     isDefaultPrevented(): boolean;
 }

package/common/remove-confirmation.d.ts

@@ -5,5 +5,17 @@
 import { Observable } from "rxjs";
 /**
  * A function that is called to confirm if the `dataItem` will be removed.
+ *
+ * @example
+ * ```html
+ * <kendo-grid [kendoGridTemplateEditing]="createNewProduct" [removeConfirmation]="confirmRemove" >
+ *   <kendo-grid-column field="name" title="Name"></kendo-grid-column>
+ * </kendo-grid>
+ * ```
+ * ```typescript
+ * confirmRemove(dataItem: any): boolean {
+ *   // Return a boolean, Promise, or Observable indicating if the item should be removed.
+ * }
+ * ```
  */
 export type RemoveConfirmationCallback = (dataItem: any) => Promise<boolean> | Observable<boolean> | boolean;

package/common/resizable-settings.d.ts

@@ -3,23 +3,24 @@
 * Licensed under commercial license. See LICENSE.md in the project root for more information
 *-------------------------------------------------------------------------------------------*/
 /**
- * The size restrictions that will be applied to the resizable Grid.
+ * Configures size restrictions for a resizable Grid.
+ * Use this interface to set min and max width and height for the Grid.
  */
 export interface GridResizableSettings {
     /**
-     * Specifies the maximum width of the resizable Grid. Accepts all applicable string values for [`max-width`](https://developer.mozilla.org/en-US/docs/Web/CSS/max-width).
+     * Sets the maximum width of the resizable Grid. Accepts all valid CSS [`max-width`](https://developer.mozilla.org/en-US/docs/Web/CSS/max-width) values.
      */
     maxWidth?: string;
     /**
-     * Specifies the maximum height of the resizable Grid. Accepts all applicable string values for [`max-height`](https://developer.mozilla.org/en-US/docs/Web/CSS/max-height).
+     * Sets the maximum height of the resizable Grid. Accepts all valid CSS [`max-height`](https://developer.mozilla.org/en-US/docs/Web/CSS/max-height) values.
      */
     maxHeight?: string;
     /**
-     * Specifies the minimum width of the resizable Grid. Accepts all applicable string values for [`min-width`](https://developer.mozilla.org/en-US/docs/Web/CSS/min-width).
+     * Sets the minimum width of the resizable Grid. Accepts all valid CSS [`min-width`](https://developer.mozilla.org/en-US/docs/Web/CSS/min-width) values.
      */
     minWidth?: string;
     /**
-     * Specifies the minimum height of the resizable Grid. Accepts all applicable string values for [`min-height`](https://developer.mozilla.org/en-US/docs/Web/CSS/min-height).
+     * Sets the minimum height of the resizable Grid. Accepts all valid CSS [`min-height`](https://developer.mozilla.org/en-US/docs/Web/CSS/min-height) values.
      */
     minHeight?: string;
 }

package/common/single-popup.service.d.ts

@@ -18,11 +18,14 @@ export declare class PopupCloseEvent extends PreventableEvent {
      * The original DOM event that causes the popup to close.
      */
     originalEvent: any;
+    /**
+     * @hidden
+     */
     constructor(e: any);
 }
 /**
- * The service that is used for the popups of the filter and column menus
- * ([see example]({% slug filter_menu %}#toc-filter-menu-with-popup)).
+ * Provides popup management for filter and column menus.
+ * Use this service to open and close popups for the Grid filter and column menus ([see example]({% slug filter_menu %}#toc-filter-menu-with-popup)).
  */
 export declare class SinglePopupService implements OnDestroy {
     private popupService;
@@ -31,8 +34,8 @@ export declare class SinglePopupService implements OnDestroy {
     private ctx;
     private adaptiveGridService;
     /**
-     * Fires when the filter or column menus are about to close because the user clicked outside their popups.
-     * Used to prevent the popup from closing.
+     * Emits when the filter or column menu popup is about to close because the user clicked outside.
+     * Use this event to prevent the popup from closing.
      */
     readonly onClose: Subject<PopupCloseEvent>;
     private removeClick;

package/common/size-options.d.ts

@@ -3,6 +3,7 @@
 * Licensed under commercial license. See LICENSE.md in the project root for more information
 *-------------------------------------------------------------------------------------------*/
 /**
- * Represents the possible size options of the Grid. [See example](slug:sizing_grid).
+ * Specifies the size options for the Grid.
+ * Use this type to set the Grid size.
  */
 export type GridSize = 'small' | 'medium' | 'none';

package/data/change-event-args.interface.d.ts

@@ -4,7 +4,7 @@
 *-------------------------------------------------------------------------------------------*/
 import { SortDescriptor, GroupDescriptor, CompositeFilterDescriptor } from '@progress/kendo-data-query';
 /**
- * Arguments for the `pageChange` event. [See example](slug:manual_paging_grid#toc-paging-local-data).
+ * Provides the arguments for the `pageChange` event. [See example](slug:manual_paging_grid#toc-paging-local-data).
  */
 export interface PageChangeEvent {
     /**
@@ -17,28 +17,28 @@ export interface PageChangeEvent {
     take: number;
 }
 /**
- * Arguments for the `dataStateChange` event
+ * Provides the arguments for the `dataStateChange` event
  * ([more information and examples](slug:data_operations_grid#toc-handling-multiple-data-operations)).
  */
 export interface DataStateChangeEvent {
     /**
-     * The number of records to skip.
+     * Sets how many records to skip.
      */
     skip: number;
     /**
-     * The number of records to take.
+     * Sets how many records to take.
      */
     take: number;
     /**
-     * The sort descriptors by which the data is sorted.
+     * Defines the sort descriptors for sorting the data.
      */
     sort?: Array<SortDescriptor>;
     /**
-     * The group descriptors by which the data is grouped.
+     * Defines the group descriptors for grouping the data.
      */
     group?: Array<GroupDescriptor>;
     /**
-     * The filter descriptor by which the data is filtered.
+     * Defines the filter descriptor for filtering the data.
      */
     filter?: CompositeFilterDescriptor;
 }

package/data/data-item.interface.d.ts

@@ -8,27 +8,27 @@ import { GroupItem } from './group-item.interface';
  */
 export interface DataItem {
     /**
-     * The type of the grid item.
+     * Sets the type of the grid item.
      */
     type: 'data';
     /**
-     * A reference to the data item.
+     * Holds a reference to the data item.
      */
     data: Object;
     /**
-     * The index of the grid item. Note that this could be different than the index of the data item in the source data set.
+     * Sets the index of the grid item. This index may differ from the index in the source data set.
      */
     index: number;
     /**
-     * The group index, if any.
+     * Sets the group index, if available.
      */
     groupIndex: string;
     /**
-     * A flag indicating if the item is currently being edited
+     * Indicates if the item is currently being edited.
      */
     isEditing: boolean;
     /**
-     * The current data item group.
+     * Holds the current data item group.
      */
     group: GroupItem;
 }

package/data/data.collection.d.ts

@@ -4,7 +4,7 @@
 *-------------------------------------------------------------------------------------------*/
 import { DataResult } from '@progress/kendo-data-query';
 /**
- * The data type that is expected by the Grid. [See example](slug:local_data_grid#toc-binding-to-a-griddataresult-object).
+ * Describes the data type that the Grid expects. [See example](slug:local_data_grid#toc-binding-to-a-griddataresult-object).
  */
 export interface GridDataResult extends DataResult {
 }

package/data/grid-item.interface.d.ts

@@ -6,7 +6,7 @@ import { DataItem } from './data-item.interface';
 import { GroupItem } from './group-item.interface';
 import { GroupFooterItem } from './group-footer-item.interface';
 /**
- * Represents the item by which the Grid tracks changes. [See example](slug:track_changes_grid).
+ * Represents the item that the Grid uses to track changes. [See example](slug:track_changes_grid).
  *
  * The possible values are:
  * * [`DataItem`]({% slug api_grid_dataitem %}).