@progress/kendo-angular-grid 12.0.0-develop.9 → 12.0.1-develop.1

package/esm2020/pager/pager-input.component.mjs

@@ -18,54 +18,7 @@ import * as i5 from "./pager-input.directive";
 import * as i6 from "../navigation/focusable.directive";
 import * as i7 from "@progress/kendo-angular-common";
 /**
- * Displays an input element which allows the typing and rendering of page numbers.
- *
- * @example
- * ```ts-preview
- *
- * _@Component({
- *     selector: 'my-app',
- *     template: `
- *      <kendo-grid
- *        [kendoGridBinding]="gridData"
- *        [pageSize]="1"
- *        [pageable]="true"
- *      >
- *       <kendo-grid-column field="ProductID" title="ID" [width]="40">
- *       </kendo-grid-column>
- *       <kendo-grid-column field="ProductName" title="Name" [width]="250">
- *       </kendo-grid-column>
- *       <kendo-grid-column field="UnitPrice" title="Price" [width]="80" format="{0:c}">
- *       </kendo-grid-column>
- *
- *       <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-input></kendo-pager-input>
- *          <kendo-pager-info></kendo-pager-info>
- *       </ng-template>
- *
- *    </kendo-grid>
- *     `
- * })
- *
- * class AppComponent {
- *     public gridData = [{
- *         "ProductID": 1,
- *         "ProductName": "Chai",
- *         "UnitPrice": 18.0000,
- *         "Discontinued": false
- *       }, {
- *         "ProductID": 2,
- *         "ProductName": "Chang",
- *         "UnitPrice": 19.0000,
- *         "Discontinued": true
- *       }
- *     ];
- * }
- *
- * ```
+ * Displays an input element which allows the typing and rendering of page numbers ([see example](slug:pager_template_grid#toc-using-built-in-pager-components)).
  */
 export class PagerInputComponent extends PagerElementComponent {
     constructor(localization, pagerContext, zone, navigationService, cd) {

package/esm2020/pager/pager-next-buttons.component.mjs

@@ -15,7 +15,7 @@ import * as i3 from "./../navigation/navigation.service";
 import * as i4 from "@progress/kendo-angular-buttons";
 import * as i5 from "../navigation/focusable.directive";
 /**
- * Displays buttons for navigating to the next and to the last page ([see example]({% slug paging_grid %}#toc-pager-template)).
+ * Displays buttons for navigating to the next and to the last page ([see example](slug:pager_template_grid#toc-using-built-in-pager-components)).
  */
 export class PagerNextButtonsComponent extends PagerElementComponent {
     constructor(localization, pagerContext, cd, navigationService) {

package/esm2020/pager/pager-numeric-buttons.component.mjs

@@ -13,7 +13,7 @@ import * as i3 from "@progress/kendo-angular-buttons";
 import * as i4 from "../navigation/focusable.directive";
 import * as i5 from "@angular/common";
 /**
- * Displays numeric buttons to enable navigation between the pages.
+ * Displays numeric buttons to enable navigation between the pages ([see example](slug:pager_template_grid#toc-using-built-in-pager-components)).
  */
 export class PagerNumericButtonsComponent extends PagerElementComponent {
     constructor(localization, cd, pagerContext) {

package/esm2020/pager/pager-page-sizes.component.mjs

@@ -16,7 +16,7 @@ import * as i5 from "@progress/kendo-angular-label";
 import * as i6 from "./pager-dropdown.directive";
 import * as i7 from "../navigation/focusable.directive";
 /**
- * Displays a drop-down list for the page size selection ([see example]({% slug paging_grid %}#toc-pager-templates)).
+ * Displays a drop-down list for the page size selection ([see example](slug:pager_template_grid#toc-using-built-in-pager-components)).
  */
 export class PagerPageSizesComponent extends PagerElementComponent {
     constructor(localization, cd, pagerContext, navigationService) {
@@ -26,97 +26,8 @@ export class PagerPageSizesComponent extends PagerElementComponent {
         this._pageSizes = [];
     }
     /**
-     * The page sizes collection. Can be an Array of numbers and/or PageSizeItem objects.
-     *
-     * @example
-     * ```ts-preview
-     * _@Component({
-     *    selector: 'my-app',
-     *    template: `
-     *        <kendo-grid [kendoGridBinding]="gridData" [height]="200"
-     *           [pageable]="true"
-     *            [pageSize]="pageSize">
-     *            <ng-template kendoPagerTemplate let-totalPages="totalPages" let-currentPage="currentPage">
-     *                <kendo-pager-page-sizes [pageSizes]="pagesizes"></kendo-pager-page-sizes>
-     *            </ng-template>
-     *        </kendo-grid>
-     *    `
-     * })
-     * class AppComponent {
-     *    public gridData: any[] = products;
-     *    public pageSize = 2;
-     *    public pagesizes = [{text: 'One', value: 1}, {text: 'Two', value: 2}, {text: 'All', value : 'all'}];
-     * }
-     *
-     * 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
-     * }];
-     * ```
+     * The page sizes collection. Can be an Array of numbers and/or [`PageSizeItem`](slug:api_grid_pagesizeitem) objects
+     * ([see example]({% slug paging_grid %}#toc-pager-templates))
      */
     set pageSizes(pageSizes) {
         let normalizedItems = [];

package/esm2020/pager/pager-prev-buttons.component.mjs

@@ -15,7 +15,7 @@ import * as i3 from "./../navigation/navigation.service";
 import * as i4 from "@progress/kendo-angular-buttons";
 import * as i5 from "../navigation/focusable.directive";
 /**
- * Displays buttons for navigating to the first and to the previous page ([see example]({% slug paging_grid %}#toc-pager-templates)).
+ * Displays buttons for navigating to the first and to the previous page ([see example](slug:pager_template_grid#toc-using-built-in-pager-components)).
  */
 export class PagerPrevButtonsComponent extends PagerElementComponent {
     constructor(localization, pagerContext, cd, navigationService) {

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

@@ -5,6 +5,15 @@
 import { Component } from '@angular/core';
 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"`).
+ */
 export class PDFMarginComponent extends PDFExportMarginComponent {
 }
 PDFMarginComponent.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "13.3.12", ngImport: i0, type: PDFMarginComponent, deps: null, target: i0.ɵɵFactoryTarget.Component });

package/esm2020/pdf/pdf.module.mjs

@@ -27,28 +27,19 @@ const declarations = [
  *
  * @example
  *
- * ```ts-no-run
- * // Import the Grid and PDF modules
- * import { GridModule, PDFModule } from '@progress/kendo-angular-grid';
- *
- * // The browser platform with a compiler
- * import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';
- *
+ * ```ts
  * import { NgModule } from '@angular/core';
- *
- * // Import the app component
+ * import { BrowserModule } from "@angular/platform-browser";
+ * import { GridModule, PDFModule } from '@progress/kendo-angular-grid';
  * import { AppComponent } from './app.component';
  *
- * // Define the app module
- * _@NgModule({
- *     declarations: [AppComponent], // declare app component
- *     imports:      [BrowserModule, GridModule, PDFModule], // import Grid and PDF modules
+ * @NgModule({
+ *     declarations: [AppComponent],
+ *     imports:      [BrowserModule, GridModule, PDFModule],
  *     bootstrap:    [AppComponent]
  * })
- * export class AppModule {}
  *
- * // Compile and launch the module
- * platformBrowserDynamic().bootstrapModule(AppModule);
+ * export class AppModule {}
  *
  * ```
  */

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

@@ -9,7 +9,8 @@ import * as i0 from "@angular/core";
  * Represents the Kendo UI GridSpacer component for Angular.
  * Used to give additional white space between the Pager inner elements,
  * and provides a way for customizing the spacer width.
- * It can also be used in any flex container within the Grid.
+ * It can also be used in any flex container within the Grid
+ * ([see example](slug:toolbartemplate_grid#toc-defining-the-spacing-between-toolbar-elements)).
  */
 export class GridSpacerComponent {
     constructor() {

package/esm2020/rendering/toolbar/toolbar-position.mjs

@@ -2,4 +2,21 @@
 * Copyright © 2023 Progress Software Corporation. All rights reserved.
 * Licensed under commercial license. See LICENSE.md in the project root for more information
 *-------------------------------------------------------------------------------------------*/
+/**
+ * Defines the settings for `position` property of the  the Grid Toolbar Template. [See example](slug:toolbartemplate_grid#toc-setting-the-toolbar-position)
+ *
+ * The possible values are:
+ * * `top`—Displays the Toolbar a the top of the Grid.
+ * * `bottom`—Displays the Toolbar at the bottom of the Grid.
+ * * `both`—Displays the Toolbar at the top and bottom of the Grid.
+ *
+ * @example
+ * ```html
+ * <kendo-grid >
+ *   <ng-template kendoGridToolbarTemplate position="bottom" let-position="position">
+ *     <button (click)="onClick()">Custom action</button>
+ *   </ng-template>
+ * </kendo-grid>
+ * ```
+ */
 export {};

package/esm2020/row-reordering/row-reorder.service.mjs

@@ -22,6 +22,7 @@ export class RowReorderService {
     }
     press(ev) {
         this.dragTarget = ev.dragTarget;
+        this.offsetY = ev.dragEvent.offsetY;
     }
     dragStart() {
         this.createDropIndicator();
@@ -33,7 +34,7 @@ export class RowReorderService {
         }
         const position = {
             x: ev.dragEvent.clientX,
-            y: ev.dragEvent.clientY
+            y: ev.dragEvent.clientY - this.offsetY
         };
         if (isPresent(this.hintElement)) {
             this.renderer.setStyle(this.hintElement, 'left', `${position.x}px`);

package/excel/excel.component.d.ts

@@ -39,18 +39,13 @@ export declare class ExcelComponent implements OnDestroy {
     /**
      * The URL of the server-side proxy which streams the file to the end user.
      *
-     * Using a proxy is required if the browser is not capable of saving files locally—for example,
-     * Internet Explorer 9 and Safari.
+     * Using a proxy is required if the browser is not capable of saving files locally.
      *
      * Optionally, set up a proxy to reduce memory usage. This avoids copying the file contents in memory,
      * but transmits it over the network instead. For this use case, set [forceProxy](#toc-forceproxy) to `true`
      * to skip client-side saving even in browser that support it.
      *
-     * In the request body, the proxy receives a POST request with the following parameters:
-     * - `contentType`—The MIME type of the file.
-     * - `base64`—The base-64 encoded file content.
-     * - `fileName`—The file name, as requested by the caller.
-     *
+     * In the request body, the proxy receives a POST request with the specific parameters. [See exmaple](slug:server_proxy#toc-implementations).
      * The proxy returns the decoded file with the `"Content-Disposition"` header set to `attachment; filename="<fileName.xslx>"`.
      *
      * For details on the server-side proxy usage and implementation, see the [File Saver]({% slug overview_filesaver %}) documentation.

package/excel/excel.module.d.ts

@@ -13,29 +13,19 @@ import * as i4 from "@progress/kendo-angular-excel-export";
  *
  * @example
  *
- * ```ts-no-run
- * // Import the Grid and Excel modules
- * import { GridModule, ExcelModule } from '@progress/kendo-angular-grid';
- *
- * // The browser platform with a compiler
- * import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';
- *
+ * ```ts
  * import { NgModule } from '@angular/core';
- *
- * // Import the app component
+ * import { BrowserModule } from "@angular/platform-browser";
+ * import { GridModule, ExcelModule } from '@progress/kendo-angular-grid';
  * import { AppComponent } from './app.component';
  *
- * // Define the app module
  * _@NgModule({
- *     declarations: [AppComponent], // declare app component
- *     imports:      [BrowserModule, GridModule, ExcelModule], // import Grid and Excel modules
+ *     declarations: [AppComponent],
+ *     imports:      [BrowserModule, GridModule, ExcelModule],
  *     bootstrap:    [AppComponent]
  * })
  * export class AppModule {}
  *
- * // Compile and launch the module
- * platformBrowserDynamic().bootstrapModule(AppModule);
- *
  * ```
  */
 export declare class ExcelModule {