@progress/kendo-angular-pager 19.1.1-develop.2 → 19.1.2-develop.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@progress/kendo-angular-pager",
-  "version": "19.1.1-develop.2",
+  "version": "19.1.2-develop.1",
   "description": "Kendo UI Angular Pager",
   "license": "SEE LICENSE IN LICENSE.md",
   "author": "Progress",
@@ -17,7 +17,7 @@
     "package": {
       "productName": "Kendo UI for Angular",
       "productCode": "KENDOUIANGULAR",
-      "publishDate": 1749196687,
+      "publishDate": 1749804270,
       "licensingDocsUrl": "https://www.telerik.com/kendo-angular-ui/my-license/"
     }
   },
@@ -27,16 +27,16 @@
     "@angular/core": "16 - 20",
     "@angular/platform-browser": "16 - 20",
     "@progress/kendo-licensing": "^1.5.0",
-    "@progress/kendo-angular-common": "19.1.1-develop.2",
-    "@progress/kendo-angular-dropdowns": "19.1.1-develop.2",
-    "@progress/kendo-angular-inputs": "19.1.1-develop.2",
-    "@progress/kendo-angular-icons": "19.1.1-develop.2",
-    "@progress/kendo-angular-l10n": "19.1.1-develop.2",
+    "@progress/kendo-angular-common": "19.1.2-develop.1",
+    "@progress/kendo-angular-dropdowns": "19.1.2-develop.1",
+    "@progress/kendo-angular-inputs": "19.1.2-develop.1",
+    "@progress/kendo-angular-icons": "19.1.2-develop.1",
+    "@progress/kendo-angular-l10n": "19.1.2-develop.1",
     "rxjs": "^6.5.3 || ^7.0.0"
   },
   "dependencies": {
     "tslib": "^2.3.1",
-    "@progress/kendo-angular-schematics": "19.1.1-develop.2"
+    "@progress/kendo-angular-schematics": "19.1.2-develop.1"
   },
   "schematics": "./schematics/collection.json",
   "module": "fesm2022/progress-kendo-angular-pager.mjs",

package/pager/common/pager-type.d.ts

@@ -3,17 +3,15 @@
 * Licensed under commercial license. See LICENSE.md in the project root for more information
 *-------------------------------------------------------------------------------------------*/
 /**
- * The type of the Pager.
+ * Specifies the type of the `Pager`.
  *
  * The available values are:
- * * `numeric`—Buttons with numbers.
- * * `input`—Input for typing the page number.
+ * * `numeric`—Displays buttons with numbers.
+ * * `input`—Displays an input field for typing the page number.
  *
  * @example
- * ```html-no-run
- *
- * <kendo-pager
- *    type="input">
+ * ```html
+ * <kendo-pager type="input">
  * </kendo-pager>
  * ```
  */

package/pager/focusable.directive.d.ts

