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

package/directives.d.ts

@@ -5,6 +5,20 @@
 import { PDFViewerCustomMessagesComponent } from "./localization/custom-messages.component";
 import { PDFViewerComponent } from "./pdfviewer.component";
 /**
- * Utility array that contains all `@progress/kendo-angular-pdfviewer` related components and directives
+ * Use the `KENDO_PDFVIEWER` utility array to add all `@progress/kendo-angular-pdf-viewer`-related components and directives to a standalone Angular component.
+ *
+ * @example
+ * ```typescript
+ * import { Component } from '@angular/core';
+ * import { KENDO_PDFVIEWER } from "@progress/kendo-angular-pdf-viewer";
+ *
+ * @Component({
+ *   standalone: true,
+ *   imports: [KENDO_PDFVIEWER],
+ *   selector: 'my-app',
+ *   template: `<kendo-pdf-viewer [url]="pdfUrl"></kendo-pdf-viewer>`
+ * })
+ * export class AppComponent {}
+ * ```
  */
 export declare const KENDO_PDFVIEWER: readonly [typeof PDFViewerComponent, typeof PDFViewerCustomMessagesComponent];

package/esm2022/directives.mjs

@@ -5,7 +5,21 @@
 import { PDFViewerCustomMessagesComponent } from "./localization/custom-messages.component";
 import { PDFViewerComponent } from "./pdfviewer.component";
 /**
- * Utility array that contains all `@progress/kendo-angular-pdfviewer` related components and directives
+ * Use the `KENDO_PDFVIEWER` utility array to add all `@progress/kendo-angular-pdf-viewer`-related components and directives to a standalone Angular component.
+ *
+ * @example
+ * ```typescript
+ * import { Component } from '@angular/core';
+ * import { KENDO_PDFVIEWER } from "@progress/kendo-angular-pdf-viewer";
+ *
+ * @Component({
+ *   standalone: true,
+ *   imports: [KENDO_PDFVIEWER],
+ *   selector: 'my-app',
+ *   template: `<kendo-pdf-viewer [url]="pdfUrl"></kendo-pdf-viewer>`
+ * })
+ * export class AppComponent {}
+ * ```
  */
 export const KENDO_PDFVIEWER = [
     PDFViewerComponent,

package/esm2022/localization/custom-messages.component.mjs

@@ -8,7 +8,11 @@ import { Messages } from './messages';
 import * as i0 from "@angular/core";
 import * as i1 from "@progress/kendo-angular-l10n";
 /**
- * Custom component messages override default component messages.
+ * Represents the custom messages component of the PDFViewer.
+ *
+ * Use this component to override default messages for the PDFViewer.
+ *
+ *
  */
 export class PDFViewerCustomMessagesComponent extends Messages {
     service;

package/esm2022/localization/messages.mjs

@@ -10,103 +10,103 @@ import * as i0 from "@angular/core";
  */
 export class Messages extends ComponentMessages {
     /**
-     * The ZoomIn tool title and label.
+     * Sets the title and label for the **ZoomIn** tool.
      */
     zoomInTitle;
     /**
-     * The ZoomOut tool titla and label.
+     * Sets the title and label for the **ZoomOut** tool.
      */
     zoomOutTitle;
     /**
-     * The Selection tool title and label.
+     * Sets the title and label for the **Selection** tool.
      */
     selectionTitle;
     /**
-     * The Panning tool title and label.
+     * Sets the title and label for the **Panning** tool.
      */
     panningTitle;
     /**
-     * The Search tool title and label.
+     * Sets the title and label for the **Search** tool.
      */
     searchTitle;
     /**
-     * The Open tool title and label.
+     * Sets the title and label for the **Open** tool.
      */
     openTitle;
     /**
-     * The Download tool title and label.
+     * Sets the title and label for the **Download** tool.
      */
     downloadTitle;
     /**
-     * The Print tool title and label.
+     * Sets the title and label for the **Print** tool.
      */
     printTitle;
     /**
-     * The `aria-label` attribute of the Pager input element.
+     * Sets the `aria-label` attribute for the Pager input element.
      */
     pagerInputLabel;
     /**
-     * The `title` attribute of the Pager input element.
+     * Sets the `title` attribute for the Pager input element.
      */
     pagerInputTitle;
     /**
-     * The Pager **First page** button label.
+     * Sets the label for the Pager **First page** button.
      */
     pagerFirstPage;
     /**
-     * The Pager **Previous page** button label.
+     * Sets the label for the Pager **Previous page** button.
      */
     pagerPreviousPage;
     /**
-     * The Pager **Next page** button label.
+     * Sets the label for the Pager **Next page** button.
      */
     pagerNextPage;
     /**
-     * The Pager **Last page** button label.
+     * Sets the label for the Pager **Last page** button.
      */
     pagerLastPage;
     /**
-     * The text before the Pager total-page number.
+     * Sets the text before the Pager total-page number.
      */
     pagerOf;
     /**
-     * The text displayed before the Pager input.
+     * Sets the text before the Pager input.
      */
     pagerPage;
     /**
-     * The text for the zoom level chooser Fit to page option.
+     * Sets the text for the zoom level chooser **Fit to page** option.
      */
     fitToPage;
     /**
-     * The text for the zoom level chooser Fit to width option.
+     * Sets the text for the zoom level chooser **Fit to width** option.
      */
     fitToWidth;
     /**
-     * The text for the search input placeholder.
+     * Sets the placeholder text for the search input.
      */
     searchInputPlaceholder;
     /**
-     * The text before the total number of matches in the Search tool.
+     * Sets the text before the total number of matches in the **Search** tool.
      */
     searchMatchesOf;
     /**
-     * The title of the Search previous match button.
+     * Sets the title for the **Search** previous match button.
      */
     searchPreviousMatchTitle;
     /**
-     * The title of the Search next match button.
+     * Sets the title for the **Search** next match button.
      */
     searchNextMatchTitle;
     /**
-     * The title of the Search close button.
+     * Sets the title for the **Search** close button.
      */
     searchCloseTitle;
     /**
-     * The title of the Search match case button.
+     * Sets the title for the **Search** match case button.
      */
     searchMatchCaseTitle;
     /**
-     * The text for the zoom tool input placeholder.
+     * Sets the placeholder text for the zoom tool input.
      */
     zoomInputPlaceholder;
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "16.2.12", ngImport: i0, type: Messages, deps: null, target: i0.ɵɵFactoryTarget.Directive });

package/esm2022/models/events.mjs

@@ -4,24 +4,23 @@
 *-------------------------------------------------------------------------------------------*/
 import { PreventableEvent } from "@progress/kendo-angular-common";
 /**
- * Arguments for the `download` event. The event fires when the end user clicks the Download tool.
- * If you cancel the event, the downloading of the file is prevented.
+ * Represents the arguments for the PDFViewer `download` event. The event fires when the user clicks the **Download** tool. Canceling the event prevents the download.
  */
 export class PDFViewerDownloadEvent extends PreventableEvent {
     /**
-     * The Blob object.
+     * Provides the Blob object to be saved.
      */
     blob;
     /**
-     * The name which will be used for saving the file.
+     * Provides the file name for saving.
      */
     fileName;
     /**
-     * The options which will be used for saving the file.
+     * Provides the save options.
      */
     saveOptions;
     /**
-     * Represents the currently loaded `PDF.js` document, its pages, and their DOM element wrapper.
+     * Represents the loaded `PDF.js` document, its pages, and their DOM element wrapper.
      */
     context;
     /**

package/esm2022/package-metadata.mjs

@@ -10,7 +10,7 @@ export const packageMetadata = {
     productName: 'Kendo UI for Angular',
     productCode: 'KENDOUIANGULAR',
     productCodes: ['KENDOUIANGULAR'],
-    publishDate: 1749804512,
-    version: '19.1.2-develop.1',
+    publishDate: 1749820762,
+    version: '19.1.2-develop.2',
     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',
 };

package/esm2022/pdfviewer.component.mjs

@@ -22,7 +22,16 @@ import * as i0 from "@angular/core";
 import * as i1 from "@progress/kendo-angular-l10n";
 let counter = 0;
 /**
- * Represents the [Kendo UI PDFViewer component for Angular]({% slug overview_pdfviewer %}).
+ * Represents the [Kendo UI PDFViewer component for Angular](slug:overview_pdfviewer).
+ *
+ * @example
+ * ```html
+ * <kendo-pdfviewer
+ *   [url]="pdfUrl"
+ *   [zoom]="1.25"
+ *   [tools]="['pager', 'zoomInOut', 'zoom', 'download', 'print']">
+ * </kendo-pdfviewer>
+ * ```
  */
 export class PDFViewerComponent {
     ngZone;
@@ -84,7 +93,7 @@ export class PDFViewerComponent {
      */
     typedArray;
     /**
-     * The initial zoom level of the PDF document
+     * Sets the initial zoom level of the PDF document
      * ([see example](slug:tools_pdfviewer#zooming-tools)).
      *
      * @default 1.25
@@ -105,7 +114,7 @@ export class PDFViewerComponent {
         return this._zoom;
     }
     /**
-     * Represents the step the zoom level will be changed with when using the ZoomIn and ZoomOut tools.
+     * Represents the step the zoom level will be changed with when using the **ZoomIn** and **ZoomOut** tools.
      * @default 0.25
      */
     zoomRate = 0.25;
@@ -120,35 +129,35 @@ export class PDFViewerComponent {
      */
     maxZoom = 4;
     /**
-     * Determines whether all PDF document pages will be initially loaded or new pages will be loaded on demand when needed.
+     * Sets whether the component loads all PDF document pages at once or loads new pages on demand when needed.
      *
      * @default false
      */
     loadOnDemand = false;
     /**
-     * The number of pages that will be loaded on demand.
+     * Sets the number of pages to load on demand when the `loadOnDemand` property is `true`.
      *
      * @default 1
      */
     loadOnDemandPageSize = 1;
     /**
-     * The event fired when a PDF document is successfully loaded in the `PDFViewer` component.
+     * Fires when the component loads a PDF document successfully.
      */
     load = new EventEmitter();
     /**
-     * The event fired when an error occurs during the loading or downloading of the PDF document.
+     * Fires when an error occurs while loading or downloading the PDF document.
      */
     error = new EventEmitter();
     /**
-     * The event fired when an error occurs during the loading of the PDF document.
+     * Fires when the user clicks the **Download** tool of the loaded PDF document.
      */
     download = new EventEmitter();
     /**
-     * The event fired when the end user changes the page of the loaded PDF document.
+     * Fires when the user changes the page of the loaded PDF document.
      */
     pageChange = new EventEmitter();
     /**
-     * The event fired when the end user changes the zoom level of the loaded PDF document.
+     * Fires when the user changes the zoom level of the loaded PDF document.
      */
     zoomLevelChange = new EventEmitter();
     pagesContainer;
@@ -163,7 +172,7 @@ export class PDFViewerComponent {
         this._pdfContext = doc;
     }
     /**
-     * Exposes the currently loaded `PDF.js` document, its pages, and their DOM element wrapper.
+     * Exposes the loaded `PDF.js` document, its pages, and their DOM element wrapper.
      */
     get pdfContext() {
         return this._pdfContext;

package/esm2022/pdfviewer.module.mjs

@@ -12,8 +12,22 @@ import * as i1 from "./pdfviewer.component";
 import * as i2 from "./localization/custom-messages.component";
 // IMPORTANT: NgModule export kept for backwards compatibility
 /**
- * Represents the [NgModule](link:site.data.urls.angular['ngmoduleapi'])
- * definition for the PDFViewer component.
+ * Represents the [`NgModule`](link:site.data.urls.angular['ngmoduleapi']) definition for the PDFViewer component.
+ *
+ * @example
+ * ```typescript
+ * import { NgModule } from '@angular/core';
+ * import { BrowserModule } from '@angular/platform-browser';
+ * import { PDFViewerModule } from '@progress/kendo-angular-pdf-viewer';
+ * import { AppComponent } from './app.component';
+ *
+ * @NgModule({
+ *   declarations: [AppComponent],
+ *   imports: [BrowserModule, PDFViewerModule],
+ *   bootstrap: [AppComponent]
+ * })
+ * export class AppModule {}
+ * ```
  */
 export class PDFViewerModule {
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "16.2.12", ngImport: i0, type: PDFViewerModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule });

package/fesm2022/progress-kendo-angular-pdfviewer.mjs

@@ -29,103 +29,103 @@ import { PopupService } from '@progress/kendo-angular-popup';
  */
 class Messages extends ComponentMessages {
     /**
-     * The ZoomIn tool title and label.
+     * Sets the title and label for the **ZoomIn** tool.
      */
     zoomInTitle;
     /**
-     * The ZoomOut tool titla and label.
+     * Sets the title and label for the **ZoomOut** tool.
      */
     zoomOutTitle;
     /**
-     * The Selection tool title and label.
+     * Sets the title and label for the **Selection** tool.
      */
     selectionTitle;
     /**
-     * The Panning tool title and label.
+     * Sets the title and label for the **Panning** tool.
      */
     panningTitle;
     /**
-     * The Search tool title and label.
+     * Sets the title and label for the **Search** tool.
      */
     searchTitle;
     /**
-     * The Open tool title and label.
+     * Sets the title and label for the **Open** tool.
      */
     openTitle;
     /**
-     * The Download tool title and label.
+     * Sets the title and label for the **Download** tool.
      */
     downloadTitle;
     /**
-     * The Print tool title and label.
+     * Sets the title and label for the **Print** tool.
      */
     printTitle;
     /**
-     * The `aria-label` attribute of the Pager input element.
+     * Sets the `aria-label` attribute for the Pager input element.
      */
     pagerInputLabel;
     /**
-     * The `title` attribute of the Pager input element.
+     * Sets the `title` attribute for the Pager input element.
      */
     pagerInputTitle;
     /**
-     * The Pager **First page** button label.
+     * Sets the label for the Pager **First page** button.
      */
     pagerFirstPage;
     /**
-     * The Pager **Previous page** button label.
+     * Sets the label for the Pager **Previous page** button.
      */
     pagerPreviousPage;
     /**
-     * The Pager **Next page** button label.
+     * Sets the label for the Pager **Next page** button.
      */
     pagerNextPage;
     /**
-     * The Pager **Last page** button label.
+     * Sets the label for the Pager **Last page** button.
      */
     pagerLastPage;
     /**
-     * The text before the Pager total-page number.
+     * Sets the text before the Pager total-page number.
      */
     pagerOf;
     /**
-     * The text displayed before the Pager input.
+     * Sets the text before the Pager input.
      */
     pagerPage;
     /**
-     * The text for the zoom level chooser Fit to page option.
+     * Sets the text for the zoom level chooser **Fit to page** option.
      */
     fitToPage;
     /**
-     * The text for the zoom level chooser Fit to width option.
+     * Sets the text for the zoom level chooser **Fit to width** option.
      */
     fitToWidth;
     /**
-     * The text for the search input placeholder.
+     * Sets the placeholder text for the search input.
      */
     searchInputPlaceholder;
     /**
-     * The text before the total number of matches in the Search tool.
+     * Sets the text before the total number of matches in the **Search** tool.
      */
     searchMatchesOf;
     /**
-     * The title of the Search previous match button.
+     * Sets the title for the **Search** previous match button.
      */
     searchPreviousMatchTitle;
     /**
-     * The title of the Search next match button.
+     * Sets the title for the **Search** next match button.
      */
     searchNextMatchTitle;
     /**
-     * The title of the Search close button.
+     * Sets the title for the **Search** close button.
      */
     searchCloseTitle;
     /**
-     * The title of the Search match case button.
+     * Sets the title for the **Search** match case button.
      */
     searchMatchCaseTitle;
     /**
-     * The text for the zoom tool input placeholder.
+     * Sets the placeholder text for the zoom tool input.
      */
     zoomInputPlaceholder;
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "16.2.12", ngImport: i0, type: Messages, deps: null, target: i0.ɵɵFactoryTarget.Directive });
@@ -190,7 +190,11 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
             }] } });
 
 /**
- * Custom component messages override default component messages.
+ * Represents the custom messages component of the PDFViewer.
+ *
+ * Use this component to override default messages for the PDFViewer.
+ *
+ *
  */
 class PDFViewerCustomMessagesComponent extends Messages {
     service;
@@ -228,8 +232,8 @@ const packageMetadata = {
     productName: 'Kendo UI for Angular',
     productCode: 'KENDOUIANGULAR',
     productCodes: ['KENDOUIANGULAR'],
-    publishDate: 1749804512,
-    version: '19.1.2-develop.1',
+    publishDate: 1749820762,
+    version: '19.1.2-develop.2',
     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',
 };
 
@@ -310,24 +314,23 @@ const zoomToFitOptions = {
 };
 
 /**
- * Arguments for the `download` event. The event fires when the end user clicks the Download tool.
- * If you cancel the event, the downloading of the file is prevented.
+ * Represents the arguments for the PDFViewer `download` event. The event fires when the user clicks the **Download** tool. Canceling the event prevents the download.
  */
 class PDFViewerDownloadEvent extends PreventableEvent {
     /**
-     * The Blob object.
+     * Provides the Blob object to be saved.
      */
     blob;
     /**
-     * The name which will be used for saving the file.
+     * Provides the file name for saving.
      */
     fileName;
     /**
-     * The options which will be used for saving the file.
+     * Provides the save options.
      */
     saveOptions;
     /**
-     * Represents the currently loaded `PDF.js` document, its pages, and their DOM element wrapper.
+     * Represents the loaded `PDF.js` document, its pages, and their DOM element wrapper.
      */
     context;
     /**
@@ -1332,7 +1335,16 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
 
 let counter = 0;
 /**
- * Represents the [Kendo UI PDFViewer component for Angular]({% slug overview_pdfviewer %}).
+ * Represents the [Kendo UI PDFViewer component for Angular](slug:overview_pdfviewer).
+ *
+ * @example
+ * ```html
+ * <kendo-pdfviewer
+ *   [url]="pdfUrl"
+ *   [zoom]="1.25"
+ *   [tools]="['pager', 'zoomInOut', 'zoom', 'download', 'print']">
+ * </kendo-pdfviewer>
+ * ```
  */
 class PDFViewerComponent {
     ngZone;
@@ -1394,7 +1406,7 @@ class PDFViewerComponent {
      */
     typedArray;
     /**
-     * The initial zoom level of the PDF document
+     * Sets the initial zoom level of the PDF document
      * ([see example](slug:tools_pdfviewer#zooming-tools)).
      *
      * @default 1.25
@@ -1415,7 +1427,7 @@ class PDFViewerComponent {
         return this._zoom;
     }
     /**
-     * Represents the step the zoom level will be changed with when using the ZoomIn and ZoomOut tools.
+     * Represents the step the zoom level will be changed with when using the **ZoomIn** and **ZoomOut** tools.
      * @default 0.25
      */
     zoomRate = 0.25;
@@ -1430,35 +1442,35 @@ class PDFViewerComponent {
      */
     maxZoom = 4;
     /**
-     * Determines whether all PDF document pages will be initially loaded or new pages will be loaded on demand when needed.
+     * Sets whether the component loads all PDF document pages at once or loads new pages on demand when needed.
      *
      * @default false
      */
     loadOnDemand = false;
     /**
-     * The number of pages that will be loaded on demand.
+     * Sets the number of pages to load on demand when the `loadOnDemand` property is `true`.
      *
      * @default 1
      */
     loadOnDemandPageSize = 1;
     /**
-     * The event fired when a PDF document is successfully loaded in the `PDFViewer` component.
+     * Fires when the component loads a PDF document successfully.
      */
     load = new EventEmitter();
     /**
-     * The event fired when an error occurs during the loading or downloading of the PDF document.
+     * Fires when an error occurs while loading or downloading the PDF document.
      */
     error = new EventEmitter();
     /**
-     * The event fired when an error occurs during the loading of the PDF document.
+     * Fires when the user clicks the **Download** tool of the loaded PDF document.
      */
     download = new EventEmitter();
     /**
-     * The event fired when the end user changes the page of the loaded PDF document.
+     * Fires when the user changes the page of the loaded PDF document.
      */
     pageChange = new EventEmitter();
     /**
-     * The event fired when the end user changes the zoom level of the loaded PDF document.
+     * Fires when the user changes the zoom level of the loaded PDF document.
      */
     zoomLevelChange = new EventEmitter();
     pagesContainer;
@@ -1473,7 +1485,7 @@ class PDFViewerComponent {
         this._pdfContext = doc;
     }
     /**
-     * Exposes the currently loaded `PDF.js` document, its pages, and their DOM element wrapper.
+     * Exposes the loaded `PDF.js` document, its pages, and their DOM element wrapper.
      */
     get pdfContext() {
         return this._pdfContext;
@@ -2155,7 +2167,21 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
             }] } });
 
 /**
- * Utility array that contains all `@progress/kendo-angular-pdfviewer` related components and directives
+ * Use the `KENDO_PDFVIEWER` utility array to add all `@progress/kendo-angular-pdf-viewer`-related components and directives to a standalone Angular component.
+ *
+ * @example
+ * ```typescript
+ * import { Component } from '@angular/core';
+ * import { KENDO_PDFVIEWER } from "@progress/kendo-angular-pdf-viewer";
+ *
+ * @Component({
+ *   standalone: true,
+ *   imports: [KENDO_PDFVIEWER],
+ *   selector: 'my-app',
+ *   template: `<kendo-pdf-viewer [url]="pdfUrl"></kendo-pdf-viewer>`
+ * })
+ * export class AppComponent {}
+ * ```
  */
 const KENDO_PDFVIEWER = [
     PDFViewerComponent,
@@ -2164,8 +2190,22 @@ const KENDO_PDFVIEWER = [
 
 // IMPORTANT: NgModule export kept for backwards compatibility
 /**
- * Represents the [NgModule](link:site.data.urls.angular['ngmoduleapi'])
- * definition for the PDFViewer component.
+ * Represents the [`NgModule`](link:site.data.urls.angular['ngmoduleapi']) definition for the PDFViewer component.
+ *
+ * @example
+ * ```typescript
+ * import { NgModule } from '@angular/core';
+ * import { BrowserModule } from '@angular/platform-browser';
+ * import { PDFViewerModule } from '@progress/kendo-angular-pdf-viewer';
+ * import { AppComponent } from './app.component';
+ *
+ * @NgModule({
+ *   declarations: [AppComponent],
+ *   imports: [BrowserModule, PDFViewerModule],
+ *   bootstrap: [AppComponent]
+ * })
+ * export class AppModule {}
+ * ```
  */
 class PDFViewerModule {
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "16.2.12", ngImport: i0, type: PDFViewerModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule });

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

@@ -6,7 +6,11 @@ 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 custom messages component of the PDFViewer.
+ *
+ * Use this component to override default messages for the PDFViewer.
+ *
+ *
  */
 export declare class PDFViewerCustomMessagesComponent extends Messages {
     protected service: LocalizationService;

package/localization/messages.d.ts

@@ -9,103 +9,103 @@ import * as i0 from "@angular/core";
  */
 export declare class Messages extends ComponentMessages {
     /**
-     * The ZoomIn tool title and label.
+     * Sets the title and label for the **ZoomIn** tool.
      */
     zoomInTitle: string;
     /**
-     * The ZoomOut tool titla and label.
+     * Sets the title and label for the **ZoomOut** tool.
      */
     zoomOutTitle: string;
     /**
-     * The Selection tool title and label.
+     * Sets the title and label for the **Selection** tool.
      */
     selectionTitle: string;
     /**
-     * The Panning tool title and label.
+     * Sets the title and label for the **Panning** tool.
      */
     panningTitle: string;
     /**
-     * The Search tool title and label.
+     * Sets the title and label for the **Search** tool.
      */
     searchTitle: string;
     /**
-     * The Open tool title and label.
+     * Sets the title and label for the **Open** tool.
      */
     openTitle: string;
     /**
-     * The Download tool title and label.
+     * Sets the title and label for the **Download** tool.
      */
     downloadTitle: string;
     /**
-     * The Print tool title and label.
+     * Sets the title and label for the **Print** tool.
      */
     printTitle: string;
     /**
-     * The `aria-label` attribute of the Pager input element.
+     * Sets the `aria-label` attribute for the Pager input element.
      */
     pagerInputLabel: string;
     /**
-     * The `title` attribute of the Pager input element.
+     * Sets the `title` attribute for the Pager input element.
      */
     pagerInputTitle: string;
     /**
-     * The Pager **First page** button label.
+     * Sets the label for the Pager **First page** button.
      */
     pagerFirstPage: string;
     /**
-     * The Pager **Previous page** button label.
+     * Sets the label for the Pager **Previous page** button.
      */
     pagerPreviousPage: string;
     /**
-     * The Pager **Next page** button label.
+     * Sets the label for the Pager **Next page** button.
      */
     pagerNextPage: string;
     /**
-     * The Pager **Last page** button label.
+     * Sets the label for the Pager **Last page** button.
      */
     pagerLastPage: string;
     /**
-     * The text before the Pager total-page number.
+     * Sets the text before the Pager total-page number.
      */
     pagerOf: string;
     /**
-     * The text displayed before the Pager input.
+     * Sets the text before the Pager input.
      */
     pagerPage: string;
     /**
-     * The text for the zoom level chooser Fit to page option.
+     * Sets the text for the zoom level chooser **Fit to page** option.
      */
     fitToPage: string;
     /**
-     * The text for the zoom level chooser Fit to width option.
+     * Sets the text for the zoom level chooser **Fit to width** option.
      */
     fitToWidth: string;
     /**
-     * The text for the search input placeholder.
+     * Sets the placeholder text for the search input.
      */
     searchInputPlaceholder: string;
     /**
-     * The text before the total number of matches in the Search tool.
+     * Sets the text before the total number of matches in the **Search** tool.
      */
     searchMatchesOf: string;
     /**
-     * The title of the Search previous match button.
+     * Sets the title for the **Search** previous match button.
      */
     searchPreviousMatchTitle: string;
     /**
-     * The title of the Search next match button.
+     * Sets the title for the **Search** next match button.
      */
     searchNextMatchTitle: string;
     /**
-     * The title of the Search close button.
+     * Sets the title for the **Search** close button.
      */
     searchCloseTitle: string;
     /**
-     * The title of the Search match case button.
+     * Sets the title for the **Search** match case button.
      */
     searchMatchCaseTitle: string;
     /**
-     * The text for the zoom tool input placeholder.
+     * Sets the placeholder text for the zoom tool input.
      */
     zoomInputPlaceholder: string;
     static ɵfac: i0.ɵɵFactoryDeclaration<Messages, never>;

package/models/events.d.ts

@@ -10,7 +10,7 @@ import { SaveOptions } from "@progress/kendo-file-saver";
  */
 export interface PDFViewerLoadEvent {
     /**
-     * Represents the currently loaded `PDF.js` document, its pages, and their DOM element wrapper.
+     * Represents the loaded `PDF.js` document, its pages, and their DOM element wrapper.
      */
     context: PDFViewerContext;
 }
@@ -19,33 +19,32 @@ export interface PDFViewerLoadEvent {
  */
 export interface PDFViewerErrorEvent {
     /**
-     * Represents the original Error object, related to the triggered event.
+     * Provides the original `Error` object.
      */
     error: Error;
     /**
-     * Represents the currently loaded `PDF.js` document, its pages, and their DOM element wrapper.
+     * Represents the loaded `PDF.js` document, its pages, and their DOM element wrapper.
      */
     context: PDFViewerContext;
 }
 /**
- * Arguments for the `download` event. The event fires when the end user clicks the Download tool.
- * If you cancel the event, the downloading of the file is prevented.
+ * Represents the arguments for the PDFViewer `download` event. The event fires when the user clicks the **Download** tool. Canceling the event prevents the download.
  */
 export declare class PDFViewerDownloadEvent extends PreventableEvent {
     /**
-     * The Blob object.
+     * Provides the Blob object to be saved.
      */
     readonly blob: Blob;
     /**
-     * The name which will be used for saving the file.
+     * Provides the file name for saving.
      */
     readonly fileName: string;
     /**
-     * The options which will be used for saving the file.
+     * Provides the save options.
      */
     readonly saveOptions: SaveOptions;
     /**
-     * Represents the currently loaded `PDF.js` document, its pages, and their DOM element wrapper.
+     * Represents the loaded `PDF.js` document, its pages, and their DOM element wrapper.
      */
     readonly context: PDFViewerContext;
     /**
@@ -58,11 +57,11 @@ export declare class PDFViewerDownloadEvent extends PreventableEvent {
  */
 export interface PDFViewerPageChangeEvent {
     /**
-     * The active PDF page prior to triggering of the event.
+     * Provides the previous active page before triggering the event.
      */
     previousPage: number;
     /**
-     * The current active PDF page after triggering of the event.
+     * Provides the current active page after triggering the event.
      */
     currentPage: number;
 }
@@ -71,11 +70,11 @@ export interface PDFViewerPageChangeEvent {
  */
 export interface PDFViewerZoomChangeEvent {
     /**
-     * The applied PDF zoom level before it was changed by the user.
+     * Provides the previous zoom level.
      */
     previousZoomLevel: number;
     /**
-     * The current applied PDF zoom level after it was changed by the user.
+     * Provides the current zoom level.
      */
     currentZoomLevel: number;
 }

package/models/loader-settings.d.ts

@@ -4,45 +4,19 @@
 *-------------------------------------------------------------------------------------------*/
 import { LoaderSize, LoaderThemeColor, LoaderType } from "@progress/kendo-angular-indicators";
 /**
- * The configuration of the Loader component that is displayed while loading a PDF document.
+ * Defines the configuration options for the Loader component displayed while loading a PDF document.
  */
 export interface LoaderSettings {
     /**
      * Specifies the size of the Loader.
-     *
-     * The possible values are:
-     * * `small`
-     * * `medium` (Default)
-     * * `large`
-     *
      */
     size: LoaderSize;
     /**
      * Specifies the Loader animation type.
-     *
-     * The possible values are:
-     * - `pulsing` (default)
-     * - `infinite-spinner`
-     * - `converging-spinner`
-     *
      */
     type: LoaderType;
     /**
-     * Specifies the theme color of the Loader.
-     * ([see example]({% slug appearance_loader %}#toc-theme-color)).
-     *
-     * The possible values are:
-     * * `primary` (Default)—Applies coloring based on primary theme color.
-     * * `secondary`—Applies coloring based on secondary theme color.
-     * * `tertiary`— Applies coloring based on tertiary theme color.
-     * * `info`—Applies coloring based on info theme color.
-     * * `success`— Applies coloring based on success theme color.
-     * * `warning`— Applies coloring based on warning theme color.
-     * * `error`— Applies coloring based on error theme color.
-     * * `dark`— Applies coloring based on dark theme color.
-     * * `light`— Applies coloring based on light theme color.
-     * * `inverse`— Applies coloring based on inverted theme color.
-     *
+     * Specifies the Loader theme color.
      */
     themeColor: LoaderThemeColor;
 }

package/models/pdfviewer-context.d.ts

@@ -9,19 +9,19 @@ import { PDFPageProxy } from 'pdfjs-dist';
  */
 export interface PDFViewerContext {
     /**
-     * The `PDF.js` document loaded in the PDFViewer component.
+     * Represents the loaded `PDF.js` document.
      */
     pdfDoc: PDFDocumentProxy;
     /**
-     * The root DOM element wrapper of the PDF document.
+     * Defines the root DOM element wrapper for the PDF document.
      */
     element: HTMLDivElement;
     /**
-     * The separate `PDF.js` pages loaded in the PDFViewer component.
+     * Defines the loaded `PDF.js` pages.
      */
     pdfPages: PDFPageProxy[];
     /**
-     * The current zoom level of the PDF document.
+     * Represents the current zoom level.
      */
     zoom: number;
 }

package/models/toolbar-tool.d.ts

@@ -3,6 +3,6 @@
 * Licensed under commercial license. See LICENSE.md in the project root for more information
 *-------------------------------------------------------------------------------------------*/
 /**
- * Represents the possible types of Toolbar tools.
+ * Defines the possible types of PDFViewer toolbar tools.
  */
 export type PDFViewerTool = 'pager' | 'spacer' | 'zoomInOut' | 'zoom' | 'selection' | 'search' | 'open' | 'download' | 'print';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@progress/kendo-angular-pdfviewer",
-  "version": "19.1.2-develop.1",
+  "version": "19.1.2-develop.2",
   "description": "Kendo UI PDFViewer for Angular",
   "license": "SEE LICENSE IN LICENSE.md",
   "author": "Progress",
@@ -19,7 +19,7 @@
     "package": {
       "productName": "Kendo UI for Angular",
       "productCode": "KENDOUIANGULAR",
-      "publishDate": 1749804512,
+      "publishDate": 1749820762,
       "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"
     }
   },
@@ -29,21 +29,21 @@
     "@angular/core": "16 - 20",
     "@angular/platform-browser": "16 - 20",
     "@progress/kendo-licensing": "^1.5.0",
-    "@progress/kendo-angular-buttons": "19.1.2-develop.1",
-    "@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-intl": "19.1.2-develop.1",
-    "@progress/kendo-angular-l10n": "19.1.2-develop.1",
-    "@progress/kendo-angular-icons": "19.1.2-develop.1",
-    "@progress/kendo-angular-indicators": "19.1.2-develop.1",
-    "@progress/kendo-angular-pager": "19.1.2-develop.1",
-    "@progress/kendo-angular-popup": "19.1.2-develop.1",
+    "@progress/kendo-angular-buttons": "19.1.2-develop.2",
+    "@progress/kendo-angular-common": "19.1.2-develop.2",
+    "@progress/kendo-angular-dropdowns": "19.1.2-develop.2",
+    "@progress/kendo-angular-inputs": "19.1.2-develop.2",
+    "@progress/kendo-angular-intl": "19.1.2-develop.2",
+    "@progress/kendo-angular-l10n": "19.1.2-develop.2",
+    "@progress/kendo-angular-icons": "19.1.2-develop.2",
+    "@progress/kendo-angular-indicators": "19.1.2-develop.2",
+    "@progress/kendo-angular-pager": "19.1.2-develop.2",
+    "@progress/kendo-angular-popup": "19.1.2-develop.2",
     "rxjs": "^6.5.3 || ^7.0.0"
   },
   "dependencies": {
     "tslib": "^2.3.1",
-    "@progress/kendo-angular-schematics": "19.1.2-develop.1",
+    "@progress/kendo-angular-schematics": "19.1.2-develop.2",
     "@progress/kendo-file-saver": "^1.0.1",
     "@progress/kendo-pdfviewer-common": "0.4.1"
   },

package/pdfviewer.component.d.ts

@@ -16,7 +16,16 @@ import { ToolbarComponent } from './toolbar/toolbar.component';
 import 'pdfjs-dist/build/pdf.worker.min.mjs';
 import * as i0 from "@angular/core";
 /**
- * Represents the [Kendo UI PDFViewer component for Angular]({% slug overview_pdfviewer %}).
+ * Represents the [Kendo UI PDFViewer component for Angular](slug:overview_pdfviewer).
+ *
+ * @example
+ * ```html
+ * <kendo-pdfviewer
+ *   [url]="pdfUrl"
+ *   [zoom]="1.25"
+ *   [tools]="['pager', 'zoomInOut', 'zoom', 'download', 'print']">
+ * </kendo-pdfviewer>
+ * ```
  */
 export declare class PDFViewerComponent implements OnInit, OnDestroy {
     private ngZone;
@@ -63,7 +72,7 @@ export declare class PDFViewerComponent implements OnInit, OnDestroy {
      */
     typedArray: TypedArray | undefined;
     /**
-     * The initial zoom level of the PDF document
+     * Sets the initial zoom level of the PDF document
      * ([see example](slug:tools_pdfviewer#zooming-tools)).
      *
      * @default 1.25
@@ -71,7 +80,7 @@ export declare class PDFViewerComponent implements OnInit, OnDestroy {
     set zoom(value: number | 'fitToPage' | 'fitToWidth');
     get zoom(): number;
     /**
-     * Represents the step the zoom level will be changed with when using the ZoomIn and ZoomOut tools.
+     * Represents the step the zoom level will be changed with when using the **ZoomIn** and **ZoomOut** tools.
      * @default 0.25
      */
     zoomRate: number;
@@ -86,35 +95,35 @@ export declare class PDFViewerComponent implements OnInit, OnDestroy {
      */
     maxZoom: number;
     /**
-     * Determines whether all PDF document pages will be initially loaded or new pages will be loaded on demand when needed.
+     * Sets whether the component loads all PDF document pages at once or loads new pages on demand when needed.
      *
      * @default false
      */
     loadOnDemand: boolean;
     /**
-     * The number of pages that will be loaded on demand.
+     * Sets the number of pages to load on demand when the `loadOnDemand` property is `true`.
      *
      * @default 1
      */
     loadOnDemandPageSize: number;
     /**
-     * The event fired when a PDF document is successfully loaded in the `PDFViewer` component.
+     * Fires when the component loads a PDF document successfully.
      */
     load: EventEmitter<PDFViewerLoadEvent>;
     /**
-     * The event fired when an error occurs during the loading or downloading of the PDF document.
+     * Fires when an error occurs while loading or downloading the PDF document.
      */
     error: EventEmitter<PDFViewerErrorEvent>;
     /**
-     * The event fired when an error occurs during the loading of the PDF document.
+     * Fires when the user clicks the **Download** tool of the loaded PDF document.
      */
     download: EventEmitter<PDFViewerDownloadEvent>;
     /**
-     * The event fired when the end user changes the page of the loaded PDF document.
+     * Fires when the user changes the page of the loaded PDF document.
      */
     pageChange: EventEmitter<PDFViewerPageChangeEvent>;
     /**
-     * The event fired when the end user changes the zoom level of the loaded PDF document.
+     * Fires when the user changes the zoom level of the loaded PDF document.
      */
     zoomLevelChange: EventEmitter<PDFViewerZoomChangeEvent>;
     private pagesContainer;
@@ -124,7 +133,7 @@ export declare class PDFViewerComponent implements OnInit, OnDestroy {
     get currentPage(): number;
     set pdfContext(doc: PDFViewerContext);
     /**
-     * Exposes the currently loaded `PDF.js` document, its pages, and their DOM element wrapper.
+     * Exposes the loaded `PDF.js` document, its pages, and their DOM element wrapper.
      */
     get pdfContext(): PDFViewerContext;
     /**

package/pdfviewer.module.d.ts

@@ -6,8 +6,22 @@ import * as i0 from "@angular/core";
 import * as i1 from "./pdfviewer.component";
 import * as i2 from "./localization/custom-messages.component";
 /**
- * Represents the [NgModule](link:site.data.urls.angular['ngmoduleapi'])
- * definition for the PDFViewer component.
+ * Represents the [`NgModule`](link:site.data.urls.angular['ngmoduleapi']) definition for the PDFViewer component.
+ *
+ * @example
+ * ```typescript
+ * import { NgModule } from '@angular/core';
+ * import { BrowserModule } from '@angular/platform-browser';
+ * import { PDFViewerModule } from '@progress/kendo-angular-pdf-viewer';
+ * import { AppComponent } from './app.component';
+ *
+ * @NgModule({
+ *   declarations: [AppComponent],
+ *   imports: [BrowserModule, PDFViewerModule],
+ *   bootstrap: [AppComponent]
+ * })
+ * export class AppModule {}
+ * ```
  */
 export declare class PDFViewerModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<PDFViewerModule, never>;

package/schematics/ngAdd/index.js

@@ -4,8 +4,8 @@ const schematics_1 = require("@angular-devkit/schematics");
 function default_1(options) {
     const finalOptions = Object.assign(Object.assign({}, options), { mainNgModule: 'PDFViewerModule', package: 'pdfviewer', peerDependencies: {
             // peers of the dropdowns
-            '@progress/kendo-angular-navigation': '19.1.2-develop.1',
-            '@progress/kendo-angular-treeview': '19.1.2-develop.1'
+            '@progress/kendo-angular-navigation': '19.1.2-develop.2',
+            '@progress/kendo-angular-treeview': '19.1.2-develop.2'
         } });
     return (0, schematics_1.externalSchematic)('@progress/kendo-angular-schematics', 'ng-add', finalOptions);
 }