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

package/grid.component.d.ts

@@ -90,10 +90,37 @@ import * as i0 from "@angular/core";
 /**
  * Represents the Kendo UI for Angular Data Grid component.
  *
+ * Use the `kendo-grid` component to display and manage tabular data.
+ *
  * @example
  * ```html
  * <kendo-grid [data]="gridData"></kendo-grid>
  * ```
+ *
+ * @remarks
+ * Supported children components are:
+ * {@link CheckboxColumnComponent},
+ * {@link ColumnChooserComponent},
+ * {@link ColumnComponent},
+ * {@link ColumnGroupComponent},
+ * {@link ColumnMenuAutoSizeAllColumnsComponent},
+ * {@link ColumnMenuAutoSizeColumnComponent},
+ * {@link ColumnMenuChooserComponent},
+ * {@link ColumnMenuComponent},
+ * {@link ColumnMenuFilterComponent},
+ * {@link ColumnMenuItemComponent},
+ * {@link ColumnMenuLockComponent},
+ * {@link ColumnMenuPositionComponent},
+ * {@link ColumnMenuSortComponent},
+ * {@link ColumnMenuStickComponent},
+ * {@link CommandColumnComponent},
+ * {@link CustomMessagesComponent},
+ * {@link ExcelComponent},
+ * {@link GridSpacerComponent},
+ * {@link PDFComponent},
+ * {@link RowReorderColumnComponent},
+ * {@link SpanColumnComponent},
+ * {@link ToolBarComponent}.
  */
 export declare class GridComponent implements AfterContentInit, AfterViewInit, OnDestroy, OnChanges, OnInit {
     private supportService;
@@ -127,7 +154,7 @@ export declare class GridComponent implements AfterContentInit, AfterViewInit, O
     adaptiveGridService: AdaptiveGridService;
     rowReorderService: RowReorderService;
     /**
-     * Sets the data of the Grid. If an array is provided, the Grid automatically gets the total count
+     * 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 %})).
      */
     set data(value: Array<any> | GridDataResult | null);
@@ -143,56 +170,59 @@ export declare class GridComponent implements AfterContentInit, AfterViewInit, O
     get hintContext(): any;
     /**
      * Defines the page size used by the Grid pager.
-     * Required by the [paging]({% slug paging_grid %}) functionality.
+     * Required for the [`paging`]({% slug paging_grid %}) feature.
      */
     pageSize: number | null | undefined;
     /**
-     * Defines the height (in pixels) that is used when the `scrollable` option of the Grid is set.
-     * To set the height of the Grid, you can also use `style.height`. The `style.height`
-     * option supports units such as `px`, `%`, `em`, `rem`, and others.
+     * Defines the height in pixels for the Grid when `scrollable` is set.
+     * You can also set the height using `style.height` with units like `px`, `%`, `em`, or `rem`.
      */
     height: number;
     /**
-     * Represent the actual height of each Grid row (`tr`) element in the DOM.
-     * Required by the [virtual scrolling functionality]({% slug scrollmmodes_grid %}).
-     * Set the `rowHeight` option to the exact pixels as the height of the `tr` element appears in the DOM.
+     * Represents the row height in pixels for each Grid row (`tr`) element.
+     * Required for [virtual scrolling]({% slug scrollmmodes_grid %}).
+     * Set `rowHeight` to match the actual DOM row height. The property does not change the height of the rows in the UI.
      */
     rowHeight: number;
     /**
-     * Enables or disables the adaptive mode. By default, adaptive rendering is disabled.
+     * Enables or disables adaptive mode. Adaptive rendering is off by default.
+     *
+     * @default 'none'
      */
     adaptiveMode: AdaptiveMode;
     /**
-     * Represent the actual height of each Grid detail row (`tr`) element in the DOM.
-     * Required by the [virtual scrolling functionality]({% slug scrollmmodes_grid %}).
-     * Set the `detailRowHeight` option to the exact pixels as the height of the detail Grid `tr` element appears in the DOM.
+     * Represents the height in pixels for each Grid detail row (`tr`) element.
+     * Required for [virtual scrolling]({% slug scrollmmodes_grid %}).
+     * Set `detailRowHeight` to match the actual DOM detail row height. The property does not change the height of the rows in the UI.
      */
     detailRowHeight: number;
     /**
-     * Defines the number of records to be skipped by the pager.
-     * Required by the [paging]({% slug paging_grid %}) functionality.
+     * Defines the number of records to skip in the pager.
+     * Required for the [`paging`]({% slug paging_grid %}) feature.
      */
     get skip(): number | null | undefined;
     set skip(value: number | null | undefined);
     /**
-     * Defines the scroll mode used by the Grid.
+     * Defines the scroll mode for the Grid.
      *
      * @default 'scrollable'
      */
     scrollable: ScrollMode;
     /**
-     * Enables the [single-row selection](slug:grid_row_selection) of the Grid.
+     * Enables the selection feature of the Grid. The `selectable` property can be set to `true`, `false`, or an object with additional settings.
+     * [See example](slug:grid_row_selection).
      *
      * @default false
      */
     selectable: SelectableSettings | boolean;
     /**
-     * The descriptors by which the data will be sorted ([see example]({% slug sorting_grid %})).
+     * Sets the descriptors for sorting the data ([see example]({% slug sorting_grid %})).
      */
     set sort(value: Array<SortDescriptor> | null | undefined);
     get sort(): Array<SortDescriptor> | null | undefined;
     /**
-     * Specifies the sizing of various Grid building blocks (e.g. tables, buttons, inputs, dropdowns, etc.)
+     * Specifies the sizing for Grid elements like tables, buttons, and inputs.
+     *
      * @default 'medium'
      */
     set size(size: GridSize);
@@ -201,20 +231,21 @@ export declare class GridComponent implements AfterContentInit, AfterViewInit, O
      * A function that defines how to track changes for the data rows.
      * By default, the Grid tracks changes by the index of the data item.
      * Edited rows are tracked by reference.
-     * [See example](slug:track_changes_grid)
+     * [See example](slug:track_changes_grid).
      */
     trackBy: TrackByFunction<GridItem>;
     /**
-     * The descriptor by which the data will be filtered ([see examples]({% slug filtering_grid %})).
+     * Sets the filter descriptor for the data ([see examples]({% slug filtering_grid %})).
      */
     filter: CompositeFilterDescriptor | null | undefined;
     /**
-     * The descriptors by which the data will be grouped ([see example]({% slug grouping_grid %})).
+     * Sets the descriptors for grouping the data ([see example]({% slug grouping_grid %})).
      */
     set group(value: Array<GroupDescriptor> | null | undefined);
     get group(): Array<GroupDescriptor> | null | undefined;
     /**
-     * If set to `true`, the grid will render only the columns in the current viewport.
+     * If `true`, renders only columns in the current viewport.
+     *
      * @default false
      */
     virtualColumns: boolean;
@@ -277,85 +308,78 @@ export declare class GridComponent implements AfterContentInit, AfterViewInit, O
      */
     gridData: DragTargetDataFn;
     /**
-     * Enables the [filtering]({% slug filtering_grid %}) of the Grid columns that have their `field` option set.
+     * Enables the [filtering](slug:filtering_grid) feature of the Grid for columns with a `field` option.
+     *
      * @default false
      */
     filterable: FilterableSettings;
     /**
-     * Enables the [sorting]({% slug sorting_grid %}) of the Grid columns that have their `field` option set.
+     * Enables [sorting]({% slug sorting_grid %}) feature of the Grid for columns with a `field` option.
      * @default false
      */
     sortable: SortSettings;
     /**
-     * Configures the pager of the Grid ([see example](slug:paging_grid_settings)).
+     * Configures the Grid pager ([see example](slug:paging_grid_settings)).
      * @default false
      */
     pageable: PagerSettings | boolean;
     get normalizedPageableSettings(): any;
     /**
-     * If set to `true`, the user can group the Grid by dragging the column header cells ([see example]({% slug grouping_grid %})).
+     * If `true`, allows grouping by dragging column headers ([see example]({% slug grouping_grid %})).
+     *
      * @default false
      */
     groupable: GroupableSettings | boolean;
     /**
-     * Determines whether the Grid can be resized.
+     * Determines if the Grid can be resized.
+     *
      * @default false
      */
     gridResizable: GridResizableSettings | boolean;
     /**
-     * Enables the [row reordering]({% slug reordering_rows_grid %}) of the Grid.
+     * Enables row reordering feature of the Grid ([see example]({% slug reordering_rows_grid %})).
+     *
      * @default false
      */
     set rowReorderable(value: boolean);
     get rowReorderable(): boolean;
     /**
-     * When the keyboard navigation is enabled, the user can use dedicated shortcuts to interact with the Grid.
-     * By default, navigation is enabled. To disable it altogether, and include the Grid content in the normal tab sequence, set the property to `false`.
-     * To enable navigation through separate Grid sections only, provide a [`GridNavigableSection`]({% slug api_grid_gridnavigablesection %}) array.
+     * By default, navigation is enabled. To disable, set to `false`.
+     * To enable navigation for specific sections, provide a [`GridNavigableSection`](slug:api_grid_gridnavigablesection).
      */
     set navigable(value: GridNavigableSettings);
     get navigable(): GridNavigableSettings;
     /**
-     * Indicates whether the Grid columns will be resized during initialization so that
-     * they fit their headers and row content.
+     * If `true`, resizes columns during initialization to fit headers and content.
      * Columns with `autoSize` set to `false` are excluded.
-     * To dynamically update the column width to match the new content,
-     * refer to [this example]({% slug resizing_columns_grid %}).
+     * [See example](slug:resizing_columns_grid).
+     *
      * @default false
      */
     autoSize: boolean;
     /**
-     * Defines a function that is executed for every data row in the component
-     * ([see example](slug:styling_grid_rows)).
+     * Sets a function to apply custom CSS classes to each data row ([see example](slug:styling_grid_rows)).
      */
     set rowClass(fn: RowClassFn);
     get rowClass(): RowClassFn;
     /**
-     * Defines a function that is executed for every data row in the component,
-     * and determines whether the row will be sticky, i.e. always visible after scrolling.
+     * Sets a function to determine if a data row is sticky (always visible after scrolling).
      */
     set rowSticky(fn: RowStickyFn);
     get rowSticky(): RowStickyFn;
     /**
-     * Defines a Boolean function that is executed for each data row in the component
-     * ([see example]({% slug grid_selection_custom %}#toc-setting-the-selected-rows)).
-     * Determines whether the row will be selected.
+     * Sets a function to determine if a data row is selected ([see example]({% slug grid_selection_custom %}#toc-setting-the-selected-rows)).
      */
     set rowSelected(fn: RowSelectedFn);
     get rowSelected(): RowSelectedFn;
     /**
-     * Defines a Boolean function that is executed for each data row in the component.
-     * Determines whether the row will be selectable.
+     * Sets a function to determine if a data row is selectable.
      */
     set isRowSelectable(fn: RowSelectableFn);
     get isRowSelectable(): RowSelectableFn;
     /**
-     * Defines a function that determines the selected state of a data cell.
-     * Returns an object with `selected` and `item` properties.
-     * The cell is marked as selected only if the `selected` property equals `true`.
-     *
-     * The function is executed for each data cell and may be called more than once
-     * as part of a change detection cycle. ([see example]({% slug grid_selection_custom %}#toc-setting-the-selected-cells))
+     * Sets a function to determine if a data cell is selected.
+     * The function returns an object with `selected` and `item` properties ([see example]({% slug grid_selection_custom %}#toc-setting-the-selected-cells)).
      */
     set cellSelected(fn: CellSelectedFn);
     get cellSelected(): CellSelectedFn;
@@ -374,40 +398,39 @@ export declare class GridComponent implements AfterContentInit, AfterViewInit, O
      */
     get selection(): GridSelectionItem[];
     /**
-     * The current Grid `GridState` objects. Contains the information about data operations and column state, required
-     * to store and restore the Grid state.
+     * Gets the current `GridState`, including data operations and column state.
+     * Use this to store and restore the Grid state.
      */
     get currentState(): GridState;
     /**
-     * If set to `true`, the user can resize columns by dragging the edges (resize handles) of their header cells
-     * ([see example]({% slug resizing_columns_grid %})).
+     * If `true`, allows resizing columns by dragging header cell edges ([see example]({% slug resizing_columns_grid %})).
      *
      * @default false
      */
     resizable: boolean | ResizeMode;
     /**
-     * If set to `true`, the user can reorder columns by dragging their header cells
-     * ([see example]({% slug reordering_columns_grid %})).
+     * If `true`, allows reordering columns by dragging header cells ([see example]({% slug reordering_columns_grid %})).
      *
      * @default false
      */
     reorderable: boolean;
     /**
-     * Specifies if the loading indicator of the Grid will be displayed ([see example]({% slug binding_grid %})).
+     * If `true`, displays the Grid loading indicator ([see example]({% slug binding_grid %})).
      *
      * @default false
      */
     set loading(value: boolean);
     get loading(): boolean;
     /**
-     * Specifies if the column menu of the columns will be displayed ([see example]({% slug columnmenu_grid %})).
+     * If `true`, displays the column menu for columns ([see example]({% slug columnmenu_grid %})).
      *
      * @default false
      */
     columnMenu: boolean | ColumnMenuSettings;
     /**
-     * Specifies if the header of the grid will be hidden. The header is visible by default.
+     * If `true`, hides the Grid header. The header is visible by default.
      * The header includes column headers and the [filter row](slug:filter_row).
+     *
      * @default false
      */
     hideHeader: boolean;
@@ -418,41 +441,37 @@ export declare class GridComponent implements AfterContentInit, AfterViewInit, O
      */
     showInactiveTools: boolean;
     /**
-     * A function which determines if a specific row is expanded.
+     * Sets a function to determine if a specific row is expanded.
      */
     set isDetailExpanded(callback: (args: RowArgs) => boolean);
     get isDetailExpanded(): (args: RowArgs) => boolean;
     /**
-     * A function which determines if a specific group row is expanded.
+     * Sets a function to determine if a specific group row is expanded.
      */
     set isGroupExpanded(callback: (args: GroupRowArgs) => boolean);
     get isGroupExpanded(): (args: GroupRowArgs) => boolean;
     /**
-     * Fires when the Grid filter is modified through the UI.
-     * You have to handle the event yourself and filter the data.
+     * Fires when the Grid data is filtered through the UI and the filter descriptor changes.
      */
     filterChange: EventEmitter<CompositeFilterDescriptor>;
     /**
-     * Fires when the page of the Grid is changed ([see example]({% slug paging_grid %})).
-     * You have to handle the event yourself and page the data.
+     * Fires when the page is changed through the UI ([see example]({% slug paging_grid %})).
      */
     pageChange: EventEmitter<PageChangeEvent>;
     /**
-     * Fires when the grouping of the Grid is changed.
-     * You have to handle the event yourself and group the data ([see example]({% slug grouping_grid %})).
+     * Fires when the Grid data is grouped through the UI and the group descriptors change ([see example]({% slug grouping_grid %})).
      */
     groupChange: EventEmitter<Array<GroupDescriptor>>;
     /**
-     * Fires when the sorting of the Grid is changed ([see example]({% slug sorting_grid %})).
-     * You have to handle the event yourself and sort the data.
+     * Fires when the Grid data is sorted through the UI and the sort descriptors change ([see example]({% slug sorting_grid %})).
      */
     sortChange: EventEmitter<Array<SortDescriptor>>;
     /**
-     * Fires when the user selects a Grid row.
+     * Fires when the Grid selection changes through the UI.
      */
     selectionChange: EventEmitter<SelectionEvent>;
     /**
-     * Fires when the user drops the dragged row and reordering is performed.
+     * Fires when a row is reordered through the UI.
      */
     rowReorder: EventEmitter<RowReorderEvent>;
     /**
@@ -464,91 +483,84 @@ export declare class GridComponent implements AfterContentInit, AfterViewInit, O
      */
     gridStateChange: EventEmitter<GridState>;
     /**
-     * Fires when the user expands a group header.
+     * Fires when a group is expanded through the UI.
      */
     groupExpand: EventEmitter<GroupRowArgs>;
     /**
-     * Fires when the user collapses a group header.
+     * Fires when a group is collapsed through the UI.
      */
     groupCollapse: EventEmitter<GroupRowArgs>;
     /**
-     * Fires when the user expands a master row.
+     * Fires when a detail row is expanded through the UI.
      */
     detailExpand: EventEmitter<DetailExpandEvent>;
     /**
-     * Fires when the user collapses a master row.
+     * Fires when a detail row is collapsed through the UI.
      */
     detailCollapse: EventEmitter<DetailCollapseEvent>;
     /**
-     * Fires when the user clicks the **Edit** command button to edit a row
-     * ([see example](slug:inline_editing_grid#editing-records-1)).
+     * Fires when a row enters edit mode ([see example](slug:inline_editing_grid#editing-records-1)).
      */
     edit: EventEmitter<EditEvent>;
     /**
-     * Fires when the user clicks the **Cancel** command button to close a row
-     * ([see example]({% slug inline_editing_grid %}#toc-canceling-editing-1)).
+     * Fires when editing is canceled by clicking the **Cancel** command button ([see example]({% slug inline_editing_grid %}#toc-canceling-editing-1)).
      */
     cancel: EventEmitter<CancelEvent>;
     /**
-     * Fires when the user clicks the **Save** command button to save changes in a row
-     * ([see example]({% slug inline_editing_grid %}#toc-saving-records-1)).
+     * Fires when a row is saved by clicking the **Save** command button ([see example]({% slug inline_editing_grid %}#toc-saving-records-1)).
      */
     save: EventEmitter<SaveEvent>;
     /**
-     * Fires when the user clicks the **Remove** command button to remove a row
-     * ([see example]({% slug inline_editing_grid %}#toc-removing-records-1)).
+     * Fires when a row is removed by clicking the **Remove** command button ([see example]({% slug inline_editing_grid %}#toc-removing-records-1)).
      */
     remove: EventEmitter<RemoveEvent>;
     /**
-     * Fires when the user clicks the **Add** command button to add a new row
-     * ([see example]({% slug inline_editing_grid %}#toc-adding-records-1)).
+     * Fires when a new row is added by clicking the **Add** command button ([see example]({% slug inline_editing_grid %}#toc-adding-records-1)).
      */
     add: EventEmitter<AddEvent>;
     /**
-     * Fires when the user leaves an edited cell ([see example](slug:editing_incell_grid)).
+     * Fires when a cell edit is closed ([see example](slug:editing_incell_grid)).
      */
     cellClose: EventEmitter<CellCloseEvent>;
     /**
-     * Fires when the user clicks a cell ([see example](slug:editing_incell_grid)).
+     * Fires when a cell is clicked ([see example](slug:editing_incell_grid)).
      */
     cellClick: EventEmitter<CellClickEvent>;
     /**
-     * Fires when the user clicks the **Export to PDF** command button.
+     * Fires when the PDF export command is triggered.
      */
     pdfExport: EventEmitter<PDFExportEvent>;
     /**
-     * Fires when the user clicks the **Export to Excel** command button.
+     * Fires when the Excel export command is triggered.
      */
     excelExport: EventEmitter<ExcelExportEvent>;
     /**
-     * Fires when the user completes the resizing of the column.
+     * Fires when columns are resized.
      */
     columnResize: EventEmitter<Array<ColumnResizeArgs>>;
     /**
-     * Fires when the user completes the reordering of the column.
+     * Fires when columns are reordered.
      */
     columnReorder: EventEmitter<ColumnReorderEvent>;
     /**
-     * Fires when the user changes the visibility of the columns from the column menu or column chooser.
+     * Fires when column visibility changes.
      */
     columnVisibilityChange: EventEmitter<ColumnVisibilityChangeEvent>;
     /**
-     * Fires when the user changes the locked state of the columns from the column menu or by reordering the columns.
+     * Fires when columns are locked or unlocked.
      */
     columnLockedChange: EventEmitter<ColumnLockedChangeEvent>;
     /**
-     * Fires when the user changes the sticky state of the columns from the column menu.
+     * Fires when columns are made sticky or unsticky.
      */
     columnStickyChange: EventEmitter<ColumnStickyChangeEvent>;
     /**
-     * Fires when the user scrolls to the last record on the page and enables endless scrolling
-     * ([see example]({% slug scrollmmodes_grid %}#toc-endless-scrolling)).
-     * You have to handle the event yourself and page the data.
+     * Fires when the last record is scrolled into view ([see example]({% slug scrollmmodes_grid %}#toc-endless-scrolling)).
      */
     scrollBottom: EventEmitter<ScrollBottomEvent>;
     /**
      * Fires when the grid content is scrolled.
-     * For performance reasons, the event is triggered outside the Angular zone. Enter the Angular zone if you make any changes that require change detection.
+     * The event is triggered outside the Angular zone for performance. Enter the Angular zone if you make changes that require change detection.
      */
     contentScroll: EventEmitter<ContentScrollEvent>;
     /**
@@ -710,53 +722,41 @@ export declare class GridComponent implements AfterContentInit, AfterViewInit, O
     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, adaptiveService: AdaptiveService, adaptiveGridService: AdaptiveGridService, rowReorderService: RowReorderService);
     /**
-     * Expands the specified master row ([see example]({% slug hierarchy_grid %})).
-     *
-     * This method is provided only for backwards-compatibility with legacy versions.
-     * These versions tracked the expanded state internally using the data row index.
+     * Expands the master row at the specified data row index ([see example]({% slug hierarchy_grid %})).
      *
-     * For new development, use the [kendoGridDetailsExpandBy directive]({% slug api_grid_expanddetailsdirective %})
-     * or provide an isDetailExpanded callback. See [Controlling the Expanded State]({% slug master_detail_expanded_state_grid %})
-     * for examples on how to control the expanded state.
+     * This method is for backwards compatibility with legacy versions that track expanded state by row index.
+     * For new development, use the [`kendoGridDetailsExpandBy` directive]({% slug api_grid_expanddetailsdirective %})
+     * or provide an `isDetailExpanded` callback. See [Controlling the Expanded State]({% slug master_detail_expanded_state_grid %}) for examples.
      *
-     * @param index - The data row index of the master row.
+     * @param index The data row index of the master row.
      */
     expandRow(index: number): void;
     /**
-     * Collapses the specified master row ([see example]({% slug hierarchy_grid %})).
+     * Collapses the master row at the specified data row index ([see example]({% slug hierarchy_grid %})).
      *
-     * This method is provided only for backwards-compatibility with legacy versions.
-     * These versions tracked the expanded state internally using the data row index.
+     * This method is for backwards compatibility with legacy versions that track expanded state by row index.
+     * For new development, use the [`kendoGridDetailsExpandBy` directive]({% slug api_grid_expanddetailsdirective %})
+     * or provide an `isDetailExpanded` callback. See [Controlling the Expanded State]({% slug master_detail_expanded_state_grid %}) for examples.
      *
-     * For new development, use the [kendoGridDetailsExpandBy directive]({% slug api_grid_expanddetailsdirective %})
-     * or provide an isDetailExpanded callback. See [Controlling the Expanded State]({% slug master_detail_expanded_state_grid %})
-     * for examples on how to control the expanded state.
-     *
-     * @param index - The data row index of the master row.
+     * @param index The data row index of the master row.
      */
     collapseRow(index: number): void;
     /**
-     * Expands a group header item for the given index. For example,
-     * `0_1` expands the second inner group of the first master group.
-     *
-     * This method is provided only for backwards-compatibility with legacy versions.
-     * These versions tracked the expanded group state internally using the hierarchical group index.
+     * Expands a group header at the given hierarchical index, such as `0_1` for the second inner group of the first master group.
      *
-     * When a Grid is pageable, the indexes of the groups are offset by the current Grid [skip]({% slug api_grid_gridcomponent %}#toc-skip).
+     * This method is for backwards compatibility with legacy versions that track expanded group state by hierarchical group index.
+     * If the Grid is pageable, the group indexes are offset by the current Grid [skip]({% slug api_grid_gridcomponent %}#toc-skip).
      *
-     * @param {string} index - The underscore separated hierarchical index of the group.
+     * @param {string} index The underscore-separated hierarchical index of the group.
      */
     expandGroup(index: string): void;
     /**
-     * Collapses a group header item for the given index. For example,
-     * `0_1` collapses the second inner group of the first master group.
+     * Collapses a group header at the given hierarchical index, such as `0_1` for the second inner group of the first master group.
      *
-     * This method is provided only for backwards-compatibility with legacy versions.
-     * These versions tracked the expanded group state internally using the hierarchical group index.
+     * This method is for backwards compatibility with legacy versions that track expanded group state by hierarchical group index.
+     * If the Grid is pageable, the group indexes are offset by the current Grid [skip]({% slug api_grid_gridcomponent %}#toc-skip).
      *
-     * When a Grid is pageable, the indexes of the groups are offset by the current Grid [skip]({% slug api_grid_gridcomponent %}#toc-skip).
-     *
-     * @param {string} index - The underscore separated hierarchical index of the group.
+     * @param {string} index The underscore-separated hierarchical index of the group.
      */
     collapseGroup(index: string): void;
     /**
@@ -788,12 +788,11 @@ export declare class GridComponent implements AfterContentInit, AfterViewInit, O
      */
     messageFor: (token: string) => string;
     /**
-     * Switches the specified table row in the edit mode ([see example]({% slug inline_editing_grid %}#toc-editing-records-1)).
+     * Switches the specified table row to edit mode ([see example]({% slug inline_editing_grid %}#toc-editing-records-1)).
      *
-     * @param rowIndex - The data row index that will be switched in the edit mode.
-     * @param group - The [FormGroup](link:site.data.urls.angular['formgroupapi'])
-     * that describes the edit form.
-     * @param options - Additional options configuring the focus target once the editor opens.
+     * @param rowIndex The data row index to switch to edit mode.
+     * @param group The [`FormGroup`](link:site.data.urls.angular['formgroupapi']) that describes the edit form.
+     * @param options Additional options to configure the focus target when the editor opens.
      */
     editRow(rowIndex: number, group?: FormGroup, options?: EditRowOptions): void;
     /**
@@ -801,35 +800,29 @@ export declare class GridComponent implements AfterContentInit, AfterViewInit, O
      */
     handleReorderEvents(ev: any, evType: string): void;
     /**
-     * Closes the editor for a given row ([see example]({% slug inline_editing_grid %}#toc-canceling-editing-1)).
+     * Closes the editor for the specified row ([see example]({% slug inline_editing_grid %}#toc-canceling-editing-1)).
      *
-     * @param {number} index - The row index that will be switched out of the edit mode. If no index is provided, it is assumed
-     * that the new item editor will be closed.
+     * @param {number} index The row index to switch out of edit mode. If you do not provide an index, the new item editor closes.
      */
     closeRow(index?: number): void;
     /**
      * Creates a new row editor ([see example]({% slug inline_editing_grid %}#toc-adding-records-1)).
      *
-     * @param {FormGroup} group - The [FormGroup](link:site.data.urls.angular['formgroupapi']) that describes
-     * the edit form. If called with a data item, it will build the `FormGroup` from the data item fields.
+     * @param {FormGroup} group The [`FormGroup`](link:site.data.urls.angular['formgroupapi']) that describes the edit form. If you pass a data item, the method builds the `FormGroup` from the data item fields.
      */
     addRow(group: any): void;
     /**
-     * Puts the cell that is specified by the table row and column in edit mode ([see example](slug:editing_incell_grid)).
+     * Puts the specified cell in edit mode ([see example](slug:editing_incell_grid)).
      *
-     * @param {number} rowIndex - The data row index that will be switched in the edit mode.
-     * @param {number|string|any} column - The leaf column index, or the field name or the column instance that should be edited.
-     * @param {FormGroup} group - The [FormGroup](link:site.data.urls.angular['formgroupapi'])
-     * that describes the edit form.
+     * @param {number} rowIndex The data row index to switch to edit mode.
+     * @param {number|string|any} column The leaf column index, field name, or column instance to edit.
+     * @param {FormGroup} group The [`FormGroup`](link:site.data.urls.angular['formgroupapi']) that describes the edit form.
      */
     editCell(rowIndex: number, column: number | string | any, group?: any): void;
     /**
-     * Closes the current cell in edit mode and fires
-     * the [cellClose]({% slug api_grid_gridcomponent %}#toc-cellclose) event.
+     * Closes the current cell in edit mode and fires the [`cellClose`]({% slug api_grid_gridcomponent %}#toc-cellclose) event.
      *
-     * @return {boolean} Indicates whether the edited cell was closed.
-     * A `false` value indicates that the
-     * [cellClose]({% slug api_grid_gridcomponent %}#toc-cellclose) event was prevented.
+     * @returns {boolean} `true` if the cell closed. Returns `false` if the [`cellClose`]({% slug api_grid_gridcomponent %}#toc-cellclose) event was prevented.
      */
     closeCell(): boolean;
     /**
@@ -837,15 +830,15 @@ export declare class GridComponent implements AfterContentInit, AfterViewInit, O
      */
     cancelCell(): void;
     /**
-     * Returns a flag which indicates if a row or a cell is currently edited.
+     * Returns `true` if a row or cell is currently edited.
      *
-     * @return {boolean} A flag which indicates if a row or a cell is currently edited.
+     * @returns {boolean} `true` if a row or cell is currently edited.
      */
     isEditing(): boolean;
     /**
-     * Returns a flag which indicates if a cell is currently edited.
+     * Returns `true` if a cell is currently edited.
      *
-     * @return {boolean} A flag which indicates if a cell is currently being edited.
+     * @returns {boolean} `true` if a cell is currently being edited.
      */
     isEditingCell(): boolean;
     /**
@@ -853,10 +846,10 @@ export declare class GridComponent implements AfterContentInit, AfterViewInit, O
      */
     saveAsPDF(): void;
     /**
-     * Exports the Grid element to a Drawing [Group]({% slug api_kendo-drawing_group %}) by using the `kendo-grid-pdf` component options.
+     * Exports the Grid element to a Drawing [Group]({% slug api_kendo-drawing_group %}) using the `kendo-grid-pdf` component options
      * ([see example]({% slug pdfexport_grid %}#toc-exporting-multiple-grids-to-the-same-pdf)).
      *
-     * @return {Promise} A promise that will be resolved with the Drawing `Group`.
+     * @returns {Promise} A promise that resolves with the Drawing `Group`.
      */
     drawPDF(): Promise<any>;
     /**
@@ -864,24 +857,20 @@ export declare class GridComponent implements AfterContentInit, AfterViewInit, O
      */
     saveAsExcel(): void;
     /**
-     * Applies the provided `GridState` object to the Grid.
+     * Applies the given `GridState` object to the Grid.
      */
     loadState(state: GridState): void;
     private traverseColumns;
     /**
-     * Applies the minimum possible width for the specified column,
-     * so that the whole text fits without wrapping. This method expects the Grid
-     * to be [resizable](slug:resizing_columns_grid). The method must be executed
-     * after the Grid is already populated with data.
+     * Applies the minimum possible width for the specified column so the whole text fits without wrapping.
+     * This method expects the Grid to be [`resizable`](slug:resizing_columns_grid). Run this method after the Grid is populated with data.
      * [See example](slug:resizing_columns_grid#toc-auto-fitting-the-content)
      */
     autoFitColumn(column: ColumnBase): void;
     /**
      * Adjusts the width of the specified columns to fit the entire content, including headers, without wrapping.
-     * If no columns are specified, `autoFitColumns` is applied to all columns.The method must be executed
-     * after the Grid is already populated with data.
+     * If you do not specify columns, `autoFitColumns` applies to all columns. Run this method after the Grid is populated with data.
      * [See example](slug:resizing_columns_grid#toc-auto-fitting-the-content)
-     *
      */
     autoFitColumns(columns?: Array<ColumnBase> | QueryList<ColumnBase>): void;
     /**
@@ -917,8 +906,8 @@ export declare class GridComponent implements AfterContentInit, AfterViewInit, O
      * If the Grid is configured for scrolling, including virtual scrolling, the scroll position will be updated.
      * If the row is not present on the current page, the method will have no effect.
      *
-     * @param rowIndex - The logical row index to focus. The top header row has an index 0.
-     * @param colIndex - The column index to focus.
+     * @param rowIndex The logical row index to focus. The top header row has an index 0.
+     * @param colIndex The column index to focus.
      * @returns {NavigationCell} The focused cell.
      *
      */
@@ -926,7 +915,7 @@ export declare class GridComponent implements AfterContentInit, AfterViewInit, O
     /**
      * Focuses the next cell, optionally wrapping to the next row.
      *
-     * @param wrap - A Boolean value which indicates if the focus will move to the next row. Defaults to `true`.
+     * @param wrap A Boolean value which indicates if the focus will move to the next row. Defaults to `true`.
      * @returns {NavigationCell} The focused cell. If the focus is already on the last cell, returns `null`.
      */
     focusNextCell(wrap?: boolean): NavigationCell;
@@ -947,15 +936,12 @@ export declare class GridComponent implements AfterContentInit, AfterViewInit, O
     scrollToItem(request: ScrollToItemRequest): void;
     /**
      * Changes the position of the specified column.
-     * The reordering of columns operates only on the level
-     * which is inferred by the source column.
-     * For the `reorderColumn` method to work properly,
-     * the `source` column has to be visible.
-     *
-     * @param {ColumnBase} source - The column whose position will be changed.
-     * @param {number} destIndex - The new position of the column.
-     * @param {ColumnReorderConfig} options - Additional options.
+     * The reordering of columns operates only on the level inferred by the source column.
+     * For this method to work, the `source` column must be visible.
      *
+     * @param {ColumnBase} source The column to move.
+     * @param {number} destIndex The new position of the column.
+     * @param {ColumnReorderConfig} options Additional options.
      */
     reorderColumn(source: ColumnBase, destIndex: number, options?: ColumnReorderConfig): void;
     /**