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

package/esm2022/navigation/focus-group.mjs

@@ -35,8 +35,8 @@ export class FocusGroup {
         this.children = this.children.filter(f => f !== element);
     }
     /**
-     * Returns a Boolean value which indicates if the group will receive focus when the cell is focused.
-     * Requires a single "simple" focusable element such as a button or a checkbox.
+     * Returns `true` if the group receives focus when the cell is focused.
+     * The group must have a single simple focusable element, like a button or checkbox.
      */
     isNavigable() {
         const focusable = this.focusableChildren;

package/esm2022/navigation/focusable.directive.mjs

@@ -9,21 +9,23 @@ import { ContextService } from '../common/provider.service';
 import * as i0 from "@angular/core";
 import * as i1 from "../common/provider.service";
 /**
- * A directive that controls the way focusable elements receive
- * [focus in a navigable Grid]({% slug keyboard_navigation_grid %}).
+ * A directive that controls how focusable elements receive
+ * focus in a navigable Grid. [See example]({% slug keyboard_navigation_grid %}).
  *
  * @example
  * ```html
  * <kendo-grid [data]="data" [navigable]="true">
  *    <kendo-grid-column>
  *       <ng-template kendoGridCellTemplate let-dataItem>
- *          <!-- The first focusable element will be focused when pressing Enter on the cell -->
+ *          <!-- The first focusable element is focused when you press Enter on the cell. -->
  *          <input type="text" kendoGridFocusable [value]="dataItem.ProductName" style="margin-right: 8px;" />
  *          <button kendoGridFocusable>Update</button>
  *       </ng-template>
  *    </kendo-grid-column>
  * </kendo-grid>
  * ```
+ * @remarks
+ * Applied to: {@link ButtonComponent}, {@link TextBoxComponent}, {@link DateInputComponent}, {@link DatePickerComponent}, {@link DateTimePicker}, {@link TextAreaComponent}, {@link ColorPickerComponent}, {@link DropDownListComponent}, {@link ComboBoxComponent}, {@link AutoCompleteComponent}.
  */
 export class FocusableDirective {
     cellContext;

package/esm2022/package-metadata.mjs

@@ -10,7 +10,7 @@ export const packageMetadata = {
     productName: 'Kendo UI for Angular',
     productCode: 'KENDOUIANGULAR',
     productCodes: ['KENDOUIANGULAR'],
-    publishDate: 1750157109,
-    version: '19.1.2-develop.4',
+    publishDate: 1750431017,
+    version: '19.1.2-develop.5',
     licensingDocsUrl: 'https://www.telerik.com/kendo-angular-ui/my-license/'
 };

package/esm2022/pdf/pdf-command-tool.directive.mjs

@@ -13,24 +13,21 @@ import * as i1 from "./pdf.service";
 import * as i2 from "@progress/kendo-angular-toolbar";
 import * as i3 from "../common/provider.service";
 /**
- * Represents the `export-to-PDF` toolbar tool of the Grid.
- * You can apply this directive to any `kendo-toolbar-button` element inside a
- * ToolbarComponent used in the Grid.
- *
- * When the user clicks the toolbar button that is associated with the directive, the
- * [pdfExport]({% slug api_grid_gridcomponent %}#toc-pdfexport) event
- * fires ([see example]({% slug pdfexport_grid %})).
+ * Represents the PDF export toolbar tool of the Grid.
+ * Apply this directive to any `kendo-toolbar-button` element inside a ToolbarComponent in the Grid.
+ * When you click the toolbar button with this directive, the [`pdfExport`]({% slug api_grid_gridcomponent %}#toc-pdfexport) event fires. ([See example]({% slug pdfexport_grid %})).
  *
  * @example
- * ```html-no-run
+ * ```html
  * <kendo-grid>
  *      <kendo-toolbar>
- *         <kendo-toolbar-button text="PDF Export" kendoGridPDFTool></kendo-toolbar-button>
+ *         <kendo-toolbar-button text="Export to PDF" kendoGridPDFTool></kendo-toolbar-button>
  *      </kendo-toolbar>
- *      <kendo-grid-pdf fileName="Grid.pdf">
- *      </kendo-grid-pdf>
+ *      <kendo-grid-pdf fileName="products.pdf"></kendo-grid-pdf>
  * </kendo-grid>
  * ```
+ * @remarks
+ * Applied to: {@link ToolBarButtonComponent}.
  */
 export class PDFCommandToolbarDirective extends ToolbarToolBase {
     pdfService;

package/esm2022/pdf/pdf-command.directive.mjs

@@ -12,21 +12,17 @@ import * as i0 from "@angular/core";
 import * as i1 from "./pdf.service";
 import * as i2 from "../common/provider.service";
 /**
- * Represents the `export-to-PDF` command of the Grid.
- * You can apply this directive to any `button` element inside a
- * [ToolbarTemplate]({% slug api_grid_commandcolumncomponent %}).
- * When the user clicks a button that is associated with the directive, the
- * [pdfExport]({% slug api_grid_gridcomponent %}#toc-pdfexport) event
- * fires ([see example]({% slug pdfexport_grid %})).
+ * Represents the PDF export command of the Grid.
+ * Apply this directive to any `button` element inside a [ToolbarTemplate]({% slug api_grid_commandcolumncomponent %}).
+ * When you click a button with this directive, the [`pdfExport`]({% slug api_grid_gridcomponent %}#toc-pdfexport) event fires. ([See example]({% slug pdfexport_grid %})).
  *
  * @example
- * ```html-no-run
+ * ```html
  * <kendo-grid>
  *      <ng-template kendoGridToolbarTemplate>
  *          <button kendoGridPDFCommand>Export to PDF</button>
  *      </ng-template>
- *      <kendo-grid-pdf fileName="Grid.pdf">
- *      </kendo-grid-pdf>
+ *      <kendo-grid-pdf fileName="products.pdf"></kendo-grid-pdf>
  * </kendo-grid>
  * ```
  */

package/esm2022/pdf/pdf-export-event.mjs

@@ -4,7 +4,7 @@
 *-------------------------------------------------------------------------------------------*/
 import { PreventableEvent } from '../common/preventable-event';
 /**
- * Arguments for the `pdfExport` event.
+ * Provides the arguments for the `pdfExport` event.
  */
 export class PDFExportEvent extends PreventableEvent {
     /**

package/esm2022/pdf/pdf-margin.component.mjs

@@ -7,12 +7,22 @@ import { PDFExportMarginComponent } from '@progress/kendo-angular-pdf-export';
 import * as i0 from "@angular/core";
 /**
  * Represents the Kendo UI PDFMargin component for Angular.
- * The supported units are:
- * `"mm"`
- * `"cm"`
- * `"in"`
- * `"pt"` (default).
- * Numbers are considered to be points (`"pt"`).
+ * Use this component to set the PDF page margins.
+ * Supported units are:
+ * - `"mm"`
+ * - `"cm"`
+ * - `"in"`
+ * - `"pt"` (default)
+ * When you provide only a number, the units default to points (`pt`).
+ *
+ * @example
+ * ```html
+ * <kendo-grid>
+ *   <kendo-grid-pdf [allPages]="true" [delay]="100">
+ *     <kendo-grid-pdf-margin top="1cm" bottom="1cm" left="1cm" right="1cm"></kendo-grid-pdf-margin>
+ *   </kendo-grid-pdf>
+ * </kendo-grid>
+ * ```
  */
 export class PDFMarginComponent extends PDFExportMarginComponent {
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "16.2.12", ngImport: i0, type: PDFMarginComponent, deps: null, target: i0.ɵɵFactoryTarget.Component });

package/esm2022/pdf/pdf-template.directive.mjs

@@ -6,12 +6,12 @@ import { Directive, Optional, TemplateRef } from '@angular/core';
 import { PDFExportTemplateDirective } from '@progress/kendo-angular-pdf-export';
 import * as i0 from "@angular/core";
 /**
- * Represents the PDF page template of the Grid that helps to customize the PDF pages. To define a page template,
- * nest an `<ng-template>` tag with the `kendoGridPDFTemplate` directive inside `<kendo-grid-pdf>` tag.
+ * The directive allows customizing the PDF page template for the Grid.
+ * Place an `<ng-template>` with the `kendoGridPDFTemplate` directive inside the `<kendo-grid-pdf>` tag.
  *
- * The template context provides the following fields:
- * - `pageNumber`&mdash;Defines PDF page number.
- * - `totalPages`&mdash;Defines the total number of PDF pages.
+ * The template context provides:
+ * - `pageNumber`&mdash;The current PDF page number.
+ * - `totalPages`&mdash;The total number of PDF pages.
  *
  * @example
  * ```html

package/esm2022/pdf/pdf.component.mjs

@@ -30,7 +30,18 @@ const createDiv = (className) => {
     return createElement('div', className);
 };
 /**
- * Configures the settings for the export of Grid in PDF ([see example]({% slug pdfexport_grid %})).
+ * Configures the settings for exporting the Grid to PDF. ([See example]({% slug pdfexport_grid %})).
+ *
+ * Use this component to customize PDF export options for the Grid.
+ *
+ * @example
+ * ```html
+ * <kendo-grid>
+ *   <kendo-grid-pdf [allPages]="true" [delay]="100"></kendo-grid-pdf>
+ * </kendo-grid>
+ * ```
+ * @remarks
+ * Supported children components are: {@link PDFMarginComponent}.
  */
 export class PDFComponent extends PDFExportComponent {
     pdfService;
@@ -38,13 +49,12 @@ export class PDFComponent extends PDFExportComponent {
     ngZone;
     ctx;
     /**
-     * Exports all Grid pages, starting from the first one.
+     * Exports all Grid pages, starting from the first page.
      */
     allPages;
     /**
-     * The delay in milliseconds before exporting the Grid content.
-     * Useful for scenarios which involve exporting complex components used in the Grid
-     * templates such as charts or data-bound components with asynchronous data retrieval ([see example]({% slug pdfexport_grid %}#toc-exporting-all-pages)).
+     * Sets the delay in milliseconds before exporting the Grid content.
+     * Use this property when exporting complex components in Grid templates, such as charts or data-bound components with asynchronous data retrieval. ([See example]({% slug pdfexport_grid %}#toc-exporting-all-pages)).
      *
      * @default 0
      */

package/esm2022/pdf/pdf.module.mjs

@@ -14,12 +14,11 @@ import * as i5 from "./pdf-template.directive";
 import * as i6 from "./pdf-command-tool.directive";
 // IMPORTANT: NgModule export kept for backwards compatibility
 /**
- * Represents the [NgModule](link:site.data.urls.angular['ngmoduleapi'])
- * definition for the Grid PDF component.
+ * Represents the [`NgModule`](link:site.data.urls.angular['ngmoduleapi']) definition for the Grid PDF component.
+ * Use this module to enable PDF export in the Grid for NgModule-based applications.
  *
  * @example
- *
- * ```ts
+ * ```typescript
  * import { NgModule } from '@angular/core';
  * import { BrowserModule } from "@angular/platform-browser";
  * import { GridModule, PDFModule } from '@progress/kendo-angular-grid';
@@ -30,9 +29,7 @@ import * as i6 from "./pdf-command-tool.directive";
  *     imports:      [BrowserModule, GridModule, PDFModule],
  *     bootstrap:    [AppComponent]
  * })
- *
  * export class AppModule {}
- *
  * ```
  */
 export class PDFModule {

package/esm2022/rendering/cell-loading.template.directive.mjs

@@ -5,14 +5,11 @@
 import { Directive, TemplateRef, Optional } from '@angular/core';
 import * as i0 from "@angular/core";
 /**
- * Represents the virtual scrolling cell template of the Grid while loading new data. Provides an option to customize the
- * appearance of the indicator that is displayed while new data is loading. To define the loading cell template,
- * nest an `<ng-template>` tag with the `kendoGridCellLoadingTemplate` directive inside `<kendo-grid>` tag [see example]({% slug virtualscrolling_grid %}#toc-custom-loading-skeleton).
+ * The directive allows customizing the loading indicator for virtual scrolling cells in the Grid.
+ * Place an `<ng-template>` tag with the `kendoGridCellLoadingTemplate` directive inside `<kendo-grid>` to define the loading cell template. ([See example]({% slug virtualscrolling_grid %}#toc-custom-loading-skeleton)).
  *
- *
- * The template context is set to the current column and the following additional field is passed:
- *
- * - `column`&mdash;The current column instance. Represents the default context that will be assigned to any template variable which utilizes the `let-x` syntax (for example `let-column`).
+ * The template context is set to the current column. You can use the following field:
+ * - `column`&mdash;The current column instance. This is the default context for any template variable that uses the `let-x` syntax (for example, `let-column`).
  *
  * @example
  * ```html

package/esm2022/rendering/cell-template.directive.mjs

@@ -5,15 +5,14 @@
 import { Directive, TemplateRef, Optional } from '@angular/core';
 import * as i0 from "@angular/core";
 /**
- * Represents the column cell template of the Grid.
- * Helps to customize the content of the cells. To define the cell template, nest an `<ng-template>` tag with the
- * `kendoGridCellTemplate` directive inside a `<kendo-grid-column>` tag [see example](slug:templates_columns_grid#toc-cell-template).
+ * Lets you customize the content of Grid cells.
+ * Place an `<ng-template>` tag with the `kendoGridCellTemplate` directive inside a `<kendo-grid-column>` tag to define the cell template. ([See example](slug:templates_columns_grid#toc-cell-template)).
  *
- * The template context is set to the current data item and the following additional fields are passed:
- * - `columnIndex`&mdash;The current column index. Use it as an alias for a template variable by utilizing the `let-columnIndex="columnIndex"` syntax.
- * - `rowIndex`&mdash;The current data row index. Use it as an alias for a template variable by utilizing the `let-rowIndex="rowIndex"` syntax.
- * - `dataItem`&mdash;The current data item. Represents the default context that will be assigned to any template variable which utilizes the `let-x` syntax&mdash;for example, `let-dataItem`.
- * - `column`&mdash;The current column instance. Use it as an alias for a template variable by utilizing the `let-column="column"` syntax.
+ * The template context is set to the current data item. You can use these fields:
+ * - `columnIndex`&mdash;The current column index. Use `let-columnIndex="columnIndex"` in your template.
+ * - `rowIndex`&mdash;The current data row index. Use `let-rowIndex="rowIndex"` in your template.
+ * - `dataItem`&mdash;The current data item. This is the default context for any template variable that uses the `let-x` syntax, such as `let-dataItem`.
+ * - `column`&mdash;The current column instance. Use `let-column="column"` in your template.
  *
  * @example
  * ```html

package/esm2022/rendering/common/spacer.component.mjs

@@ -11,6 +11,18 @@ import * as i0 from "@angular/core";
  * and provides a way for customizing the spacer width.
  * It can also be used in any flex container within the Grid
  * ([see example](slug:toolbartemplate_grid#toc-defining-the-spacing-between-toolbar-elements)).
+ *
+ * @example
+ * ```html
+ * <kendo-grid [data]="data">
+ *   <ng-template kendoGridToolbarTemplate>
+ *     <kendo-grid-spacer></kendo-grid-spacer>
+ *       <button type="button" kendoGridExcelCommand [svgIcon]="fileExcelIcon"> Export to Excel </button>
+ *     <kendo-grid-spacer></kendo-grid-spacer>
+ *   </ng-template>
+ *   <kendo-grid-column field="ProductName" title="Product Name"></kendo-grid-column>
+ * </kendo-grid>
+ * ```
  */
 export class GridSpacerComponent {
     hostClass = true;
@@ -22,9 +34,8 @@ export class GridSpacerComponent {
     }
     /**
      * Specifies the width of the GridSpacer.
-     * Accepts the [string values of the CSS `flex-basis` property](https://developer.mozilla.org/en-US/docs/Web/CSS/flex-basis).
-     *
-     * If not set, the GridSpacer will take all the available space.
+     * Accepts string values for the [CSS `flex-basis`](https://developer.mozilla.org/en-US/docs/Web/CSS/flex-basis) property.
+     * If not set, the GridSpacer takes all available space.
      */
     width;
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "16.2.12", ngImport: i0, type: GridSpacerComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });

package/esm2022/rendering/details/detail-collapse-event.mjs

@@ -4,17 +4,22 @@
 *-------------------------------------------------------------------------------------------*/
 import { PreventableEvent } from '../../common/preventable-event';
 /**
- * Arguments for the `detailCollapse` event.
+ * Provides the arguments for the `detailCollapse` event.
+ *
+ * The event fires when a detail row collapses.
  */
 export class DetailCollapseEvent extends PreventableEvent {
     /**
-     * The collapsed row `dataItem`.
+     * The `dataItem` for the collapsed row.
      */
     dataItem;
     /**
-     * The collapsed row index.
+     * The index of the collapsed row.
      */
     index;
+    /**
+     * @hidden
+     */
     constructor(args) {
         super();
         Object.assign(this, args);

package/esm2022/rendering/details/detail-expand-event.mjs

@@ -4,17 +4,22 @@
 *-------------------------------------------------------------------------------------------*/
 import { PreventableEvent } from '../../common/preventable-event';
 /**
- * Arguments for the `detailExpand` event.
+ * Provides the arguments for the `detailExpand` event.
+ *
+ * The event fires when a detail row expands.
  */
 export class DetailExpandEvent extends PreventableEvent {
     /**
-     * The expanded row `dataItem`.
+     * Represents the `dataItem` for the expanded row.
      */
     dataItem;
     /**
-     * The expanded row index.
+     * Represents the index of the expanded row.
      */
     index;
+    /**
+     * @hidden
+     */
     constructor(args) {
         super();
         Object.assign(this, args);

package/esm2022/rendering/details/detail-template.directive.mjs

@@ -7,7 +7,7 @@ import { GridConfigurationErrorMessages } from '../../common/error-messages';
 import * as i0 from "@angular/core";
 /**
  * Represents the detail template of the Grid ([more information and examples]({% slug detailrowtemplate_grid %})).
- * To define the detail template, nest an `<ng-template>` tag with the `kendoGridDetailTemplate` directive inside a `<kendo-grid>` tag.
+ * Nest an `<ng-template>` tag with the `kendoGridDetailTemplate` directive inside a `<kendo-grid>` tag to define the detail template.
  *
  * @example
  * ```html
@@ -26,7 +26,8 @@ import * as i0 from "@angular/core";
 export class DetailTemplateDirective {
     templateRef;
     /**
-     * Defines the function that indicates if a given detail row and the associated **Expand** or **Collapse** button will be displayed.
+     * Sets a function to decide if the detail row and the **Expand** or **Collapse** button display for a data item.
+     * The function receives the data item and its index.
      */
     set showIf(fn) {
         if (typeof fn !== 'function') {

package/esm2022/rendering/details-expand.directive.mjs

@@ -11,16 +11,27 @@ import { isPresent, isString } from '../utils';
 import * as i0 from "@angular/core";
 import * as i1 from "../grid.component";
 /**
- * A directive which controls the expanded state of the master detail rows. ([see example](slug:master_detail_expanded_state_grid#toc-built-in-directive))
+ * Controls the expanded state of master detail rows in the Grid.
+ * Use this directive to manage which detail rows are expanded or collapsed.
+ * ([see example](slug:master_detail_expanded_state_grid#toc-built-in-directive))
+ *
+ * @example
+ * ```typescript
+ * <kendo-grid [kendoGridExpandDetailsBy]="expandDetailsKey" [expandedDetailKeys]="expandedDetailKeys"></kendo-grid>
+ * ```
+ * @remarks
+ * Applied to: {@link GridComponent}.
  */
 export class ExpandDetailsDirective {
     grid;
     /**
-     * Fires when the expandedDetailKeys are changed.
+     * Fires when the `expandedDetailKeys` collection changes.
      */
     expandedDetailKeysChange = new EventEmitter();
     /**
-     * Defines the item key that will be stored in the `expandedDetailKeys` collection ([see example]({% slug master_detail_expanded_state_grid %}#toc-built-in-directive)).
+     * Sets the item key stored in the `expandedDetailKeys` collection.
+     * Accepts a property name or a function that returns a unique key for each data item.
+     * ([See example]({% slug master_detail_expanded_state_grid %}#toc-built-in-directive)).
      */
     get expandDetailsKey() {
         return this._expandBy;
@@ -34,7 +45,6 @@ export class ExpandDetailsDirective {
         }
     }
     /**
-     *
      * @hidden
      * A deprecated alias for setting the `expandDetailsKey` property.
      */
@@ -45,13 +55,13 @@ export class ExpandDetailsDirective {
         this.expandDetailsKey = key;
     }
     /**
-     * Defines the collection that will store the expanded keys.
+     * Holds the collection of expanded detail row keys.
+     * Set this property to control which detail rows are expanded.
      */
     expandedDetailKeys = [];
     /**
-     * Specifies if the items should be initially expanded.
-     * When set to `true` items added to the `expandedDetailKeys` collection will be collapsed, and items that are not present in it will be expanded.
-     *
+     * Specifies if detail rows are expanded by default.
+     * When set to `true`, items in the `expandedDetailKeys` collection are collapsed, and all others are expanded.
      * @default false
      */
     initiallyExpanded = false;

package/esm2022/rendering/footer/footer-template.directive.mjs

@@ -7,16 +7,16 @@ import * as i0 from "@angular/core";
 /**
  * Represents the column footer cell template of the Grid
  * ([more information and example]({% slug templates_columns_grid %}#toc-footer-template)).
- * Helps to customize the table footer cell for the column.
+ * Use this directive to customize the table footer cell for a column.
  * To define a footer template, nest an `<ng-template>` tag with the
- * [kendoGridFooterTemplate]({% slug api_grid_footertemplatedirective %}) directive inside the `<kendo-grid-column>` tag.
+ * [`kendoGridFooterTemplate`]({% slug api_grid_footertemplatedirective %}) directive inside the `<kendo-grid-column>` tag.
  *
- * The template context is set to the current column and the following additional fields are passed:
- * * `column`&mdash;Defines an instance of the [ColumnComponent]({% slug api_grid_columncomponent %}) option.
- * * `columnIndex`&mdash;Defines the current column index.
+ * The template context is set to the current column. The following additional fields are available:
+ * * `column`&mdash;An instance of the [`ColumnComponent`]({% slug api_grid_columncomponent %}) option.
+ * * `columnIndex`&mdash;The current column index.
  *
- * For more information on how to display aggregates in the footer of the Grid,
- * refer to the article on [aggregates]({% slug groupable_grid_with_aggregates %}).
+ * For more information about displaying aggregates in the footer of the Grid,
+ * see the article on [aggregates]({% slug groupable_grid_with_aggregates %}).
  *
  * @example
  * ```html

package/esm2022/rendering/groups-expand.directive.mjs

@@ -23,17 +23,26 @@ const DEFAULT_KEY_GETTER = (groupRowArgs) => ({
     parentGroupKeys: mapParentGroup(groupRowArgs.parentGroup)
 });
 /**
- * A directive which controls the expanded state of the group rows
+ * Controls the expanded state of group rows in the Grid.
+ * Use this directive to manage which group rows are expanded or collapsed
  * ([see example]({% slug groups_expanded_state_grid %}#toc-built-in-directive)).
+ *
+ * @example
+ * ```typescript
+ * <kendo-grid [kendoGridExpandGroupBy]="expandGroupBy" [expandedGroupKeys]="expandedGroupKeys"></kendo-grid>
+ * ```
+ * @remarks
+ * Applied to: {@link GridComponent}.
  */
 export class ExpandGroupDirective {
     grid;
     /**
-     * Fires when the expandedGroupKeys are changed.
+     * Fires when the `expandedGroupKeys` collection changes.
      */
     expandedGroupKeysChange = new EventEmitter();
     /**
-     * Defines the item format that will be stored in the `expandedGroupKeys`
+     * Sets the item format stored in the `expandedGroupKeys` collection.
+     * Accepts a property name or a function that returns a unique key for each group
      * ([see example]({% slug groups_expanded_state_grid %}#toc-custom-group-key-format)).
      */
     get expandGroupBy() {
@@ -45,7 +54,8 @@ export class ExpandGroupDirective {
         }
     }
     /**
-     * Defines the collection that will store the expanded group keys.
+     * Holds the collection of expanded group keys.
+     * Set this property to control which group rows are expanded.
      */
     get expandedGroupKeys() {
         return this._expandedGroupKeys;
@@ -54,7 +64,7 @@ export class ExpandGroupDirective {
         this._expandedGroupKeys = (expandedGroups || []).slice();
     }
     /**
-     * Specifies if the group items should be initially expanded.
+     * Specifies if group items are expanded by default.
      * @default false
      */
     groupsInitiallyExpanded = false;

package/esm2022/rendering/header/header-template.directive.mjs

@@ -7,22 +7,22 @@ import * as i0 from "@angular/core";
 /**
  * Represents the column header cell template of the Grid
  * ([more information and example]({% slug templates_columns_grid %}#toc-header-template)).
- * Helps to customize the table header cell for the column.
+ * Use this directive to customize the table header cell for a column.
  * To define a header template, nest an `<ng-template>` tag with the
  * `kendoGridHeaderTemplate` directive inside the `<kendo-grid-column>` tag.
  *
- *  The template context is set to the current column and then the following additional fields are passed:
- * * `column`&mdash;Defines an instance of the [ColumnComponent]({% slug api_grid_columncomponent %}) option.
- * * `columnIndex`&mdash;Defines the current column index.
+ * The template context is set to the current column. The following additional fields are available:
+ * * `column`&mdash;An instance of the [`ColumnComponent`]({% slug api_grid_columncomponent %}) option.
+ * * `columnIndex`&mdash;The current column index.
  *
  * @example
- * ```html
- * <kendo-grid [data]="gridData">
- *    <kendo-grid-column field="ProductName">
- *       <ng-template kendoGridHeaderTemplate let-column let-columnIndex="columnIndex">
- *          {{column.field}}({{columnIndex}})
- *       </ng-template>
- *    </kendo-grid-column>
+ * ```typescript
+ * <kendo-grid>
+ *   <kendo-grid-column field="ProductName" title="Product Name">
+ *     <ng-template kendoGridHeaderTemplate let-column let-columnIndex="columnIndex">
+ *       Header for {{ column.field }} (index: {{ columnIndex }})
+ *     </ng-template>
+ *   </kendo-grid-column>
  * </kendo-grid>
  * ```
  */

package/esm2022/rendering/loading-template.directive.mjs

@@ -5,9 +5,20 @@
 import { Directive, TemplateRef } from '@angular/core';
 import * as i0 from "@angular/core";
 /**
- * Creates a loading template that overrides the default loading indicator of the Grid Component.
- * To define a loading template, nest an `<ng-template>` tag with the `kendoGridLoadingTemplate` directive inside the `<kendo-grid>` tag
- * ([see example](slug:loadingtemplate_grid)).
+ * Lets you override the default loading indicator of the Grid.
+ * Place an `<ng-template>` tag with the `kendoGridLoadingTemplate` directive inside `<kendo-grid>` to define a loading template. ([See example](slug:loadingtemplate_grid)).
+ *
+ * @example
+ * ```html
+ * <kendo-grid [data]="gridData" [loading]="true">
+ *   <ng-template kendoGridLoadingTemplate>
+ *     <div class="custom-loading-indicator">
+ *       Loading data, please wait...
+ *     </div>
+ *   </ng-template>
+ *   <kendo-grid-column field="ProductName"></kendo-grid-column>
+ *   <kendo-grid-column field="UnitPrice"></kendo-grid-column>
+ * </kendo-grid>
  */
 export class LoadingTemplateDirective {
     templateRef;

package/esm2022/rendering/no-records-template.directive.mjs

@@ -5,16 +5,14 @@
 import { Directive, TemplateRef, Optional } from '@angular/core';
 import * as i0 from "@angular/core";
 /**
- * Represents the no-records template of the Grid. Provides an option to customize the
- * appearance of the item that is displayed when no data is present.
- * To define the no-records template, nest an `<ng-template>` tag with the `kendoGridNoRecordsTemplate`
- * directive inside `<kendo-grid>` [see example](slug:norecordtemplate_grid).
+ * Lets you customize the item shown when the Grid has no data.
+ * Place an `<ng-template>` tag with the `kendoGridNoRecordsTemplate` directive inside `<kendo-grid>` to define the no-records template. ([See example](slug:norecordtemplate_grid)).
  *
  * @example
  * ```html
  * <kendo-grid [data]="data">
  *   <ng-template kendoGridNoRecordsTemplate>
- *     There are not products. <a href="#" (click)="refresh()">Click here to refresh</a>.
+ *     There are no products. <a href="#" (click)="refresh()">Click here to refresh.</a>
  *   </ng-template>
  *   <kendo-grid-column field="ProductID"></kendo-grid-column>
  *   <kendo-grid-column field="ProductName"></kendo-grid-column>

package/esm2022/rendering/table-body.component.mjs

@@ -374,7 +374,9 @@ export class TableBodyComponent {
             if (!selectionEnabled) {
                 return;
             }
-            if (!this.editService.isEditing()) {
+            const isCellFocused = closest(target, matchesNodeName('td')).classList.contains('k-focus');
+            const isShiftOrCtrlPressed = eventArg.shiftKey || eventArg.ctrlKey || eventArg.metaKey;
+            if (isCellFocused && !isShiftOrCtrlPressed) {
                 eventArg.preventDefault();
             }
         }

package/esm2022/rendering/toolbar/toolbar-focusable.directive.mjs

@@ -8,8 +8,16 @@ import { ContextService } from '../../common/provider.service';
 import * as i0 from "@angular/core";
 import * as i1 from "../../common/provider.service";
 /**
- * A directive applied to all toolbar elements that need to be a part of the Grid
- * keyboard navigation.
+ * Adds keyboard navigation support to toolbar elements in the Grid.
+ *
+ * Apply this directive to toolbar elements that should be focusable and navigable with the keyboard.
+ *
+ * @example
+ * ```html
+ * <kendo-toolbar>
+ *   <button kendoGridToolbarFocusable>Button</button>
+ * </kendo-toolbar>
+ * ```
  */
 export class GridToolbarFocusableDirective {
     host;