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

package/localization/custom-messages.component.d.ts

@@ -6,8 +6,21 @@ import { LocalizationService } from '@progress/kendo-angular-l10n';
 import { PivotGridMessages } from './messages';
 import * as i0 from "@angular/core";
 /**
- * Custom component messages override default component messages
+ * Represents the custom messages component of the PivotGrid.
+ *
+ * Use this component to override default messages for the PivotGrid.
  * ([see example]({% slug globalization_pivotgrid %}#toc-custom-messages)).
+ *
+ * @example
+ * ```html
+ * <kendo-pivotgrid>
+ *     <kendo-pivotgrid-messages
+ *         configuratorButtonText="Configure"
+ *         configuratorHeaderText="PivotGrid Settings"
+ *         configuratorApplyButtonText="Apply Changes">
+ *     </kendo-pivotgrid-messages>
+ * </kendo-pivotgrid>
+ * ```
  */
 export declare class CustomMessagesComponent extends PivotGridMessages {
     protected service: LocalizationService;

package/localization/messages.d.ts

@@ -9,200 +9,164 @@ import * as i0 from "@angular/core";
  */
 export declare class PivotGridMessages extends ComponentMessages {
     /**
-     * The text content of the filter item in the column and row fields menu.
+     * Sets the text content of the filter item in the column and row fields menu.
      */
     fieldMenuFilterItemLabel: string;
     /**
-     * The text content of the sort ascending item in the column and row fields menu.
+     * Specifies the text content of the sort ascending item in the column and row fields menu.
      */
     fieldMenuSortAscendingItemLabel: string;
     /**
-     * The text content of the sort descending item in the column and row fields menu.
+     * Sets the text content of the sort descending item in the column and row fields menu.
      */
     fieldMenuSortDescendingItemLabel: string;
     /**
-     * The label of the filter input.
+     * Defines the label of the filter input.
      *
-     * The filter input label consists of a two-part message - the name(s) of the fields and a localizable string.
-     * For fields named '[Geography][City]', the default label will be 'Geography City Filter'.
+     * The filter input label has two parts—the field name(s) and a localizable string.
+     * For fields named `'[Geography][City]'`, the default label will be `'Geography City Filter'`.
      *
-     * To allow reordering the field name(s) and the localizable part, the filterInputLabel accepts a string with a
-     * placeholder for the fields - e.g. 'filter for {fields}'. The '{fields}' placeholder will be replaced
-     * internally with the current field(s) name(s), and the resulting label will be rendered as 'filter for Geography City'.
-     *
-     * @example
-     *
-     * ```ts-no-run
-     *      <kendo-pivotgrid>
-     *          <kendo-pivotgrid-messages
-     *              filterInputLabel="filter for {fields}"
-     *          >
-     *          </kendo-pivotgrid-messages>
-     *      </kendo-pivotgrid>
-     *  ```
+     * You can reorder the parts using `'{fields}'` as a placeholder. The `'{fields}'` placeholder will get replaced
+     * with the field name(s). For example, `'filter for {fields}'` will become `'filter for Geography City'`.
      */
     filterInputLabel: string;
     /**
-     * The label of the filter operators DropDownList.
-     *
-     * The label consists of a two-part message - the name(s) of the fields and a localizable string.
-     * For fields named '[Geography][City]', the default label will be 'Geography City Filter Operators'.
+     * Specifies the label of the filter operators DropDownList.
      *
-     * To allow reordering the field name(s) and the localizable part, the filterMenuOperatorsDropDownLabel accepts a string with a
-     * placeholder for the fields - e.g. 'filter operators for {fields}'. The '{fields}' placeholder will be replaced
-     * internally with the current field(s) name(s), and the resulting label will be rendered as 'filter operators for Geography City'.
+     * The label has two parts&mdash;the field name(s) and a localizable string.
+     * For fields named `'[Geography][City]'`, the default label will be `'Geography City Filter Operators'`.
      *
-     * @example
-     *
-     * ```ts-no-run
-     *      <kendo-pivotgrid>
-     *          <kendo-pivotgrid-messages
-     *              filterMenuOperatorsDropDownLabel="filter operators for {fields}"
-     *          >
-     *          </kendo-pivotgrid-messages>
-     *      </kendo-pivotgrid>
-     *  ```
+     * You can reorder the parts using `'{fields}'` as a placeholder. The `'{fields}'` placeholder will get replaced
+     * with the field name(s). For example, `'filter operators for {fields}'` will become `'filter operators for Geography City'`.
      */
     filterOperatorsDropDownLabel: string;
     /**
-     * The text of the `Equal` (**Is equal to**) filter operator.
+     * Sets the text of the `Equal` (**Is equal to**) filter operator.
      */
     filterEqOperator: string;
     /**
-     * The text of the `NotEqual` (**Is not equal to**) filter operator.
+     * Specifies the text of the `NotEqual` (**Is not equal to**) filter operator.
      */
     filterNotEqOperator: string;
     /**
-     * The text of the `IsNull` (**Is null**) filter operator.
+     * Specifies the text of the `IsNull` (**Is null**) filter operator.
      */
     filterIsNullOperator: string;
     /**
-     * The text of the `IsNotNull` (**Is not null**) filter operator.
+     * Sets the text of the `IsNotNull` (**Is not null**) filter operator.
      */
     filterIsNotNullOperator: string;
     /**
-     * The text of the `IsEmpty` (**Is empty**) filter operator.
+     * Specifies the text of the `IsEmpty` (**Is empty**) filter operator.
      */
     filterIsEmptyOperator: string;
     /**
-     * The text of the `IsNotEmpty` (**Is not empty**) filter operator.
+     * Specifies the text of the `IsNotEmpty` (**Is not empty**) filter operator.
      */
     filterIsNotEmptyOperator: string;
     /**
-     * The text of the `StartsWith` (**Starts with**) filter operator.
+     * Sets the text of the `StartsWith` (**Starts with**) filter operator.
      */
     filterStartsWithOperator: string;
     /**
-     * The text of the `Contains` (**Contains**) filter operator.
+     * Sets the text of the `Contains` (**Contains**) filter operator.
      */
     filterContainsOperator: string;
     /**
-     * The text of the `DoesNotContain` (**Does not contain**) filter operator.
+     * Specifies the text of the `DoesNotContain` (**Does not contain**) filter operator.
      */
     filterNotContainsOperator: string;
     /**
-     * The text of the `EndsWith` (**Ends with**) string filter operator.
+     * Specifies the text of the `EndsWith` (**Ends with**) string filter operator.
      */
     filterEndsWithOperator: string;
     /**
-     * The text of the **Filter** button.
+     * Sets the text of the **Filter** button.
      */
     filterFilterButton: string;
     /**
-     * The text of the **Clear filter** button.
+     * Sets the text of the **Clear filter** button.
      */
     filterClearButton: string;
     /**
-     * The loading text.
+     * Specifies the loading text.
      *
      * > The `loading` property is part of the accessibility support of the PivotGrid.
-     * Its value is detectable by screen readers and is not otherwise visible.
+     * Its value is detectable by screen readers and is not visible otherwise.
      */
     loading: string;
     /**
-     * The value of the aria-label attribute placed on the PivotGrid focusable empty cell element.
+     * Specifies the value of the aria-label attribute placed on the PivotGrid focusable empty cell element.
      */
     emptyCellLabel: string;
     /**
-     * The text content of the button that opens and closes the PivotGrid configurator.
+     * Sets the text content of the button that opens and closes the PivotGrid configurator.
      */
     configuratorButtonText: string;
     /**
-     * The text content of the PivotGrid configurator title element.
+     * Sets the text content of the PivotGrid configurator title element.
      */
     configuratorHeaderText: string;
     /**
-     * The text content of the PivotGrid configurator fields section title element.
+     * Sets the text content of the PivotGrid configurator fields section title element.
      */
     configuratorFieldsText: string;
     /**
-     * The text content of the PivotGrid configurator columns section title element.
+     * Sets the text content of the PivotGrid configurator columns section title element.
      */
     configuratorColumnsText: string;
     /**
-     * The text content of the PivotGrid configurator rows section title element.
+     * Specifies the text content of the PivotGrid configurator rows section title element.
      */
     configuratorRowsText: string;
     /**
-     * The text content of the PivotGrid configurator values section title element.
+     * Specifies the text content of the PivotGrid configurator values section title element.
      */
     configuratorValuesText: string;
     /**
-     * The text content of the PivotGrid configurator Cancel button.
+     * Sets the text content of the PivotGrid configurator **Cancel** button.
      */
     configuratorCancelButtonText: string;
     /**
-     * The text content of the PivotGrid configurator Apply button.
+     * Specifies the text content of the PivotGrid configurator **Apply** button.
      */
     configuratorApplyButtonText: string;
     /**
-     * The text content of the PivotGrid configurator empty rows container.
+     * Sets the text content of the PivotGrid configurator empty rows container.
      */
     configuratorEmptyRowsText: string;
     /**
-     * The text content of the PivotGrid configurator empty columns container.
+     * Sets the text content of the PivotGrid configurator empty columns container.
      */
     configuratorEmptyColumnsText: string;
     /**
-     * The text content of the PivotGrid configurator empty measures container.
+     * Sets the text content of the PivotGrid configurator empty measures container.
      */
     configuratorEmptyMeasuresText: string;
     /**
-     * The text content of the Move to Columns item in the column and row fields menu.
+     * Sets the text content of the **Move to Columns** item in the column and row fields menu.
      */
     fieldMenuMoveToColumnsItem: string;
     /**
-     * The text content of the Move to Rows item in the column and row fields menu.
+     * Specifies the text content of the **Move to Rows** item in the column and row fields menu.
      */
     fieldMenuMoveToRowsItem: string;
     /**
-     * The text content of the Move as previous item in the column, row, and value fields menu.
+     * Specifies the text content of the **Move as previous** item in the column, row, and value fields menu.
      */
     fieldMenuMovePreviousItem: string;
     /**
-     * The text content of the Move as next item in the column, row, and value fields menu.
+     * Specifies the text content of the **Move as next** item in the column, row, and value fields menu.
      */
     fieldMenuMoveNextItem: string;
     /**
-     * The title of the chip menu icon.
-     *
-     * The title consists of a two-part message - the name of the chip and a localizable string.
-     * For a field named 'Product', the default title will be 'Product Field Menu'.
-     *
-     * To allow reordering the field name and the localizable part, the chipMenu accepts a string with a
-     * placeholder for the chip name - e.g. 'chip for {fieldName}'. The '{fieldName}' placeholder will be replaced
-     * internally with the current chip name, and the resulting title will be rendered as 'Product Field Menu'.
+     * Controls the title of the chip menu icon.
      *
-     * @example
+     * The title has two parts&mdash;the chip name and a localizable string.
+     * For a field named `'Product'`, the default title will be `'Product Field Menu'`.
      *
-     * ```ts-no-run
-     *      <kendo-pivotgrid>
-     *          <kendo-pivotgrid-messages
-     *              chipMenuIconTitle="'{fieldName} Field Menu'"
-     *          >
-     *          </kendo-pivotgrid-messages>
-     *      </kendo-pivotgrid>
-     *  ```
+     * You can reorder the parts using `'{fieldName}'` as a placeholder. The `'{fieldName}'` placeholder will get replaced
+     * with the current chip name. For example, `'chip for {fieldName}'` will become `'chip for Product Field Menu'`.
      */
     chipMenuIconTitle: string;
     static ɵfac: i0.ɵɵFactoryDeclaration<PivotGridMessages, never>;

package/models/configuration-change-event.d.ts

@@ -6,27 +6,27 @@ import { PreventableEvent } from "@progress/kendo-angular-common";
 import { FilterDescriptor, SortDescriptor } from "@progress/kendo-data-query";
 import { PivotGridAxis } from "@progress/kendo-pivotgrid-common";
 /**
- * The event data for the ConfigurationChangeEvent
+ * Represents the event data for the `configurationChange` event.
  */
 export declare class ConfigurationChangeEvent extends PreventableEvent {
     /**
-     * The current row axes configuration, resulting from the end user interaction.
+     * Specifies the current row axes configuration that results from user interaction.
      */
     rowAxes: PivotGridAxis[];
     /**
-     * The current column axes configuration, resulting from the end user interaction.
+     * Specifies the current column axes configuration that results from user interaction.
      */
     columnAxes: PivotGridAxis[];
     /**
-     * The measure axes configuration.
+     * Provides the measure axes configuration.
      */
     measureAxes: PivotGridAxis[];
     /**
-     * The sorting configuration.
+     * Provides the sorting configuration.
      */
     sort?: SortDescriptor[];
     /**
-     * The filtering configuration.
+     * Provides the filtering configuration.
      */
     filter?: FilterDescriptor[];
     /**

package/models/configurator-position.d.ts

@@ -3,7 +3,7 @@
 * Licensed under commercial license. See LICENSE.md in the project root for more information
 *-------------------------------------------------------------------------------------------*/
 /**
- * Sets the configurator position in the container.
+ * Specifies the Configurator position in the container.
  *
  * @default 'right'
  */

package/models/configurator-settings.d.ts

@@ -7,18 +7,18 @@ import { PivotGridAxis } from "@progress/kendo-pivotgrid-common";
 import { PivotGridConfiguratorOrientation } from "./configurator-orientation";
 import { PivotGridConfiguratorPosition } from "./configurator-position";
 /**
- * Allows customizing the PivotGrid Configurator layout.
+ * Represents the available settings for the PivotGrid Configurator layout.
  */
 export interface ConfiguratorSettings {
     /**
-     * Sets the configurator position in the container.
+     * Specifies the Configurator position in the container.
      *
      * @default 'right'
      */
     position?: PivotGridConfiguratorPosition;
     /**
-     * Determines whether the layout orientation of the Configurator inner elements
-     * will be horizontal or vertical.
+     * Specifies whether the layout orientation of the Configurator inner elements
+     * is horizontal or vertical.
      *
      * @default 'vertical'
      */

package/models/data-row-item.d.ts

@@ -4,15 +4,15 @@
 *-------------------------------------------------------------------------------------------*/
 import { PivotDataItem } from "@progress/kendo-pivotgrid-common";
 /**
- * The event data for DataLoadedEvent.
+ * Represents the event data for `dataLoaded` event.
  */
 export interface PivotDataRowItem {
     /**
-     * The row hierarchy.
+     * Provides the row hierarchy.
      */
     row: string[];
     /**
-     * The aggregated cell data.
+     * Provides the aggregated cell data.
      */
     cells: PivotDataItem[];
 }

package/models/expanded-change-event.d.ts

@@ -5,19 +5,19 @@
 import { PreventableEvent } from "@progress/kendo-angular-common";
 import { PivotGridAxis } from "@progress/kendo-pivotgrid-common";
 /**
- * The event data for the ExpandChangeEvent
+ * Represents the event data for the `expandChange` event.
  */
 export declare class ExpandChangeEvent extends PreventableEvent {
     /**
-     * The current row axes configuration, resulting from the end user interaction.
+     * Provides the current row axes configuration that results from user interaction.
      */
     rowAxes: PivotGridAxis[];
     /**
-     * The current column axes configuration, resulting from the end user interaction.
+     * Provides the current column axes configuration that results from user interaction.
      */
     columnAxes: PivotGridAxis[];
     /**
-     * The measure axes configuration.
+     * Provides the measure axes configuration.
      */
     measureAxes: PivotGridAxis[];
     /**

package/models/loader-settings.d.ts

@@ -4,19 +4,19 @@
 *-------------------------------------------------------------------------------------------*/
 import { LoaderSize as LoaderSizeSource, LoaderThemeColor as LoaderThemeColorSource, LoaderType as LoaderTypeSource } from '@progress/kendo-angular-indicators';
 /**
- * Specifies the size of the PivotGrid's loader.
+ * Specifies the size of the PivotGrid loader.
  *
  * The available values are:
  * * `small`
  * * `medium`
- * * `large`(Default)
+ * * `large`
  */
 export declare type LoaderSize = Partial<LoaderSizeSource>;
 /**
- * Specifies the theme color of the PivotGrid's loader.
+ * Specifies the theme color of the PivotGrid loader.
  *
  * The available values are:
- * * `primary`(Default)&mdash;Applies coloring based on primary theme color.
+ * * `primary`&mdash;Applies coloring based on primary theme color.
  * * `secondary`&mdash;Applies coloring based on secondary theme color.
  * * `tertiary`&mdash;Applies coloring based on tertiary theme color.
  * * `info`&mdash;Applies coloring based on info theme color.
@@ -29,19 +29,31 @@ export declare type LoaderSize = Partial<LoaderSizeSource>;
  */
 export declare type LoaderThemeColor = Partial<LoaderThemeColorSource>;
 /**
- * Specifies the theme color of the PivotGrid's loader.
+ * Specifies the type of the PivotGrid loader.
  *
  * The available values are:
  * * `pulsing`
  * * `infinite-spinner`
- * * `converging-spinner`(Default)
+ * * `converging-spinner`
  */
 export declare type LoaderType = Partial<LoaderTypeSource>;
 /**
- * Specifies the type, size and color of the PivotGrid's loader.
+ * Specifies the type, size, and color of the PivotGrid loader.
  */
 export interface LoaderSettings {
+    /**
+     * Specifies the size of the loader.
+     * @default 'large'
+     */
     size?: LoaderSize;
+    /**
+     * Specifies the theme color of the loader.
+     * @default 'primary'
+     */
     themeColor?: LoaderThemeColor;
+    /**
+     * Specifies the type of the loader.
+     * @default 'converging-spinner'
+     */
     type?: LoaderType;
 }

package/models/virtualization-settings.d.ts

@@ -3,13 +3,22 @@
 * Licensed under commercial license. See LICENSE.md in the project root for more information
 *-------------------------------------------------------------------------------------------*/
 /**
- * The supported values of the [`VirtualizationSettings`]({% slug api_pivotgrid_virtualizationsettings %}) `type` property - `row`, `column` or `both`.
+ * Specifies the supported values of the [`VirtualizationSettings`](slug:api_pivotgrid_virtualizationsettings) `type` property.
+ *
+ * The available values are:
+ * * `row`—Enables row virtualization only.
+ * * `column`—Enables column virtualization only.
+ * * `both`—Enables both row and column virtualization.
  */
 export type PivotGridVirtualizationSettingsType = 'row | column | both';
+/**
+ * Represents the virtualization settings for the PivotGrid data table.
+ * Controls how many rows and columns are rendered in the DOM to improve performance with large datasets.
+ */
 export interface VirtualizationSettings {
     /**
-     * Enables the virtualization of the PivotGrid data table. By default both rows and columns are virtualized when the virtualization is enabled.
-     * @default `both`
+     * Specifies the virtualization type for the PivotGrid data table. When virtualization is enabled, both rows and columns are virtualized by default.
+     * @default 'both'
      */
     type?: PivotGridVirtualizationSettingsType;
     /**
@@ -18,12 +27,12 @@ export interface VirtualizationSettings {
      */
     rowHeight?: number;
     /**
-     * Sets the maximum number of value table rows that will be rendered in the DOM.
+     * Specifies the maximum number of value table rows that render in the DOM.
      * @default 50
      */
     rows?: number;
     /**
-     * Sets the maximum number of value table columns that will be rendered in the DOM.
+     * Specifies the maximum number of value table columns that render in the DOM.
      * @default 10
      */
     columns?: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@progress/kendo-angular-pivotgrid",
-  "version": "19.1.2-develop.4",
+  "version": "19.1.2-develop.5",
   "description": "PivotGrid package for Angular",
   "license": "SEE LICENSE IN LICENSE.md",
   "author": "Progress",
@@ -18,7 +18,7 @@
     "package": {
       "productName": "Kendo UI for Angular",
       "productCode": "KENDOUIANGULAR",
-      "publishDate": 1750157217,
+      "publishDate": 1750431130,
       "licensingDocsUrl": "https://www.telerik.com/kendo-angular-ui/my-license/?utm_medium=product&utm_source=kendoangular&utm_campaign=kendo-ui-angular-purchase-license-keys-warning"
     }
   },
@@ -31,21 +31,21 @@
     "@progress/kendo-data-query": "^1.5.5",
     "@progress/kendo-drawing": "^1.21.0",
     "@progress/kendo-licensing": "^1.5.0",
-    "@progress/kendo-angular-buttons": "19.1.2-develop.4",
-    "@progress/kendo-angular-common": "19.1.2-develop.4",
-    "@progress/kendo-angular-dropdowns": "19.1.2-develop.4",
-    "@progress/kendo-angular-indicators": "19.1.2-develop.4",
-    "@progress/kendo-angular-inputs": "19.1.2-develop.4",
-    "@progress/kendo-angular-intl": "19.1.2-develop.4",
-    "@progress/kendo-angular-l10n": "19.1.2-develop.4",
-    "@progress/kendo-angular-popup": "19.1.2-develop.4",
-    "@progress/kendo-angular-icons": "19.1.2-develop.4",
-    "@progress/kendo-angular-treeview": "19.1.2-develop.4",
+    "@progress/kendo-angular-buttons": "19.1.2-develop.5",
+    "@progress/kendo-angular-common": "19.1.2-develop.5",
+    "@progress/kendo-angular-dropdowns": "19.1.2-develop.5",
+    "@progress/kendo-angular-indicators": "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-popup": "19.1.2-develop.5",
+    "@progress/kendo-angular-icons": "19.1.2-develop.5",
+    "@progress/kendo-angular-treeview": "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.4",
+    "@progress/kendo-angular-schematics": "19.1.2-develop.5",
     "@progress/kendo-pivotgrid-common": "0.6.3"
   },
   "schematics": "./schematics/collection.json",

package/pivotgrid.component.d.ts

@@ -19,7 +19,24 @@ import { VirtualizationSettings } from './models/virtualization-settings';
 import { PivotGridScrollService } from './virtual/scroll.service';
 import * as i0 from "@angular/core";
 /**
- * Represents the Kendo UI PivotGrid component for Angular.
+ * Represents the [Kendo UI PivotGrid component for Angular](slug:overview_pivotgrid).
+ *
+ * @example
+ * ```html
+ * <kendo-pivotgrid
+ *    [kendoPivotLocalBinding]="data"
+ *    [dimensions]="dimensions"
+ *    [measures]="measures"
+ *    [rowAxes]="defaultRowAxes"
+ *    [columnAxes]="defaultColumnAxes"
+ *    [measureAxes]="defaultMeasureAxes"
+ *    [configurator]="true"
+ *  >
+ * </kendo-pivotgrid>
+ * ```
+ *
+ * @remarks
+ * Supported children components are: {@link CustomMessagesComponent}
  */
 export declare class PivotGridComponent implements AfterViewInit, AfterContentInit, OnDestroy {
     private hostEl;
@@ -44,12 +61,7 @@ export declare class PivotGridComponent implements AfterViewInit, AfterContentIn
     rowHeaderCellTemplate: RowHeaderCellTemplateDirective;
     columnHeaderCellTemplate: ColumnHeaderCellTemplateDirective;
     /**
-     * Specify the type, size and color of the PivotGrid's loader.
-     *
-     * The default settings are:
-     * * type: `converging-spinner`
-     * * color: `primary`
-     * * size: `large`
+     * Sets the type, size, and color of the PivotGrid loader.
      */
     set loaderSettings(settings: LoaderSettings);
     get loaderSettings(): LoaderSettings;
@@ -58,11 +70,13 @@ export declare class PivotGridComponent implements AfterViewInit, AfterContentIn
      */
     get loadingText(): string;
     /**
-     * Specifies whether the axes configurator should be displayed.
+     * Controls whether the axes configurator is displayed.
+     *
+     * @default false
      */
     configurator: boolean | ConfiguratorSettings;
     /**
-     * Sets the virtualization options of the component. By default the virtual scrolling functionality is disabled.
+     * Sets the virtualization options of the component. By default, the virtual scrolling functionality is disabled.
      *
      * @default false
      */
@@ -70,20 +84,20 @@ export declare class PivotGridComponent implements AfterViewInit, AfterContentIn
     get virtualScrolling(): VirtualizationSettings;
     get configuratorSettings(): ConfiguratorSettings;
     /**
-     * Specify the width of the column header and data cells. Value is treated as pixels [(see example)]({% slug appearance_pivotgrid %}#toc-column-headers-width).
+     * Sets the width of the column header and data cells. The provided value is treated in pixels [(see example)]({% slug appearance_pivotgrid %}#toc-column-headers-width).
      *
      * @default 200
      */
     columnHeadersWidth: number;
     /**
-     * When the keyboard navigation is enabled, the user can use dedicated shortcuts to interact with the PivotGrid.
-     * By default, navigation is enabled. To disable it altogether, and include the PivotGrid content in the normal tab sequence, set the property to `false`.
+     * Specifies whether the keyboard navigation is enabled. When enabled, you can use keyboard shortcuts to interact with the PivotGrid.
+     * Set to `false` to disable navigation and include the PivotGrid content in the normal tab sequence.
      *
      * @default true
      */
     navigable: boolean;
     /**
-     * Holds the displayed aggregated PivotGrid values.
+     * Gets the aggregated PivotGrid values that are displayed.
      */
     get aggregateData(): PivotDataRowItem[];
     /**