@progress/kendo-angular-pdf-export 19.1.1 → 19.1.2-develop.2

package/directives.d.ts

@@ -6,6 +6,20 @@ import { PDFExportMarginComponent } from "./pdf-export-margin.component";
 import { PDFExportTemplateDirective } from "./pdf-export-template.directive";
 import { PDFExportComponent } from "./pdf-export.component";
 /**
- * Utility array that contains all `PDFExport` related components and directives
+ * Use the `KENDO_PDFEXPORT` utility array to add all `@progress/kendo-angular-pdf-export`-related components and directives to a standalone Angular component.
+ *
+ * @example
+ * ```typescript
+ * import { Component } from '@angular/core';
+ * import { KENDO_PDFEXPORT } from "@progress/kendo-angular-pdf-export";
+ *
+ * @Component({
+ *   standalone: true,
+ *   imports: [KENDO_PDFEXPORT],
+ *   selector: 'my-app',
+ *   template: `<kendo-pdf-export></kendo-pdf-export>`
+ * })
+ * export class AppComponent {}
+ * ```
  */
 export declare const KENDO_PDFEXPORT: readonly [typeof PDFExportComponent, typeof PDFExportMarginComponent, typeof PDFExportTemplateDirective];

package/esm2022/directives.mjs

@@ -6,7 +6,21 @@ import { PDFExportMarginComponent } from "./pdf-export-margin.component";
 import { PDFExportTemplateDirective } from "./pdf-export-template.directive";
 import { PDFExportComponent } from "./pdf-export.component";
 /**
- * Utility array that contains all `PDFExport` related components and directives
+ * Use the `KENDO_PDFEXPORT` utility array to add all `@progress/kendo-angular-pdf-export`-related components and directives to a standalone Angular component.
+ *
+ * @example
+ * ```typescript
+ * import { Component } from '@angular/core';
+ * import { KENDO_PDFEXPORT } from "@progress/kendo-angular-pdf-export";
+ *
+ * @Component({
+ *   standalone: true,
+ *   imports: [KENDO_PDFEXPORT],
+ *   selector: 'my-app',
+ *   template: `<kendo-pdf-export></kendo-pdf-export>`
+ * })
+ * export class AppComponent {}
+ * ```
  */
 export const KENDO_PDFEXPORT = [
     PDFExportComponent,

package/esm2022/package-metadata.mjs

@@ -10,7 +10,7 @@ export const packageMetadata = {
     productName: 'Kendo UI for Angular',
     productCode: 'KENDOUIANGULAR',
     productCodes: ['KENDOUIANGULAR'],
-    publishDate: 1749540166,
-    version: '19.1.1',
+    publishDate: 1749820516,
+    version: '19.1.2-develop.2',
     licensingDocsUrl: 'https://www.telerik.com/kendo-angular-ui/my-license/'
 };

package/esm2022/pdf-export-margin.component.mjs

@@ -7,26 +7,40 @@ import * as i0 from "@angular/core";
 const FIELDS = ['bottom', 'left', 'right', 'top'];
 /**
  * Represents the Kendo UI PDFMargin component for Angular.
+ *
+ * @example
+ * ```html
+ * <kendo-pdf-export-margin top="2cm" left="1cm" right="1cm" bottom="2cm">
+ * </kendo-pdf-export-margin>
+ * ```
  */
 export class PDFExportMarginComponent {
     /**
-     * The bottom margin. The supported units are `"mm"`, `"cm"`, `"in"`, and `"pt"` (default).
-     * Numbers are considered to be points (`"pt"`).
+     * Sets the left margin of the PDF page. Accepts a `number` or `string` value.
+     *
+     * The supported units are `"mm"`, `"cm"`, `"in"`, and `"pt"`. Numbers use points (`"pt"`).
+     * @default "pt"
      */
     left;
     /**
-     * The top margin. The supported units are `"mm"`, `"cm"`, `"in"`, and `"pt"` (default).
-     * Numbers are considered to be points (`"pt"`).
+     * Sets the top margin of the PDF page. Accepts a `number` or `string` value.
+     *
+     * The supported units are `"mm"`, `"cm"`, `"in"`, and `"pt"`. Numbers use points (`"pt"`).
+     * @default "pt"
      */
     top;
     /**
-     * The right margin. The supported units are `"mm"`, `"cm"`, `"in"`, and `"pt"` (default).
-     * Numbers are considered to be points (`"pt"`).
+     * Sets the right margin of the PDF page. Accepts a `number` or `string` value.
+     *
+     * The supported units are `"mm"`, `"cm"`, `"in"`, and `"pt"`. Numbers use points (`"pt"`).
+     * @default "pt"
      */
     right;
     /**
-     * The bottom margin. The supported units are `"mm"`, `"cm"`, `"in"`, and `"pt"` (default).
-     * Numbers are considered to be points (`"pt"`).
+     * Sets the bottom margin of the PDF page. Accepts a `number` or `string` value.
+     *
+     * The supported units are `"mm"`, `"cm"`, `"in"`, and `"pt"`. Numbers use points (`"pt"`).
+     * @default "pt"
      */
     bottom;
     /**

package/esm2022/pdf-export-template.directive.mjs

@@ -4,6 +4,18 @@
 *-------------------------------------------------------------------------------------------*/
 import { Directive, Optional, TemplateRef } from '@angular/core';
 import * as i0 from "@angular/core";
+/**
+ * Represents the directive for defining a custom page template in the PDF Export component ([see example](slug:multipagecontent_pdfexport#page-templates)).
+ *
+ * @example
+ * ```html
+ * <kendo-pdf-export paperSize="A4" margin="2cm">
+ *    <ng-template kendoPDFTemplate let-pageNum="pageNum">
+ *        <div>Page {{ pageNum }}</div>
+ *    </ng-template>
+ * </kendo-pdf-export>
+ * ```
+ */
 export class PDFExportTemplateDirective {
     templateRef;
     constructor(templateRef) {

package/esm2022/pdf-export.component.mjs

@@ -12,153 +12,133 @@ import { PDFExportMarginComponent } from './pdf-export-margin.component';
 import { compileTemplate } from './compile-template';
 import * as i0 from "@angular/core";
 /**
- * Represents the [Kendo UI PDF Export component for Angular]({% slug overview_pdfexport %}).
+ * Represents the [Kendo UI PDF Export component for Angular](slug:overview_pdfexport).
  *
  * @example
- * ```ts-preview
- * _@Component({
- *   selector: 'my-app',
- *   template: `
- *     <div class="example-config">
- *       <button kendoButton (click)="pdf.saveAs('document.pdf')">
- *         Save As PDF...
- *       </button>
- *     </div>
+ * ```html
+ * <button kendoButton (click)="pdf.saveAs('document.pdf')">
+ *    Save As PDF...
+ * </button>
  *
- *     <kendo-pdf-export #pdf paperSize="A4" margin="2cm">
- *       Content goes here
- *     </kendo-pdf-export>
- *   `
- * })
- * export class AppComponent {
- * }
+ * <kendo-pdf-export #pdf paperSize="A4" margin="2cm">
+ *    Content goes here
+ * </kendo-pdf-export>
  * ```
  */
 export class PDFExportComponent {
     element;
     /**
-     * Specifies if the Print dialog should be opened immediately after loading the document ([see example](slug:autoprint_pdfexport)).
+     * If `true`, opens the Print dialog immediately after the PDF loads ([see example](slug:autoprint_pdfexport)).
      * Requires `@progress/kendo-drawing` v1.9.0 or later.
      * @default false
      */
     autoPrint;
     /**
-     * The author (metadata) of the PDF document.
+     * Sets the author metadata for the PDF document.
      */
     author;
     /**
-     * A flag that indicates whether to produce actual hyperlinks in the exported PDF file ([see example](slug:hyperlinks_pdfexport)).
-     * It is also possible to set a CSS selector. All matching links will be ignored.
+     * Specifies whether actual hyperlinks will be produced in the exported PDF file ([see example](slug:hyperlinks_pdfexport)). You can also set a CSS selector to ignore matching links.
      */
     avoidLinks;
     /**
-     * An optional CSS selector that specifies the elements which cause the page breaks
-     * ([see example]({% slug multipagecontent_pdfexport %}#toc-manual-page-breaking)).
+     * Sets a CSS selector for elements that cause page breaks
+     * ([see example](slug:multipagecontent_pdfexport#toc-manual-page-breaking)).
      */
     forcePageBreak;
     /**
-     * An optional CSS selector that specifies the elements which should not be split across the pages
-     * ([see example]({% slug multipagecontent_pdfexport %}#toc-preventing-page-breaking-in-elements)).
+     * Sets a CSS selector for elements that should not split across pages
+     * ([see example](slug:multipagecontent_pdfexport#toc-preventing-page-breaking-in-elements)).
      */
     keepTogether;
     /**
-     * The creator of the PDF document.
+     * Sets the creator metadata for the PDF document.
      * @default "Kendo UI PDF Generator"
      */
     creator = 'Kendo UI PDF Generator';
     /**
-     * The date when the PDF document is created. Defaults to `new Date()`.
+     * Sets the creation date for the PDF document. Defaults to `new Date()`.
+     * @default new Date()
      */
     date;
     /**
-     * The forced resolution of the images in the exported PDF document
-     * ([see example]({% slug embeddedimages_pdfexport %})).
-     * By default, the images are exported at their full resolution.
+     * Sets the image resolution in the exported PDF ([see example](slug:embeddedimages_pdfexport)). By default, images use full resolution.
      */
     imageResolution;
     /**
-     * Specifies the name of the exported PDF file.
+     * Sets the name of the exported PDF file.
      * @default "export.pdf"
      */
     fileName = 'export.pdf';
     /**
-     * If set to `true`, the content is forwarded to `proxyURL` even if the
-     * browser supports local saving of files.
+     * If `true`, forwards content to `proxyURL` even if the browser supports local file saving.
      */
     forceProxy;
     /**
-     * The keywords (metadata) of the PDF document.
+     * Sets the keywords metadata for the PDF document.
      */
     keywords;
     /**
-     * A flag that indicates if the page will be in a landscape orientation.
-     * By default, the page is in a portrait orientation.
-     *
+     * If `true`, sets the page orientation to landscape. The default page orientation is portrait.
      * @default false
      */
     landscape;
     /**
-     * Specifies the margins of the page. Numbers are treated as points (`"pt"`).
-     *
+     * Sets the page margins. Numbers use points (`"pt"`).
      */
     margin;
     /**
-     * Specifies the paper size of the PDF document ([see example]({% slug multipagecontent_pdfexport %}#toc-automatic-page-breaking)).
-     * Defaults to `"auto"` which means that the paper size is determined by the content.
+     * Sets the paper size for the PDF document. Defaults to `"auto"`, which means the content determines the size of the document.
      * The size of the content in pixels matches the size of the output in points (1 pixel = 1/72 inch).
-     * If `paperSize` is set, the content is split across multiple pages. This enables the `repeatHeaders` and
-     * `scale` options, and allows you to specify a template.
      *
-     * The paper size can be a `PaperSize`, an array of two numbers which specify the width and height in points (1 pt = 1/72 in), or an
-     * array of two strings which specify the width and height in units. The supported units are `"mm"`, `"cm"`, `"in"`, and `"pt"`.
-     * @default 'auto'
+     * If set, the content splits across pages, and allows you to use `repeatHeaders`, `scale`, and a template.
+     *
+     * The value can be a `PaperSize`, an array of two numbers (width and height in points), or an array of two strings (width and height in units: `"mm"`, `"cm"`, `"in"`, or `"pt"`).
+     * @default "auto"
      */
     paperSize;
     /**
-     * Specifies if the `<thead>` elements of the tables will be repeated on each page
-     * ([see example]({% slug recurrenttableheaders_pdfexport %})).
+     * If `true`, repeats the `<thead>` elements of tables on each page. This helps keep table headers visible on every page
+     * ([see example](slug:recurrenttableheaders_pdfexport)).
      */
     repeatHeaders;
     /**
-     * A scale factor ([see example]({% slug scalingofcontent_pdfexport %})).
-     * The text size on the screen might be too big for printing.
-     * To scale down the output in PDF, use this option.
+     * Sets a scale factor for the PDF output. Use this to make the PDF content smaller or larger
+     * ([see example](slug:scalingofcontent_pdfexport)).
      *
      * @default 1
      */
     scale;
     /**
-     * A key/value dictionary of form values which will be sent to the proxy.
-     * Can be used to submit Anti-Forgery tokens and other metadata.
+     * Sets a key/value dictionary of form values sent to the proxy. Use this to send extra data, like Anti-Forgery tokens.
      */
     proxyData;
     /**
-     * The URL of the server-side proxy which streams the file to the end user. You need to use a proxy if
+     * Sets the server-side proxy URL for streaming the file to the user. You need to implement a proxy if
      * the browser is not capable of saving files locally.
-     * It is your responsibility to implement the server-side proxy. The proxy returns the decoded file with
-     * the `"Content-Disposition"` header set to `attachment; filename="<fileName.pdf>"`.
+     * The proxy returns the decoded file with the `"Content-Disposition"` header set to `attachment; filename="<fileName.pdf>"`.
      *
-     * In the request body, the proxy receives a POST request with the specific parameters.
-     * [See example](slug:server_proxy#toc-implementations).
+     * In the request body, the proxy receives a POST request with the specific parameters
+     * ([see example](slug:server_proxy#toc-implementations)).
      */
     proxyURL;
     /**
-     * A name or keyword which indicates where to display the document that is returned from the proxy.
+     * Sets where to display the document returned from the proxy. Use `"_self"` to display in the same window.
      * To display the document in a new window or iframe,
-     * the proxy has to have the `"Content-Disposition"` header set to `inline; filename="<fileName.pdf>"`.
+     * the proxy must have the `"Content-Disposition"` header set to `inline; filename="<fileName.pdf>"`.
      * @default "_self"
      */
     proxyTarget;
     /**
-     * The producer (metadata) of the PDF document.
+     * Sets the producer metadata for the PDF document.
      */
     producer;
     /**
-     * The subject (metadata) of the PDF document.
+     * Sets the subject metadata for the PDF document.
      */
     subject;
     /**
-     * The title (metadata) of the PDF document.
+     * Sets the title metadata for the PDF document.
      */
     title;
     /**

package/esm2022/pdf-export.module.mjs

@@ -10,7 +10,22 @@ import * as i2 from "./pdf-export-margin.component";
 import * as i3 from "./pdf-export-template.directive";
 // IMPORTANT: NgModule export kept for backwards compatibility
 /**
- * Represents the [NgModule](link:site.data.urls.angular['ngmoduleapi']) definition for the PDF Export directive.
+ * Represents the [`NgModule`](link:site.data.urls.angular['ngmoduleapi']) definition for the PDF Export component.
+ *
+ * @example
+ * ```typescript
+ * import { NgModule } from '@angular/core';
+ * import { BrowserModule } from '@angular/platform-browser';
+ * import { PDFExportModule } from '@progress/kendo-angular-pdf-export';
+ * import { AppComponent } from './app.component';
+ *
+ * @NgModule({
+ *   declarations: [AppComponent],
+ *   imports: [BrowserModule, PDFExportModule],
+ *   bootstrap: [AppComponent]
+ * })
+ * export class AppModule {}
+ * ```
  */
 export class PDFExportModule {
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "16.2.12", ngImport: i0, type: PDFExportModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule });

package/fesm2022/progress-kendo-angular-pdf-export.mjs

@@ -16,11 +16,23 @@ const packageMetadata = {
     productName: 'Kendo UI for Angular',
     productCode: 'KENDOUIANGULAR',
     productCodes: ['KENDOUIANGULAR'],
-    publishDate: 1749540166,
-    version: '19.1.1',
+    publishDate: 1749820516,
+    version: '19.1.2-develop.2',
     licensingDocsUrl: 'https://www.telerik.com/kendo-angular-ui/my-license/'
 };
 
+/**
+ * Represents the directive for defining a custom page template in the PDF Export component ([see example](slug:multipagecontent_pdfexport#page-templates)).
+ *
+ * @example
+ * ```html
+ * <kendo-pdf-export paperSize="A4" margin="2cm">
+ *    <ng-template kendoPDFTemplate let-pageNum="pageNum">
+ *        <div>Page {{ pageNum }}</div>
+ *    </ng-template>
+ * </kendo-pdf-export>
+ * ```
+ */
 class PDFExportTemplateDirective {
     templateRef;
     constructor(templateRef) {
@@ -42,26 +54,40 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
 const FIELDS = ['bottom', 'left', 'right', 'top'];
 /**
  * Represents the Kendo UI PDFMargin component for Angular.
+ *
+ * @example
+ * ```html
+ * <kendo-pdf-export-margin top="2cm" left="1cm" right="1cm" bottom="2cm">
+ * </kendo-pdf-export-margin>
+ * ```
  */
 class PDFExportMarginComponent {
     /**
-     * The bottom margin. The supported units are `"mm"`, `"cm"`, `"in"`, and `"pt"` (default).
-     * Numbers are considered to be points (`"pt"`).
+     * Sets the left margin of the PDF page. Accepts a `number` or `string` value.
+     *
+     * The supported units are `"mm"`, `"cm"`, `"in"`, and `"pt"`. Numbers use points (`"pt"`).
+     * @default "pt"
      */
     left;
     /**
-     * The top margin. The supported units are `"mm"`, `"cm"`, `"in"`, and `"pt"` (default).
-     * Numbers are considered to be points (`"pt"`).
+     * Sets the top margin of the PDF page. Accepts a `number` or `string` value.
+     *
+     * The supported units are `"mm"`, `"cm"`, `"in"`, and `"pt"`. Numbers use points (`"pt"`).
+     * @default "pt"
      */
     top;
     /**
-     * The right margin. The supported units are `"mm"`, `"cm"`, `"in"`, and `"pt"` (default).
-     * Numbers are considered to be points (`"pt"`).
+     * Sets the right margin of the PDF page. Accepts a `number` or `string` value.
+     *
+     * The supported units are `"mm"`, `"cm"`, `"in"`, and `"pt"`. Numbers use points (`"pt"`).
+     * @default "pt"
      */
     right;
     /**
-     * The bottom margin. The supported units are `"mm"`, `"cm"`, `"in"`, and `"pt"` (default).
-     * Numbers are considered to be points (`"pt"`).
+     * Sets the bottom margin of the PDF page. Accepts a `number` or `string` value.
+     *
+     * The supported units are `"mm"`, `"cm"`, `"in"`, and `"pt"`. Numbers use points (`"pt"`).
+     * @default "pt"
      */
     bottom;
     /**
@@ -121,153 +147,133 @@ const compileTemplate = (templateRef) => {
 };
 
 /**
- * Represents the [Kendo UI PDF Export component for Angular]({% slug overview_pdfexport %}).
+ * Represents the [Kendo UI PDF Export component for Angular](slug:overview_pdfexport).
  *
  * @example
- * ```ts-preview
- * _@Component({
- *   selector: 'my-app',
- *   template: `
- *     <div class="example-config">
- *       <button kendoButton (click)="pdf.saveAs('document.pdf')">
- *         Save As PDF...
- *       </button>
- *     </div>
+ * ```html
+ * <button kendoButton (click)="pdf.saveAs('document.pdf')">
+ *    Save As PDF...
+ * </button>
  *
- *     <kendo-pdf-export #pdf paperSize="A4" margin="2cm">
- *       Content goes here
- *     </kendo-pdf-export>
- *   `
- * })
- * export class AppComponent {
- * }
+ * <kendo-pdf-export #pdf paperSize="A4" margin="2cm">
+ *    Content goes here
+ * </kendo-pdf-export>
  * ```
  */
 class PDFExportComponent {
     element;
     /**
-     * Specifies if the Print dialog should be opened immediately after loading the document ([see example](slug:autoprint_pdfexport)).
+     * If `true`, opens the Print dialog immediately after the PDF loads ([see example](slug:autoprint_pdfexport)).
      * Requires `@progress/kendo-drawing` v1.9.0 or later.
      * @default false
      */
     autoPrint;
     /**
-     * The author (metadata) of the PDF document.
+     * Sets the author metadata for the PDF document.
      */
     author;
     /**
-     * A flag that indicates whether to produce actual hyperlinks in the exported PDF file ([see example](slug:hyperlinks_pdfexport)).
-     * It is also possible to set a CSS selector. All matching links will be ignored.
+     * Specifies whether actual hyperlinks will be produced in the exported PDF file ([see example](slug:hyperlinks_pdfexport)). You can also set a CSS selector to ignore matching links.
      */
     avoidLinks;
     /**
-     * An optional CSS selector that specifies the elements which cause the page breaks
-     * ([see example]({% slug multipagecontent_pdfexport %}#toc-manual-page-breaking)).
+     * Sets a CSS selector for elements that cause page breaks
+     * ([see example](slug:multipagecontent_pdfexport#toc-manual-page-breaking)).
      */
     forcePageBreak;
     /**
-     * An optional CSS selector that specifies the elements which should not be split across the pages
-     * ([see example]({% slug multipagecontent_pdfexport %}#toc-preventing-page-breaking-in-elements)).
+     * Sets a CSS selector for elements that should not split across pages
+     * ([see example](slug:multipagecontent_pdfexport#toc-preventing-page-breaking-in-elements)).
      */
     keepTogether;
     /**
-     * The creator of the PDF document.
+     * Sets the creator metadata for the PDF document.
      * @default "Kendo UI PDF Generator"
      */
     creator = 'Kendo UI PDF Generator';
     /**
-     * The date when the PDF document is created. Defaults to `new Date()`.
+     * Sets the creation date for the PDF document. Defaults to `new Date()`.
+     * @default new Date()
      */
     date;
     /**
-     * The forced resolution of the images in the exported PDF document
-     * ([see example]({% slug embeddedimages_pdfexport %})).
-     * By default, the images are exported at their full resolution.
+     * Sets the image resolution in the exported PDF ([see example](slug:embeddedimages_pdfexport)). By default, images use full resolution.
      */
     imageResolution;
     /**
-     * Specifies the name of the exported PDF file.
+     * Sets the name of the exported PDF file.
      * @default "export.pdf"
      */
     fileName = 'export.pdf';
     /**
-     * If set to `true`, the content is forwarded to `proxyURL` even if the
-     * browser supports local saving of files.
+     * If `true`, forwards content to `proxyURL` even if the browser supports local file saving.
      */
     forceProxy;
     /**
-     * The keywords (metadata) of the PDF document.
+     * Sets the keywords metadata for the PDF document.
      */
     keywords;
     /**
-     * A flag that indicates if the page will be in a landscape orientation.
-     * By default, the page is in a portrait orientation.
-     *
+     * If `true`, sets the page orientation to landscape. The default page orientation is portrait.
      * @default false
      */
     landscape;
     /**
-     * Specifies the margins of the page. Numbers are treated as points (`"pt"`).
-     *
+     * Sets the page margins. Numbers use points (`"pt"`).
      */
     margin;
     /**
-     * Specifies the paper size of the PDF document ([see example]({% slug multipagecontent_pdfexport %}#toc-automatic-page-breaking)).
-     * Defaults to `"auto"` which means that the paper size is determined by the content.
+     * Sets the paper size for the PDF document. Defaults to `"auto"`, which means the content determines the size of the document.
      * The size of the content in pixels matches the size of the output in points (1 pixel = 1/72 inch).
-     * If `paperSize` is set, the content is split across multiple pages. This enables the `repeatHeaders` and
-     * `scale` options, and allows you to specify a template.
      *
-     * The paper size can be a `PaperSize`, an array of two numbers which specify the width and height in points (1 pt = 1/72 in), or an
-     * array of two strings which specify the width and height in units. The supported units are `"mm"`, `"cm"`, `"in"`, and `"pt"`.
-     * @default 'auto'
+     * If set, the content splits across pages, and allows you to use `repeatHeaders`, `scale`, and a template.
+     *
+     * The value can be a `PaperSize`, an array of two numbers (width and height in points), or an array of two strings (width and height in units: `"mm"`, `"cm"`, `"in"`, or `"pt"`).
+     * @default "auto"
      */
     paperSize;
     /**
-     * Specifies if the `<thead>` elements of the tables will be repeated on each page
-     * ([see example]({% slug recurrenttableheaders_pdfexport %})).
+     * If `true`, repeats the `<thead>` elements of tables on each page. This helps keep table headers visible on every page
+     * ([see example](slug:recurrenttableheaders_pdfexport)).
      */
     repeatHeaders;
     /**
-     * A scale factor ([see example]({% slug scalingofcontent_pdfexport %})).
-     * The text size on the screen might be too big for printing.
-     * To scale down the output in PDF, use this option.
+     * Sets a scale factor for the PDF output. Use this to make the PDF content smaller or larger
+     * ([see example](slug:scalingofcontent_pdfexport)).
      *
      * @default 1
      */
     scale;
     /**
-     * A key/value dictionary of form values which will be sent to the proxy.
-     * Can be used to submit Anti-Forgery tokens and other metadata.
+     * Sets a key/value dictionary of form values sent to the proxy. Use this to send extra data, like Anti-Forgery tokens.
      */
     proxyData;
     /**
-     * The URL of the server-side proxy which streams the file to the end user. You need to use a proxy if
+     * Sets the server-side proxy URL for streaming the file to the user. You need to implement a proxy if
      * the browser is not capable of saving files locally.
-     * It is your responsibility to implement the server-side proxy. The proxy returns the decoded file with
-     * the `"Content-Disposition"` header set to `attachment; filename="<fileName.pdf>"`.
+     * The proxy returns the decoded file with the `"Content-Disposition"` header set to `attachment; filename="<fileName.pdf>"`.
      *
-     * In the request body, the proxy receives a POST request with the specific parameters.
-     * [See example](slug:server_proxy#toc-implementations).
+     * In the request body, the proxy receives a POST request with the specific parameters
+     * ([see example](slug:server_proxy#toc-implementations)).
      */
     proxyURL;
     /**
-     * A name or keyword which indicates where to display the document that is returned from the proxy.
+     * Sets where to display the document returned from the proxy. Use `"_self"` to display in the same window.
      * To display the document in a new window or iframe,
-     * the proxy has to have the `"Content-Disposition"` header set to `inline; filename="<fileName.pdf>"`.
+     * the proxy must have the `"Content-Disposition"` header set to `inline; filename="<fileName.pdf>"`.
      * @default "_self"
      */
     proxyTarget;
     /**
-     * The producer (metadata) of the PDF document.
+     * Sets the producer metadata for the PDF document.
      */
     producer;
     /**
-     * The subject (metadata) of the PDF document.
+     * Sets the subject metadata for the PDF document.
      */
     subject;
     /**
-     * The title (metadata) of the PDF document.
+     * Sets the title metadata for the PDF document.
      */
     title;
     /**
@@ -436,7 +442,21 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
             }] } });
 
 /**
- * Utility array that contains all `PDFExport` related components and directives
+ * Use the `KENDO_PDFEXPORT` utility array to add all `@progress/kendo-angular-pdf-export`-related components and directives to a standalone Angular component.
+ *
+ * @example
+ * ```typescript
+ * import { Component } from '@angular/core';
+ * import { KENDO_PDFEXPORT } from "@progress/kendo-angular-pdf-export";
+ *
+ * @Component({
+ *   standalone: true,
+ *   imports: [KENDO_PDFEXPORT],
+ *   selector: 'my-app',
+ *   template: `<kendo-pdf-export></kendo-pdf-export>`
+ * })
+ * export class AppComponent {}
+ * ```
  */
 const KENDO_PDFEXPORT = [
     PDFExportComponent,
@@ -446,7 +466,22 @@ const KENDO_PDFEXPORT = [
 
 // IMPORTANT: NgModule export kept for backwards compatibility
 /**
- * Represents the [NgModule](link:site.data.urls.angular['ngmoduleapi']) definition for the PDF Export directive.
+ * Represents the [`NgModule`](link:site.data.urls.angular['ngmoduleapi']) definition for the PDF Export component.
+ *
+ * @example
+ * ```typescript
+ * import { NgModule } from '@angular/core';
+ * import { BrowserModule } from '@angular/platform-browser';
+ * import { PDFExportModule } from '@progress/kendo-angular-pdf-export';
+ * import { AppComponent } from './app.component';
+ *
+ * @NgModule({
+ *   declarations: [AppComponent],
+ *   imports: [BrowserModule, PDFExportModule],
+ *   bootstrap: [AppComponent]
+ * })
+ * export class AppModule {}
+ * ```
  */
 class PDFExportModule {
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "16.2.12", ngImport: i0, type: PDFExportModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@progress/kendo-angular-pdf-export",
-  "version": "19.1.1",
+  "version": "19.1.2-develop.2",
   "description": "Kendo UI for Angular PDF Export Component",
   "license": "SEE LICENSE IN LICENSE.md",
   "author": "Progress",
@@ -17,7 +17,7 @@
     "package": {
       "productName": "Kendo UI for Angular",
       "productCode": "KENDOUIANGULAR",
-      "publishDate": 1749540166,
+      "publishDate": 1749820516,
       "licensingDocsUrl": "https://www.telerik.com/kendo-angular-ui/my-license/"
     }
   },
@@ -28,12 +28,12 @@
     "@angular/platform-browser": "16 - 20",
     "@progress/kendo-drawing": "^1.21.0",
     "@progress/kendo-licensing": "^1.5.0",
-    "@progress/kendo-angular-common": "19.1.1",
+    "@progress/kendo-angular-common": "19.1.2-develop.2",
     "rxjs": "^6.5.3 || ^7.0.0"
   },
   "dependencies": {
     "tslib": "^2.3.1",
-    "@progress/kendo-angular-schematics": "19.1.1",
+    "@progress/kendo-angular-schematics": "19.1.2-develop.2",
     "@progress/kendo-file-saver": "^1.0.1"
   },
   "schematics": "./schematics/collection.json",

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

@@ -6,26 +6,40 @@ import { pdf } from '@progress/kendo-drawing';
 import * as i0 from "@angular/core";
 /**
  * Represents the Kendo UI PDFMargin component for Angular.
+ *
+ * @example
+ * ```html
+ * <kendo-pdf-export-margin top="2cm" left="1cm" right="1cm" bottom="2cm">
+ * </kendo-pdf-export-margin>
+ * ```
  */
 export declare class PDFExportMarginComponent implements pdf.PageMargin {
     /**
-     * The bottom margin. The supported units are `"mm"`, `"cm"`, `"in"`, and `"pt"` (default).
-     * Numbers are considered to be points (`"pt"`).
+     * Sets the left margin of the PDF page. Accepts a `number` or `string` value.
+     *
+     * The supported units are `"mm"`, `"cm"`, `"in"`, and `"pt"`. Numbers use points (`"pt"`).
+     * @default "pt"
      */
     left?: number | string;
     /**
-     * The top margin. The supported units are `"mm"`, `"cm"`, `"in"`, and `"pt"` (default).
-     * Numbers are considered to be points (`"pt"`).
+     * Sets the top margin of the PDF page. Accepts a `number` or `string` value.
+     *
+     * The supported units are `"mm"`, `"cm"`, `"in"`, and `"pt"`. Numbers use points (`"pt"`).
+     * @default "pt"
      */
     top?: number | string;
     /**
-     * The right margin. The supported units are `"mm"`, `"cm"`, `"in"`, and `"pt"` (default).
-     * Numbers are considered to be points (`"pt"`).
+     * Sets the right margin of the PDF page. Accepts a `number` or `string` value.
+     *
+     * The supported units are `"mm"`, `"cm"`, `"in"`, and `"pt"`. Numbers use points (`"pt"`).
+     * @default "pt"
      */
     right?: number | string;
     /**
-     * The bottom margin. The supported units are `"mm"`, `"cm"`, `"in"`, and `"pt"` (default).
-     * Numbers are considered to be points (`"pt"`).
+     * Sets the bottom margin of the PDF page. Accepts a `number` or `string` value.
+     *
+     * The supported units are `"mm"`, `"cm"`, `"in"`, and `"pt"`. Numbers use points (`"pt"`).
+     * @default "pt"
      */
     bottom?: number | string;
     /**

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

@@ -4,6 +4,18 @@
 *-------------------------------------------------------------------------------------------*/
 import { TemplateRef } from '@angular/core';
 import * as i0 from "@angular/core";
+/**
+ * Represents the directive for defining a custom page template in the PDF Export component ([see example](slug:multipagecontent_pdfexport#page-templates)).
+ *
+ * @example
+ * ```html
+ * <kendo-pdf-export paperSize="A4" margin="2cm">
+ *    <ng-template kendoPDFTemplate let-pageNum="pageNum">
+ *        <div>Page {{ pageNum }}</div>
+ *    </ng-template>
+ * </kendo-pdf-export>
+ * ```
+ */
 export declare class PDFExportTemplateDirective {
     templateRef: TemplateRef<any>;
     constructor(templateRef: TemplateRef<any>);

package/pdf-export.component.d.ts

@@ -18,155 +18,135 @@ import * as i0 from "@angular/core";
  */
 export type PaperSize = pdf.PaperSize;
 /**
- * Represents the [Kendo UI PDF Export component for Angular]({% slug overview_pdfexport %}).
+ * Represents the [Kendo UI PDF Export component for Angular](slug:overview_pdfexport).
  *
  * @example
- * ```ts-preview
- * _@Component({
- *   selector: 'my-app',
- *   template: `
- *     <div class="example-config">
- *       <button kendoButton (click)="pdf.saveAs('document.pdf')">
- *         Save As PDF...
- *       </button>
- *     </div>
+ * ```html
+ * <button kendoButton (click)="pdf.saveAs('document.pdf')">
+ *    Save As PDF...
+ * </button>
  *
- *     <kendo-pdf-export #pdf paperSize="A4" margin="2cm">
- *       Content goes here
- *     </kendo-pdf-export>
- *   `
- * })
- * export class AppComponent {
- * }
+ * <kendo-pdf-export #pdf paperSize="A4" margin="2cm">
+ *    Content goes here
+ * </kendo-pdf-export>
  * ```
  */
 export declare class PDFExportComponent implements pdf.PDFOptions {
     protected element: ElementRef;
     /**
-     * Specifies if the Print dialog should be opened immediately after loading the document ([see example](slug:autoprint_pdfexport)).
+     * If `true`, opens the Print dialog immediately after the PDF loads ([see example](slug:autoprint_pdfexport)).
      * Requires `@progress/kendo-drawing` v1.9.0 or later.
      * @default false
      */
     autoPrint?: boolean;
     /**
-     * The author (metadata) of the PDF document.
+     * Sets the author metadata for the PDF document.
      */
     author: string;
     /**
-     * A flag that indicates whether to produce actual hyperlinks in the exported PDF file ([see example](slug:hyperlinks_pdfexport)).
-     * It is also possible to set a CSS selector. All matching links will be ignored.
+     * Specifies whether actual hyperlinks will be produced in the exported PDF file ([see example](slug:hyperlinks_pdfexport)). You can also set a CSS selector to ignore matching links.
      */
     avoidLinks: boolean | string;
     /**
-     * An optional CSS selector that specifies the elements which cause the page breaks
-     * ([see example]({% slug multipagecontent_pdfexport %}#toc-manual-page-breaking)).
+     * Sets a CSS selector for elements that cause page breaks
+     * ([see example](slug:multipagecontent_pdfexport#toc-manual-page-breaking)).
      */
     forcePageBreak: string;
     /**
-     * An optional CSS selector that specifies the elements which should not be split across the pages
-     * ([see example]({% slug multipagecontent_pdfexport %}#toc-preventing-page-breaking-in-elements)).
+     * Sets a CSS selector for elements that should not split across pages
+     * ([see example](slug:multipagecontent_pdfexport#toc-preventing-page-breaking-in-elements)).
      */
     keepTogether: string;
     /**
-     * The creator of the PDF document.
+     * Sets the creator metadata for the PDF document.
      * @default "Kendo UI PDF Generator"
      */
     creator: string;
     /**
-     * The date when the PDF document is created. Defaults to `new Date()`.
+     * Sets the creation date for the PDF document. Defaults to `new Date()`.
+     * @default new Date()
      */
     date: Date;
     /**
-     * The forced resolution of the images in the exported PDF document
-     * ([see example]({% slug embeddedimages_pdfexport %})).
-     * By default, the images are exported at their full resolution.
+     * Sets the image resolution in the exported PDF ([see example](slug:embeddedimages_pdfexport)). By default, images use full resolution.
      */
     imageResolution: number;
     /**
-     * Specifies the name of the exported PDF file.
+     * Sets the name of the exported PDF file.
      * @default "export.pdf"
      */
     fileName: string;
     /**
-     * If set to `true`, the content is forwarded to `proxyURL` even if the
-     * browser supports local saving of files.
+     * If `true`, forwards content to `proxyURL` even if the browser supports local file saving.
      */
     forceProxy: boolean;
     /**
-     * The keywords (metadata) of the PDF document.
+     * Sets the keywords metadata for the PDF document.
      */
     keywords: string;
     /**
-     * A flag that indicates if the page will be in a landscape orientation.
-     * By default, the page is in a portrait orientation.
-     *
+     * If `true`, sets the page orientation to landscape. The default page orientation is portrait.
      * @default false
      */
     landscape: boolean;
     /**
-     * Specifies the margins of the page. Numbers are treated as points (`"pt"`).
-     *
+     * Sets the page margins. Numbers use points (`"pt"`).
      */
     margin: string | number | pdf.PageMargin;
     /**
-     * Specifies the paper size of the PDF document ([see example]({% slug multipagecontent_pdfexport %}#toc-automatic-page-breaking)).
-     * Defaults to `"auto"` which means that the paper size is determined by the content.
+     * Sets the paper size for the PDF document. Defaults to `"auto"`, which means the content determines the size of the document.
      * The size of the content in pixels matches the size of the output in points (1 pixel = 1/72 inch).
-     * If `paperSize` is set, the content is split across multiple pages. This enables the `repeatHeaders` and
-     * `scale` options, and allows you to specify a template.
      *
-     * The paper size can be a `PaperSize`, an array of two numbers which specify the width and height in points (1 pt = 1/72 in), or an
-     * array of two strings which specify the width and height in units. The supported units are `"mm"`, `"cm"`, `"in"`, and `"pt"`.
-     * @default 'auto'
+     * If set, the content splits across pages, and allows you to use `repeatHeaders`, `scale`, and a template.
+     *
+     * The value can be a `PaperSize`, an array of two numbers (width and height in points), or an array of two strings (width and height in units: `"mm"`, `"cm"`, `"in"`, or `"pt"`).
+     * @default "auto"
      */
     paperSize: PaperSize;
     /**
-     * Specifies if the `<thead>` elements of the tables will be repeated on each page
-     * ([see example]({% slug recurrenttableheaders_pdfexport %})).
+     * If `true`, repeats the `<thead>` elements of tables on each page. This helps keep table headers visible on every page
+     * ([see example](slug:recurrenttableheaders_pdfexport)).
      */
     repeatHeaders: boolean;
     /**
-     * A scale factor ([see example]({% slug scalingofcontent_pdfexport %})).
-     * The text size on the screen might be too big for printing.
-     * To scale down the output in PDF, use this option.
+     * Sets a scale factor for the PDF output. Use this to make the PDF content smaller or larger
+     * ([see example](slug:scalingofcontent_pdfexport)).
      *
      * @default 1
      */
     scale: number;
     /**
-     * A key/value dictionary of form values which will be sent to the proxy.
-     * Can be used to submit Anti-Forgery tokens and other metadata.
+     * Sets a key/value dictionary of form values sent to the proxy. Use this to send extra data, like Anti-Forgery tokens.
      */
     proxyData?: {
         [key: string]: string;
     };
     /**
-     * The URL of the server-side proxy which streams the file to the end user. You need to use a proxy if
+     * Sets the server-side proxy URL for streaming the file to the user. You need to implement a proxy if
      * the browser is not capable of saving files locally.
-     * It is your responsibility to implement the server-side proxy. The proxy returns the decoded file with
-     * the `"Content-Disposition"` header set to `attachment; filename="<fileName.pdf>"`.
+     * The proxy returns the decoded file with the `"Content-Disposition"` header set to `attachment; filename="<fileName.pdf>"`.
      *
-     * In the request body, the proxy receives a POST request with the specific parameters.
-     * [See example](slug:server_proxy#toc-implementations).
+     * In the request body, the proxy receives a POST request with the specific parameters
+     * ([see example](slug:server_proxy#toc-implementations)).
      */
     proxyURL: string;
     /**
-     * A name or keyword which indicates where to display the document that is returned from the proxy.
+     * Sets where to display the document returned from the proxy. Use `"_self"` to display in the same window.
      * To display the document in a new window or iframe,
-     * the proxy has to have the `"Content-Disposition"` header set to `inline; filename="<fileName.pdf>"`.
+     * the proxy must have the `"Content-Disposition"` header set to `inline; filename="<fileName.pdf>"`.
      * @default "_self"
      */
     proxyTarget: string;
     /**
-     * The producer (metadata) of the PDF document.
+     * Sets the producer metadata for the PDF document.
      */
     producer: string;
     /**
-     * The subject (metadata) of the PDF document.
+     * Sets the subject metadata for the PDF document.
      */
     subject: string;
     /**
-     * The title (metadata) of the PDF document.
+     * Sets the title metadata for the PDF document.
      */
     title: string;
     /**

package/pdf-export.module.d.ts

@@ -7,7 +7,22 @@ import * as i1 from "./pdf-export.component";
 import * as i2 from "./pdf-export-margin.component";
 import * as i3 from "./pdf-export-template.directive";
 /**
- * Represents the [NgModule](link:site.data.urls.angular['ngmoduleapi']) definition for the PDF Export directive.
+ * Represents the [`NgModule`](link:site.data.urls.angular['ngmoduleapi']) definition for the PDF Export component.
+ *
+ * @example
+ * ```typescript
+ * import { NgModule } from '@angular/core';
+ * import { BrowserModule } from '@angular/platform-browser';
+ * import { PDFExportModule } from '@progress/kendo-angular-pdf-export';
+ * import { AppComponent } from './app.component';
+ *
+ * @NgModule({
+ *   declarations: [AppComponent],
+ *   imports: [BrowserModule, PDFExportModule],
+ *   bootstrap: [AppComponent]
+ * })
+ * export class AppModule {}
+ * ```
  */
 export declare class PDFExportModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<PDFExportModule, never>;