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

package/navigation/focus-group.d.ts

@@ -20,8 +20,8 @@ export declare class FocusGroup implements OnDestroy {
     registerElement(element: FocusableElement): void;
     unregisterElement(element: FocusableElement): void;
     /**
-     * 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(): boolean;
     canFocus(): boolean;

package/navigation/focusable-element.interface.d.ts

@@ -13,26 +13,25 @@ export interface FocusableElement {
     /**
      * Includes or excludes the element from the tab sequence.
      *
-     * @param active If true, the element should receive a tabIndex of 0 (or greater). If false, the tabIndex should be set to -1.
+     * @param active If `true`, sets `tabindex` to `0` or greater. If `false`, sets `tabindex` to `-1`.
      */
     toggle(active: boolean): void;
     /**
-     * Returns true if the element can be focused at the moment, false otherwise.
+     * Returns `true` if the element can be focused at the moment. Returns `false` otherwise.
      *
-     * @returns true if the element can be focused at the moment, false otherwise.
+     * @returns `true` if the element can be focused at the moment. Returns `false` otherwise.
      */
     canFocus(): boolean;
     /**
-     * Focuses the element.
+     * Returns `true` if the element is currently focused.
      */
     hasFocus(): boolean;
     /**
-     * Returns true if the element can receive the focus during cursor navigation.
-     *
-     * For example, if a cell contains a single button, the focus should be placed directly on it.
-     * This allows the user to activate the button directly with Enter.
+     * Returns `true` if the element can receive focus during cursor navigation.
      *
-     * The focus will remain on the cell if it contains more than one navigable element.
+     * For example, if a cell has a single button, focus goes directly to it.
+     * This lets the user activate the button with `Enter`.
+     * If the cell has more than one navigable element, focus stays on the cell.
      */
     isNavigable(): boolean;
 }

package/navigation/focusable.directive.d.ts

@@ -8,21 +8,23 @@ import { CellContext } from '../rendering/common/cell-context';
 import { ContextService } from '../common/provider.service';
 import * as i0 from "@angular/core";
 /**
- * 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 declare class FocusableDirective implements FocusableElement, AfterViewInit, OnDestroy {
     private cellContext;

package/navigation/navigable-settings.d.ts

@@ -6,13 +6,13 @@
  * Represents the possible navigable sections of the Grid ([see example]({% slug keyboard_navigation_grid %}#toc-navigable-sections)).
  *
  * The available values are:
- * * `pager`—Includes the Grid pager and its internal elements
- * * `table`—Includes the Grid pager and its internal elements
- * * `toolbar`—Includes the Grid toolbars and the group panel when the Grid is groupable.
+ * * `pager` — Includes the Grid pager and its internal elements.
+ * * `table` — Includes the Grid table and its internal elements.
+ * * `toolbar` — Includes the Grid toolbars and the group panel when the Grid is groupable.
  *
- * @xample
+ * @example
  * ```html
- * <kendo-grid [navigable]="['pager', 'toolbar']"> </kendo-grid>
+ * <kendo-grid [navigable]="['pager', 'toolbar']"></kendo-grid>
  * ```
  */
 export type GridNavigableSection = 'pager' | 'table' | 'toolbar';
@@ -22,5 +22,10 @@ export type GridNavigableSection = 'pager' | 'table' | 'toolbar';
  * The available values are:
  * * `boolean`
  * * [`GridNavigableSection`](slug:api_grid_gridnavigablesection)
+ *
+ * @example
+ * ```typescript
+ * const settings: GridNavigableSettings = ['pager', 'table'];
+ * ```
  */
 export type GridNavigableSettings = boolean | GridNavigableSection[];

package/navigation/navigation-cell.interface.d.ts