@@ -6,7 +6,16 @@ import { ElementRef, OnDestroy, OnInit, Renderer2 } from '@angular/core';
 import { PagerNavigationService } from './navigation.service';
 import * as i0 from "@angular/core";
 /**
- * Place the directive on custom focusable elements in the [`kendoPagerTemplate`]({% slug api_pager_pagertemplatedirective %}) to include them in the built-in Pager keyboard navigation.
+ * Represents the Kendo UI Pager focusable directive for Angular. Apply this directive to custom focusable elements in the [`kendoPagerTemplate`]({% slug api_pager_pagertemplatedirective %}) to include them in the built-in Pager keyboard navigation.
+ *
+ * @example
+ * ```html
+ * <kendo-pager [skip]="skip" [pageSize]="pageSize" [total]="total">
+ *   <ng-template kendoPagerTemplate>
+ *     <button kendoPagerFocusable type="button">Custom Button</button>
+ *   </ng-template>
+ * </kendo-pager>
+ * ```
  */
 export declare class PagerFocusableDirective implements OnInit, OnDestroy {
     private navigationService;

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

@@ -6,8 +6,19 @@ import { LocalizationService } from '@progress/kendo-angular-l10n';
 import { Messages } from './messages';
 import * as i0 from "@angular/core";
 /**
- * Custom component messages override default component messages
+ * Represents the Kendo UI Pager custom messages component for Angular. Use this component to override default component messages
  * ([see example]({% slug pager_globalization %}#toc-messages)).
+ *
+ * @example
+ * ```html
+ * <kendo-pager [skip]="skip" [pageSize]="pageSize" [total]="total">
+ *   <kendo-pager-messages
+ *     previousNext="Previous/Next"
+ *     page="Page"
+ *     of="of">
+ *   </kendo-pager-messages>
+ * </kendo-pager>
+ * ```
  */
 export declare class CustomMessagesComponent extends Messages {
     protected service: LocalizationService;

package/pager/pager-info.component.d.ts

@@ -8,7 +8,16 @@ import { LocalizationService } from '@progress/kendo-angular-l10n';
 import { PagerContextService, PagerContextChanges } from "./pager-context.service";
 import * as i0 from "@angular/core";
 /**
- * Displays information about the current page and the total number of records ([see example]({% slug pager_settings %})).
+ * Represents the Kendo UI Pager Info component for Angular. Displays information about the current page and the total number of records ([see example]({% slug pager_settings %})).
+ *
+ * @example
+ * ```html
+ * <kendo-pager [skip]="skip" [pageSize]="pageSize" [total]="total">
+ *   <ng-template kendoPagerTemplate>
+ *     <kendo-pager-info></kendo-pager-info>
+ *   </ng-template>
+ * </kendo-pager>
+ * ```
  */
 export declare class PagerInfoComponent extends PagerElementComponent {
     /**

package/pager/pager-input.component.d.ts

@@ -10,7 +10,16 @@ import { PagerContextService, PagerContextChanges } from "./pager-context.servic
 import { PagerSize } from './common/pager-size';
 import * as i0 from "@angular/core";
 /**
- * Displays an input element which allows the typing and rendering of page numbers.
+ * Represents the Kendo UI Pager Input component for Angular. Displays an input element which allows you to type and render page numbers.
+ *
+ * @example
+ * ```html
+ * <kendo-pager [skip]="skip" [pageSize]="pageSize" [total]="total">
+ *   <ng-template kendoPagerTemplate>
+ *     <kendo-pager-input></kendo-pager-input>
+ *   </ng-template>
+ * </kendo-pager>
+ * ```
  */
 export declare class PagerInputComponent extends PagerElementComponent {
     protected pagerContext: PagerContextService;
@@ -23,13 +32,9 @@ export declare class PagerInputComponent extends PagerElementComponent {
      */
     showPageText: boolean;
     /**
-     * Specifies the padding of the internal numeric input element.
+     * Specifies the padding of the internal `NumericTextBox` component.
      *
-     * The possible values are:
-     * * `small`
-     * * `medium` (default)
-     * * `large`
-     * * `none`
+     * @default 'medium'
      */
     size: PagerSize;
     constructor(localization: LocalizationService, pagerContext: PagerContextService, zone: NgZone, cd: ChangeDetectorRef, renderer: Renderer2);

package/pager/pager-next-buttons.component.d.ts

@@ -9,7 +9,16 @@ import { LocalizationService } from '@progress/kendo-angular-l10n';
 import { PagerSize } from './common/pager-size';
 import * as i0 from "@angular/core";
 /**
- * Displays buttons for navigating to the next and to the last page ([see example]({% slug pager_settings %})).
+ * Represents the Kendo UI Pager Next Buttons component for Angular. Displays buttons for navigating to the next and to the last page ([see example]({% slug pager_settings %})).
+ *
+ * @example
+ * ```html
+ * <kendo-pager [skip]="skip" [pageSize]="pageSize" [total]="total">
+ *   <ng-template kendoPagerTemplate>
+ *     <kendo-pager-next-buttons></kendo-pager-next-buttons>
+ *   </ng-template>
+ * </kendo-pager>
+ * ```
  */
 export declare class PagerNextButtonsComponent extends PagerElementComponent {
     /**
@@ -21,13 +30,9 @@ export declare class PagerNextButtonsComponent extends PagerElementComponent {
      */
     get disabled(): boolean;
     /**
-     * Specifies the padding of the buttons.
+     * Specifies the padding of the navigation buttons.
      *
-     * The possible values are:
-     * * `small`
-     * * `medium` (default)
-     * * `large`
-     * * `none`
+     * @default 'medium'
      */
     size: PagerSize;
     constructor(localization: LocalizationService, pagerContext: PagerContextService, cd: ChangeDetectorRef);

package/pager/pager-numeric-buttons.component.d.ts

@@ -9,7 +9,16 @@ import { PagerContextChanges, PagerContextService } from './pager-context.servic
 import { PagerElementComponent } from './pager-element.component';
 import * as i0 from "@angular/core";
 /**
- * Displays numeric buttons to enable navigation between the pages.
+ * Represents the Kendo UI Pager Numeric Buttons component for Angular. Displays numeric buttons to enable navigation between the pages.
+ *
+ * @example
+ * ```html
+ * <kendo-pager [skip]="skip" [pageSize]="pageSize" [total]="total">
+ *   <ng-template kendoPagerTemplate>
+ *     <kendo-pager-numeric-buttons [buttonCount]="5"></kendo-pager-numeric-buttons>
+ *   </ng-template>
+ * </kendo-pager>
+ * ```
  */
 export declare class PagerNumericButtonsComponent extends PagerElementComponent {
     protected pagerContext: PagerContextService;
@@ -17,7 +26,7 @@ export declare class PagerNumericButtonsComponent extends PagerElementComponent
     selectElement: any;
     numbersElement: any;
     /**
-     * The count of the displayed buttons.
+     * Specifies the count of the displayed buttons.
      *
      * @type {number}
      * @memberOf PagerNumericButtonsComponent
@@ -26,11 +35,7 @@ export declare class PagerNumericButtonsComponent extends PagerElementComponent
     /**
      * Specifies the padding of the numeric buttons.
      *
-     * The possible values are:
-     * * `small`
-     * * `medium` (default)
-     * * `large`
-     * * `none`
+     * @default 'medium'
      */
     set size(size: PagerSize);
     get size(): PagerSize;

package/pager/pager-page-sizes.component.d.ts

@@ -12,7 +12,16 @@ import { PagerSize } from './common/pager-size';
 import { AdaptiveMode } from '../util';
 import * as i0 from "@angular/core";
 /**
- * Displays a drop-down list for the page size selection ([see example]({% slug pager_settings %})).
+ * Represents the Kendo UI Pager Page Sizes component for Angular. Displays a drop-down list for the page size selection ([see example]({% slug pager_settings %})).
+ *
+ * @example
+ * ```html
+ * <kendo-pager [skip]="skip" [pageSize]="pageSize" [total]="total">
+ *   <ng-template kendoPagerTemplate>
+ *     <kendo-pager-page-sizes [pageSizes]="[10, 20, 50]"></kendo-pager-page-sizes>
+ *   </ng-template>
+ * </kendo-pager>
+ * ```
  */
 export declare class PagerPageSizesComponent extends PagerElementComponent implements AfterViewInit, OnDestroy {
     protected pagerContext: PagerContextService;
@@ -27,136 +36,26 @@ export declare class PagerPageSizesComponent extends PagerElementComponent imple
     get showItemsText(): boolean;
     set showItemsText(value: boolean);
     /**
-     * The page sizes collection. Can contain numbers and [PageSizeItem]({% slug api_pager_pagesizeitem %}) objects.
+     * Specifies the page sizes collection. You can include numbers and [`PageSizeItem`]({% slug api_pager_pagesizeitem %}) objects.
      *
      * @example
-     *
-     * ```ts-preview
-     * _@Component({
-     *    selector: 'my-app',
-     *    template: `
-     *        <div *ngFor="let item of pagedData" style="border: 1px solid black; padding: 10px;">
-     *            <span>{{item.ProductID}}. </span>
-     *            <span>{{item.ProductName}}</span>
-     *        </div>
-     *        <kendo-pager
-     *             [skip]="skip"
-     *             [pageSize]="pageSize"
-     *             [total]="total"
-     *             (pageChange)="onPageChange($event)">
-     *           <ng-template kendoPagerTemplate>
-     *               <kendo-pager-page-sizes [pageSizes]="pagesizes"></kendo-pager-page-sizes>
-     *           </ng-template>
-     *        </kendo-pager>
-     *    `
-     * })
-     * class AppComponent {
-     *    public data: any[] = products;
-     *    public pagedData = [];
-     *    public skip = 0;
-     *    public pageSize = 2;
-     *    public total = products.length;
-     *    public pagesizes = [{text: 'One', value: 1}, {text: 'Two', value: 2}, {text: 'All', value : 'all'}];
-     *
-     *    public ngOnInit() {
-     *        this.pageData();
-     *    }
-     *
-     *    public onPageChange(e) {
-     *        this.skip = e.skip;
-     *        this.pageSize = e.take;
-     *        this.pageData();
-     *    }
-     *
-     *    private pageData() {
-     *        this.pagedData = this.data.slice(this.skip, this.skip + this.pageSize);
-     *    }
-     * }
-     *
-     * const products = [{
-     *   'ProductID' : 1,
-     *   'ProductName' : "Chai",
-     *   'SupplierID' : 1,
-     *   'CategoryID' : 1,
-     *   'QuantityPerUnit' : "10 boxes x 20 bags",
-     *   'UnitPrice' : 18.0000,
-     *   'UnitsInStock' : 39,
-     *   'UnitsOnOrder' : 0,
-     *   'ReorderLevel' : 10,
-     *   'Discontinued' : false
-     *
-     * }, {
-     *   'ProductID' : 2,
-     *   'ProductName' : "Chang",
-     *   'SupplierID' : 1,
-     *   'CategoryID' : 1,
-     *   'QuantityPerUnit' : "24 - 12 oz bottles",
-     *   'UnitPrice' : 19.0000,
-     *   'UnitsInStock' : 17,
-     *   'UnitsOnOrder' : 40,
-     *   'ReorderLevel' : 25,
-     *   'Discontinued' : false
-     * }, {
-     *   'ProductID' : 3,
-     *   'ProductName' : "Aniseed Syrup",
-     *   'SupplierID' : 1,
-     *   'CategoryID' : 2,
-     *   'QuantityPerUnit' : "12 - 550 ml bottles",
-     *   'UnitPrice' : 10.0000,
-     *   'UnitsInStock' : 13,
-     *   'UnitsOnOrder' : 70,
-     *   'ReorderLevel' : 25,
-     *   'Discontinued' : false
-     * }, {
-     *   'ProductID' : 4,
-     *   'ProductName' : "Chef Anton\'s Cajun Seasoning",
-     *   'SupplierID' : 2,
-     *  'CategoryID' : 2,
-     *   'QuantityPerUnit' : "48 - 6 oz jars",
-     *   'UnitPrice' : 22.0000,
-     *   'UnitsInStock' : 53,
-     *   'UnitsOnOrder' : 0,
-     *   'ReorderLevel' : 0,
-     *   'Discontinued' : false
-     * }, {
-     *   'ProductID' : 5,
-     *   'ProductName' : "Chef Anton\'s Gumbo Mix",
-     *   'SupplierID' : 2,
-     *   'CategoryID' : 2,
-     *   'QuantityPerUnit' : "36 boxes",
-     *   'UnitPrice' : 21.3500,
-     *   'UnitsInStock' : 0,
-     *   'UnitsOnOrder' : 0,
-     *   'ReorderLevel' : 0,
-     *   'Discontinued' : true
-     * }, {
-     *   'ProductID' : 6,
-     *   'ProductName' : "Grandma\'s Boysenberry Spread",
-     *   'SupplierID' : 3,
-     *   'CategoryID' : 2,
-     *   'QuantityPerUnit' : "12 - 8 oz jars",
-     *   'UnitPrice' : 25.0000,
-     *   'UnitsInStock' : 120,
-     *   'UnitsOnOrder' : 0,
-     *   'ReorderLevel' : 25,
-     *   'Discontinued' : false
-     * }];
+     * ```html
+     * <kendo-pager [skip]="0" [pageSize]="10" [total]="100">
+     *   <ng-template kendoPagerTemplate>
+     *     <kendo-pager-page-sizes [pageSizes]="[5, 10, 20, { text: 'All', value: 'all' }]"></kendo-pager-page-sizes>
+     *   </ng-template>
+     * </kendo-pager>
      * ```
-     *
      */
     set pageSizes(pageSizes: PageSizeItem[] | number[]);
     /**
-     * Specifies the padding of the dropdown.
+     * Specifies the padding of the DropDownList component.
      *
-     * The possible values are:
-     * * `small`
-     * * `medium` (default)
-     * * `large`
-     * * `none`
+     * @default 'medium'
      */
     size: PagerSize;
     /**
-     * Toggles the adaptiveness of the internal DropDownList.
+     * Specifies the adaptive mode of the internal `DropDownList` component.
      *
      * @default 'auto'
      */

package/pager/pager-prev-buttons.component.d.ts

@@ -9,18 +9,23 @@ import { LocalizationService } from '@progress/kendo-angular-l10n';
 import { PagerSize } from './common/pager-size';
 import * as i0 from "@angular/core";
 /**
- * Displays buttons for navigating to the first and to the previous page ([see example]({% slug pager_settings %})).
+ * Represents the Kendo UI Pager Previous Buttons component for Angular. Displays buttons for navigating to the first and to the previous page ([see example]({% slug pager_settings %})).
+ *
+ * @example
+ * ```html
+ * <kendo-pager [skip]="skip" [pageSize]="pageSize" [total]="total">
+ *   <ng-template kendoPagerTemplate>
+ *     <kendo-pager-prev-buttons></kendo-pager-prev-buttons>
+ *   </ng-template>
+ * </kendo-pager>
+ * ```
  */
 export declare class PagerPrevButtonsComponent extends PagerElementComponent {
     constructor(localization: LocalizationService, pagerContext: PagerContextService, cd: ChangeDetectorRef);
     /**
-     * Specifies the padding of the buttons.
+     * Specifies the padding of the navigation buttons.
      *
-     * The possible values are:
-     * * `small`
-     * * `medium` (default)
-     * * `large`
-     * * `none`
+     * @default 'medium'
      */
     size: PagerSize;
     /**

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

@@ -5,10 +5,11 @@
 import { TemplateRef } from '@angular/core';
 import * as i0 from "@angular/core";
 /**
- * Represents the pager template which helps to customize the pager appearance. To define a pager
- * template, nest an `<ng-template>` tag with the `kendoPagerTemplate` directive inside `<kendo-pager>`.
+ * Represents the Kendo UI Pager template directive for Angular.
+ * Use this directive to customize the Pager appearance. To define a Pager template, nest an `<ng-template>` tag with the `kendoPagerTemplate` directive inside `<kendo-pager>`.
  *
  * The template context provides the following fields:
+ *
  * * `currentPage`&mdash;The index of the displayed page.
  * * `pageSize`&mdash;The value of the current `pageSize`.
  * * `skip`&mdash;The current skip value.
@@ -16,34 +17,13 @@ import * as i0 from "@angular/core";
  * * `totalPages`&mdash;The total number of available pages.
  *
  * @example
- * ```ts-preview
- *
- * _@Component({
- *     selector: 'my-app',
- *     template: `
- *       <kendo-pager [total]="total" [pageSize]="pageSize" [skip]="skip" (pageChange)="onPageChange($event)">
- *           <ng-template kendoPagerTemplate let-totalPages="totalPages" let-currentPage="currentPage">
- *               <kendo-pager-prev-buttons></kendo-pager-prev-buttons>
- *               <kendo-pager-numeric-buttons [buttonCount]="10"></kendo-pager-numeric-buttons>
- *               <kendo-pager-next-buttons></kendo-pager-next-buttons>
- *               <kendo-pager-info></kendo-pager-info>
- *               Current page: {{currentPage}}
- *           </ng-template>
- *        </kendo-pager>
- *     `
- * })
- *
- * class AppComponent {
- *     public skip = 0;
- *     public pageSize = 10;
- *     public total = 100;
- *
- *     public onPageChange(e: any): void {
- *         this.skip = e.skip;
- *         this.pageSize = e.take;
- *     }
- * }
- *
+ * ```html
+ * <kendo-pager [skip]="0" [pageSize]="10" [total]="100">
+ *   <ng-template kendoPagerTemplate let-currentPage="currentPage" let-pageSize="pageSize" let-skip="skip" let-total="total" let-totalPages="totalPages">
+ *     <span>Page {{currentPage}} of {{totalPages}}</span>
+ *     <span>Items per page: {{pageSize}}</span>
+ *   </ng-template>
+ * </kendo-pager>
  * ```
  */
 export declare class PagerTemplateDirective {

package/pager/pager.component.d.ts

@@ -24,6 +24,9 @@ export declare class PagerComponent implements OnChanges, AfterViewInit, OnInit,
     private ngZone;
     private cdr;
     private navigationService;
+    /**
+     * Represents the collection of pager template directives.
+     */
     template: QueryList<PagerTemplateDirective>;
     set numericButtons(buttons: ElementRef);
     set pagerInput(input: ElementRef);
@@ -35,55 +38,55 @@ export declare class PagerComponent implements OnChanges, AfterViewInit, OnInit,
      */
     externalTemplate: any;
     /**
-     * Represents the total number of data items in the collection.
+     * Specifies the total number of data items in the collection.
      *
      * @default 0
      */
     total: number;
     /**
-     * Defines the number of data items to be skipped.
+     * Specifies the number of data items to skip.
      *
      * @default 0
      */
     skip: number;
     /**
-     * Defines the number of data items per page.
+     * Specifies the number of data items per page.
      */
     pageSize: number;
     /**
-     * Sets the maximum numeric buttons count before the buttons are collapsed.
+     * Specifies the maximum number of numeric buttons before the buttons are collapsed.
      *
      * @default 10
      */
     buttonCount: number;
     /**
-     * Toggles the information about the current page and the total number of records.
+     * Determines whether to display information about the current page and the total number of records.
      *
      * @default true
      */
     info: boolean;
     /**
-     * Defines the type of the pager.
+     * Specifies the type of the Pager.
      *
      * @default 'numeric'
      */
     type: PagerType;
     /**
-     * Shows a dropdown for selecting the page size.
-     * When set to `true`, the dropdown will contain the default list of options - 5, 10, 20.
+     * Displays a dropdown for selecting the page size.
+     * When set to `true`, the dropdown contains the default list of options - 5, 10, 20.
      * To customize the list of options, set `pageSizeValues` to an array of the desired values.
      * The array can contain numbers and [PageSizeItem]({% slug api_pager_pagesizeitem %}) objects.
      */
     set pageSizeValues(value: boolean | number[] | PageSizeItem[]);
     get pageSizeValues(): boolean | number[] | PageSizeItem[];
     /**
-     * Toggles the **Previous** and **Next** buttons.
+     * Determines whether to display the **Previous** and **Next** buttons.
      *
      * @default true
      */
     previousNext: boolean;
     /**
-     * If set to `true`, the user can use dedicated shortcuts to interact with the Pager ([see example]({% slug keyboard_navigation_pager %})).
+     * Determines whether users can use dedicated shortcuts to interact with the Pager ([see example]({% slug keyboard_navigation_pager %})).
      * By default, navigation is enabled. To disable it and make the Pager content accessible in the normal tab sequence, set the property to `false`.
      * @default true
      */
@@ -92,35 +95,31 @@ export declare class PagerComponent implements OnChanges, AfterViewInit, OnInit,
     /**
      * Specifies the padding of all Pager elements.
      *
-     * The possible values are:
-     * * `small`
-     * * `medium` (default)
-     * * `large`
-     * * `none`
+     * @default 'medium'
      */
     set size(size: PagerSize);
     get size(): PagerSize;
     /**
-     * Toggles the Pager responsive functionality ([see example](slug:responsive_pager)).
+     * Determines whether the Pager responsive functionality is enabled ([see example](slug:responsive_pager)).
      *
      * @default true
      */
     responsive: boolean;
     /**
-     * Toggles the Pager adaptiveness functionality ([see example](slug:adaptive_mode_pager)).
+     * Determines whether the Pager adaptiveness functionality is enabled ([see example](slug:adaptive_mode_pager)).
      *
      * @default 'auto'
      */
     adaptiveMode: AdaptiveMode;
     /**
-     * Fires when the current page of the Pager is changed ([see example](slug:overview_pager)).
-     * You have to handle the event yourself and page the data.
+     * Fires when the current page of the Pager changes ([see example](slug:overview_pager)).
+     * You have to handle the event and page the data.
      */
     pageChange: EventEmitter<PageChangeEvent>;
     /**
-     * Fires when the page size of the Pager is changed.
-     * You have to handle the event yourself and page the data.
-     * If the event is prevented, the page size will remain unchanged ([see example]({% slug pager_events %})).
+     * Fires when the page size of the Pager changes.
+     * You have to handle the event and page the data.
+     * If the event is prevented, the page size remains unchanged ([see example]({% slug pager_events %})).
      */
     pageSizeChange: EventEmitter<PageSizeChangeEvent>;
     /**
@@ -186,6 +185,9 @@ export declare class PagerComponent implements OnChanges, AfterViewInit, OnInit,
     private pagerDimensions;
     constructor(pagerContext: PagerContextService, element: ElementRef, localization: LocalizationService, renderer: Renderer2, ngZone: NgZone, cdr: ChangeDetectorRef, navigationService: PagerNavigationService);
     ngOnInit(): void;
+    /**
+     * Gets the maximum number of items displayed on the current page.
+     */
     get maxItems(): number;
     ngAfterViewInit(): void;
     ngOnChanges(changes: SimpleChanges): void;

package/pager/pagesize-item.interface.d.ts

@@ -4,12 +4,12 @@
 *-------------------------------------------------------------------------------------------*/
 export interface PageSizeItem {
     /**
-     * The text that will represent each available option in the page sizes dropdown list.
+     * Specifies the text that represents each available option in the page sizes dropdown list.
      */
     text: string;
     /**
-     * The numeric value that will be used as page size.
-     * When the value is `all`, the page size will be the total number of items.
+     * Specifies the numeric value that you use as page size.
+     * When you set the value to `all`, the page size becomes the total number of items.
      */
     value: number | 'all';
 }

package/pager/pagesizechange-event.d.ts

@@ -4,12 +4,12 @@
 *-------------------------------------------------------------------------------------------*/
 import { PreventableEvent } from './preventable-event';
 /**
- * Arguments for the `pageSizeChange` event. The `pageSizeChange` event fires when the page size
- * is changed from the UI. If you cancel the event, the change is prevented.
+ * Represents the arguments for the `pageSizeChange` event. The `pageSizeChange` event fires when you change the page size
+ * from the UI. If you cancel the event, the change does not occur.
  */
 export declare class PageSizeChangeEvent extends PreventableEvent {
     /**
-     * The newly selected page size.
+     * Gets the newly selected page size.
      */
     newPageSize: number | string;
     /**