@@ -4,7 +4,7 @@
 *-------------------------------------------------------------------------------------------*/
 import { FocusGroup } from './focus-group';
 /**
- * The metadata for a focusable Grid cell.
+ * Represents the metadata for a focusable Grid cell.
  * Focusable Grid cells include headers, group headers and footers, and data cells.
  */
 export interface NavigationCell {
@@ -13,28 +13,28 @@ export interface NavigationCell {
      */
     uid: number;
     /**
-     * The column index of the cell.
+     * Specifies the column index of the cell.
      */
     colIndex: number;
     /**
-     * The logical index of the row which contains this cell. The row indexing is absolute and does not change with paging.
-     * Group headers and footers are included. Header rows are included, starting at index 0.
+     * Specifies the logical index of the row that contains this cell. The row index is absolute and does not change with paging.
+     * Group headers and footers are included. Header rows start at index `0`.
      */
     rowIndex: number;
     /**
-     * The column span for this cell (if set).
+     * Sets the column span for this cell, if defined.
      */
     colSpan?: number;
     /**
-     * The row span for this cell (if set).
+     * Sets the row span for this cell, if defined.
      */
     rowSpan?: number;
     /**
-     * The data item index for the parent row of this cell.
+     * Specifies the data item index for the parent row of this cell.
      */
     dataRowIndex: number;
     /**
-     * The data item for the parent row of this cell.
+     * Provides the data item for the parent row of this cell.
      */
     dataItem: any;
     /**

package/navigation/navigation-row.interface.d.ts

@@ -5,8 +5,7 @@
 import { NavigationCell } from './navigation-cell.interface';
 import { GroupItem } from '../data/group-item.interface';
 /**
- * The metadata for a focusable Grid row. Focusable rows include
- * headers, group headers and footers, and data rows.
+ * Represents the metadata for a focusable Grid row. Focusable rows include headers, group headers and footers, and data rows.
  */
 export interface NavigationRow {
     /**
@@ -14,20 +13,20 @@ export interface NavigationRow {
      */
     uid: number;
     /**
-     * The logical index of the focusable row. The row indexing is absolute and does not change with paging.
-     * Group headers and footers are included. Header rows are included, starting at index 0.
+     * Specifies the logical index of the focusable row. The row index is absolute and does not change with paging.
+     * Group headers and footers are included. Header rows start at index 0.
      */
     index: number;
     /**
-     * The data item index for this row.
+     * Specifies the data item index for this row.
      */
     dataRowIndex: number;
     /**
-     * The data item for this row.
+     * Provides the data item for this row.
      */
     dataItem: any;
     /**
-     * An array of focusable cells which are associated with this row.
+     * Contains an array of focusable cells associated with this row.
      */
     cells: NavigationCell[];
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@progress/kendo-angular-grid",
-  "version": "19.1.2-develop.3",
+  "version": "19.1.2-develop.5",
   "description": "Kendo UI Grid for Angular - high performance data grid with paging, filtering, virtualization, CRUD, and more.",
   "license": "SEE LICENSE IN LICENSE.md",
   "author": "Progress",
@@ -26,7 +26,7 @@
     "package": {
       "productName": "Kendo UI for Angular",
       "productCode": "KENDOUIANGULAR",
-      "publishDate": 1750152686,
+      "publishDate": 1750431017,
       "licensingDocsUrl": "https://www.telerik.com/kendo-angular-ui/my-license/"
     }
   },
@@ -39,28 +39,28 @@
     "@progress/kendo-data-query": "^1.0.0",
     "@progress/kendo-drawing": "^1.21.0",
     "@progress/kendo-licensing": "^1.5.0",
-    "@progress/kendo-angular-buttons": "19.1.2-develop.3",
-    "@progress/kendo-angular-common": "19.1.2-develop.3",
-    "@progress/kendo-angular-dateinputs": "19.1.2-develop.3",
-    "@progress/kendo-angular-layout": "19.1.2-develop.3",
-    "@progress/kendo-angular-navigation": "19.1.2-develop.3",
-    "@progress/kendo-angular-dropdowns": "19.1.2-develop.3",
-    "@progress/kendo-angular-excel-export": "19.1.2-develop.3",
-    "@progress/kendo-angular-icons": "19.1.2-develop.3",
-    "@progress/kendo-angular-inputs": "19.1.2-develop.3",
-    "@progress/kendo-angular-intl": "19.1.2-develop.3",
-    "@progress/kendo-angular-l10n": "19.1.2-develop.3",
-    "@progress/kendo-angular-label": "19.1.2-develop.3",
-    "@progress/kendo-angular-pager": "19.1.2-develop.3",
-    "@progress/kendo-angular-pdf-export": "19.1.2-develop.3",
-    "@progress/kendo-angular-popup": "19.1.2-develop.3",
-    "@progress/kendo-angular-toolbar": "19.1.2-develop.3",
-    "@progress/kendo-angular-utils": "19.1.2-develop.3",
+    "@progress/kendo-angular-buttons": "19.1.2-develop.5",
+    "@progress/kendo-angular-common": "19.1.2-develop.5",
+    "@progress/kendo-angular-dateinputs": "19.1.2-develop.5",
+    "@progress/kendo-angular-layout": "19.1.2-develop.5",
+    "@progress/kendo-angular-navigation": "19.1.2-develop.5",
+    "@progress/kendo-angular-dropdowns": "19.1.2-develop.5",
+    "@progress/kendo-angular-excel-export": "19.1.2-develop.5",
+    "@progress/kendo-angular-icons": "19.1.2-develop.5",
+    "@progress/kendo-angular-inputs": "19.1.2-develop.5",
+    "@progress/kendo-angular-intl": "19.1.2-develop.5",
+    "@progress/kendo-angular-l10n": "19.1.2-develop.5",
+    "@progress/kendo-angular-label": "19.1.2-develop.5",
+    "@progress/kendo-angular-pager": "19.1.2-develop.5",
+    "@progress/kendo-angular-pdf-export": "19.1.2-develop.5",
+    "@progress/kendo-angular-popup": "19.1.2-develop.5",
+    "@progress/kendo-angular-toolbar": "19.1.2-develop.5",
+    "@progress/kendo-angular-utils": "19.1.2-develop.5",
     "rxjs": "^6.5.3 || ^7.0.0"
   },
   "dependencies": {
     "tslib": "^2.3.1",
-    "@progress/kendo-angular-schematics": "19.1.2-develop.3",
+    "@progress/kendo-angular-schematics": "19.1.2-develop.5",
     "@progress/kendo-common": "^1.0.1",
     "@progress/kendo-file-saver": "^1.0.0"
   },

package/pdf/pdf-command-tool.directive.d.ts

@@ -9,24 +9,21 @@ import { ContextService } from '../common/provider.service';
 import { ToolbarToolBase } from '../common/toolbar-tool-base.directive';
 import * as i0 from "@angular/core";
 /**
- * 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 declare class PDFCommandToolbarDirective extends ToolbarToolBase {
     private pdfService;

package/pdf/pdf-command.directive.d.ts

@@ -8,21 +8,17 @@ import { ContextService } from '../common/provider.service';
 import { PDFService } from './pdf.service';
 import * as i0 from "@angular/core";
 /**
- * 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/pdf/pdf-export-event.d.ts

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

package/pdf/pdf-margin.component.d.ts

@@ -6,12 +6,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 declare class PDFMarginComponent extends PDFExportMarginComponent {
     static ɵfac: i0.ɵɵFactoryDeclaration<PDFMarginComponent, never>;

package/pdf/pdf-margin.interface.d.ts

@@ -4,8 +4,8 @@
 *-------------------------------------------------------------------------------------------*/
 import { pdf } from '@progress/kendo-drawing';
 /**
- * Specifies the margins of the page (numbers or strings with units).
- *
+ * Defines the page margins for the PDF export.
+ * Accepts numbers or strings with units.
  */
 export interface PDFMargin extends pdf.PageMargin {
 }

package/pdf/pdf-template.directive.d.ts

@@ -6,12 +6,12 @@ import { 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/pdf/pdf.component.d.ts

@@ -14,7 +14,18 @@ import { PDFExportComponent } from '@progress/kendo-angular-pdf-export';
 import { ContextService } from '../common/provider.service';
 import * as i0 from "@angular/core";
 /**
- * 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 declare class PDFComponent extends PDFExportComponent implements OnDestroy {
     protected pdfService: PDFService;
@@ -22,13 +33,12 @@ export declare class PDFComponent extends PDFExportComponent implements OnDestro
     protected ngZone: NgZone;
     private ctx;
     /**
-     * Exports all Grid pages, starting from the first one.
+     * Exports all Grid pages, starting from the first page.
      */
     allPages: boolean;
     /**
-     * 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/pdf/pdf.module.d.ts

@@ -10,12 +10,11 @@ import * as i4 from "./pdf-command.directive";
 import * as i5 from "./pdf-template.directive";
 import * as i6 from "./pdf-command-tool.directive";
 /**
- * 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';
@@ -26,9 +25,7 @@ import * as i6 from "./pdf-command-tool.directive";
  *     imports:      [BrowserModule, GridModule, PDFModule],
  *     bootstrap:    [AppComponent]
  * })
- *
  * export class AppModule {}
- *
  * ```
  */
 export declare class PDFModule {

package/rendering/cell-loading.template.directive.d.ts

@@ -5,14 +5,11 @@
 import { TemplateRef } 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/rendering/cell-template.directive.d.ts

@@ -5,15 +5,14 @@
 import { TemplateRef } 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/rendering/common/row-args.d.ts

@@ -4,6 +4,8 @@
 *-------------------------------------------------------------------------------------------*/
 /**
  * Represents a data row with an associated data item.
+ *
+ * Use this interface to access the data item and index for a row.
  */
 export interface RowArgs {
     /**

package/rendering/common/row-class.d.ts

@@ -4,34 +4,32 @@
 *-------------------------------------------------------------------------------------------*/
 import { RowArgs } from './row-args';
 /**
- * Represents the callback arguments that are used by the
- * [rowClass]({% slug api_grid_gridcomponent %}#toc-rowClass) property.
+ * Represents the callback arguments used by the [`rowClass`]({% slug api_grid_gridcomponent %}#toc-rowClass) property.
  */
 export interface RowClassArgs extends RowArgs {
 }
 /**
- * Represents the callback that is used by the
- * [rowClass]({% slug api_grid_gridcomponent %}#toc-rowclass) property.
+ * Represents the callback used by the [`rowClass`]({% slug api_grid_gridcomponent %}#toc-rowclass) property.
  *
- * ```ts
- *  rowCallback({ dataItem, index }) {
- *    const isEven = index % 2 === 0;
- *    return {
- *      even: isEven,
- *      odd: !isEven
- *    };
- *  }
+ * @example
+ * ```typescript
+ * rowCallback({ dataItem, index }) {
+ *   const isEven = index % 2 === 0;
+ *   return {
+ *     even: isEven,
+ *     odd: !isEven
+ *   };
+ * }
  * ```
- *
  */
 export type RowClassFn = (context: RowClassArgs) => string | string[] | Set<string> | {
     [key: string]: any;
 };
 /**
- * Represents the callback that is used by the
- * [rowSelected]({% slug api_grid_gridcomponent %}#toc-rowselected) property.
+ * Represents the callback used by the [`rowSelected`]({% slug api_grid_gridcomponent %}#toc-rowselected) property.
  *
- * ```ts
+ * @example
+ * ```typescript
  * rowCallback({ dataItem, index }) {
  *   return index % 2 === 0;
  * }
@@ -39,10 +37,10 @@ export type RowClassFn = (context: RowClassArgs) => string | string[] | Set<stri
  */
 export type RowSelectedFn = (context: RowArgs) => boolean;
 /**
- * Represents the callback that is used to determine whether a given data row will be selectable. Used by the
- * [isRowSelectable]({% slug api_grid_gridcomponent %}#toc-isrowselectable) property.
+ * Represents the callback used to determine whether a data row is selectable. Used by the [`isRowSelectable`]({% slug api_grid_gridcomponent %}#toc-isrowselectable) property.
  *
- * ```ts
+ * @example
+ * ```typescript
  * isRowSelectableCallback({ dataItem, index }) {
  *   return index % 2 === 0;
  * }
@@ -50,9 +48,10 @@ export type RowSelectedFn = (context: RowArgs) => boolean;
  */
 export type RowSelectableFn = (context: RowArgs) => boolean;
 /**
- * Represents the callback that is used to determine whether a given data row will be sticky.
+ * Represents the callback used to determine whether a data row is sticky.
  *
- * ```ts
+ * @example
+ * ```typescript
  * rowStickyCallback({ dataItem, index }) {
  *   return index % 2 === 0;
  * }

package/rendering/common/spacer.component.d.ts

@@ -9,6 +9,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 declare class GridSpacerComponent {
     hostClass: boolean;
@@ -16,9 +28,8 @@ export declare class GridSpacerComponent {
     get flexBasisStyle(): string;
     /**
      * 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: string;
     static ɵfac: i0.ɵɵFactoryDeclaration<GridSpacerComponent, never>;