@progress/kendo-angular-dialog 19.1.2-develop.1 → 19.1.2-develop.3

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

@@ -21,13 +21,14 @@ import { offset, scrollPosition, positionWithScroll, getDocumentElement, getWind
 import { IconWrapperComponent, IconsService } from '@progress/kendo-angular-icons';
 
 /**
- * Specifies the action buttons of the Dialog
- * ([see example]({% slug actionbuttons_dialog %})).
+ * Represents the action buttons of the Dialog.
+ * ([See example.]({% slug actionbuttons_dialog %}))
+ *
  */
 class DialogActionsComponent {
     el;
     /**
-     * Allows the declarative specification of the actions.
+     * Allows the declarative specification of the Dialog `actions`.
      */
     set actions(value) {
         if (value instanceof TemplateRef) {
@@ -49,7 +50,7 @@ class DialogActionsComponent {
      */
     actionsTemplate;
     /**
-     * Specifies the possible layout of the action buttons.
+     * Sets the possible layout of the action buttons.
      * @default 'stretched'
      */
     layout = 'stretched';
@@ -180,6 +181,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
                 args: ['class.k-actions-stretched']
             }] } });
 
+/**
+ * Represents a preventable event in Dialog and Window components.
+ *
+ */
 class PreventableEvent {
     prevented = false;
     /**
@@ -250,19 +255,19 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
  */
 class Messages extends ComponentMessages {
     /**
-     * The title of the close button.
+     * Sets the title for the **Close** button.
      */
     closeTitle;
     /**
-     * The title of the restore button.
+     * Sets the title for the **Restore** button.
      */
     restoreTitle;
     /**
-     * The title of the maximize button.
+     * Sets the title for the **Maximize** button.
      */
     maximizeTitle;
     /**
-     * The title of the minimize button.
+     * Sets the title for the **Minimize** button.
      */
     minimizeTitle;
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "16.2.12", ngImport: i0, type: Messages, deps: null, target: i0.ɵɵFactoryTarget.Directive });
@@ -322,14 +327,15 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
 /**
  * Represents the [Kendo UI DialogTitleBar component for Angular]({% slug api_dialog_dialogtitlebarcomponent %}).
  *
- * It is used as part of the Dialog content when the component is created dynamically by using an [Angular service]({% slug service_dialog %}).
+ * Use this component as part of the Dialog content when you create the Dialog dynamically with an [Angular service]({% slug service_dialog %}).
+ *
  */
 class DialogTitleBarComponent {
     zone;
     hostElement;
     localizationService;
     /**
-     * Fires when the close button of the title-bar is clicked.
+     * Fires when the close button in the title bar is clicked.
      */
     close = new EventEmitter();
     /**
@@ -475,8 +481,8 @@ const packageMetadata = {
     productName: 'Kendo UI for Angular',
     productCode: 'KENDOUIANGULAR',
     productCodes: ['KENDOUIANGULAR'],
-    publishDate: 1749804135,
-    version: '19.1.2-develop.1',
+    publishDate: 1750152445,
+    version: '19.1.2-develop.3',
     licensingDocsUrl: 'https://www.telerik.com/kendo-angular-ui/my-license/'
 };
 
@@ -659,9 +665,10 @@ const findPrimaryButton = (buttons) => {
 };
 
 /**
- * Indicates that the **Close** button is clicked. Used when the results from
- * the Dialogs that are opened through `DialogService` are filtered
- * ([see example]({% slug api_dialog_dialogservice %}#toc-open)).
+ * Represents the result when the **Close** button is clicked in a Dialog opened through `DialogService`.
+ *
+ * Used when the results from the Dialogs that are opened through `DialogService` are filtered. ([See example.]({% slug api_dialog_dialogservice %}#toc-open))
+ *
  */
 class DialogCloseResult {
 }
@@ -767,6 +774,23 @@ const animateContent = (animation, defAnimationConfig, animatedElement, builder)
 const DEFAULT_ANIMATION_CONFIG = { duration: 300, type: 'translate' };
 /**
  * Represents the [Kendo UI Dialog component for Angular]({% slug overview_dialog_dialogs %}).
+ *
+ * Use this component to display modal dialog windows in your application.
+ *
+ * @example
+ * ```ts
+ * import { Component } from '@angular/core';
+ *
+ * @Component({
+ *   selector: 'my-app',
+ *   template: `
+ *     <kendo-dialog title="Example Dialog">
+ *       <p>Dialog content goes here.</p>
+ *     </kendo-dialog>
+ *   `
+ * })
+ * export class AppComponent {}
+ * ```
  */
 class DialogComponent {
     wrapper;
@@ -775,75 +799,78 @@ class DialogComponent {
     ngZone;
     builder;
     /**
-     * Specifies the action buttons that will be rendered.
+     * Specifies the action buttons to render in the Dialog.
+     *
+     * @type {DialogAction[]}
      */
     actions;
     /**
-     * Specifies the layout of the action buttons in the Dialog.
-     * This option is only applicable if the action buttons are specified through the `actions` options.
+     * Sets the layout of the action buttons in the Dialog. Applies only if you specify action buttons through the `actions` option.
      *
+     * @type {ActionsLayout}
      * @default 'stretched'
      */
     actionsLayout = 'stretched';
     /**
-     * Specifies the query selector used to set the initial focus ([see examples]({% slug initial_focus_dialog %})).
+     * Sets the query selector for the element to receive initial focus. ([See examples.]({% slug initial_focus_dialog %}))
+     *
+     * @type {string}
      */
     autoFocusedElement;
     /**
-     * Specifies the text that is rendered in the title bar.
+     * Sets the text in the Dialog title bar.
+     *
+     * @type {string}
      */
     title;
     /**
-     * Specifies the width of the Dialog.
-     * A numeric value sets the width in pixels.
-     * A string value sets the width in arbitrary units&mdash;for example, `50%`.
+     * Sets the width of the Dialog. Use a number for pixels or a string for units (for example, `50%`).
+     *
+     * @type {number | string}
      */
     width;
     /**
-     * Specifies the minimum width of the Dialog.
-     * A numeric value sets the minimum width in pixels.
-     * A string value sets the minimum width in arbitrary units&mdash;for example, `50%`.
+     * Sets the minimum width of the Dialog. Use a number for pixels or a string for units (for example, `50%`).
+     *
+     * @type {number | string}
      */
     minWidth;
     /**
-     * Specifies the maximum width of the Dialog.
-     * A numeric value sets the maximum width in pixels.
-     * A string value sets the maximum width in arbitrary units&mdash;for example, `50%`.
+     * Sets the maximum width of the Dialog. Use a number for pixels or a string for units (for example, `50%`).
+     *
+     * @type {number | string}
      */
     maxWidth;
     /**
-     * Specifies the height of the Dialog.
-     * A numeric value sets the height in pixels.
-     * A string value sets the height in arbitrary units&mdash;for example, `50%`.
+     * Sets the height of the Dialog. Use a number for pixels or a string for units (for example, `50%`).
+     *
+     * @type {number | string}
      */
     height;
     /**
-     * Specifies the minimum height of the Dialog.
-     * A numeric value sets the minimum height in pixels.
-     * A string value sets the minimum height in arbitrary units&mdash;for example, `50%`.
+     * Sets the minimum height of the Dialog. Use a number for pixels or a string for units (for example, `50%`).
+     *
+     * @type {number | string}
      */
     minHeight;
     /**
-     * Specifies the maximum height of the Dialog.
-     * A numeric value sets the maximum height in pixels.
-     * A string value sets the maximum height in arbitrary units&mdash;for example, `50%`.
+     * Sets the maximum height of the Dialog. Use a number for pixels or a string for units (for example, `50%`).
+     *
+     * @type {number | string}
      */
     maxHeight;
     /**
      * Configures the Dialog opening animation ([see example]({% slug animations_dialog %})).
-     * By default the animation type is set to `translate` and its duration is `300ms`.
+     * The default animation type is `translate` and the duration is `300ms`.
      *
+     * @type {boolean | DialogAnimation}
      * @default true
      */
     animation = true;
     /**
-     * The Dialog allows you to specify predefined theme colors.
-     * The theme color will be applied as a background and border color to the titlebar while also amending the text color accordingly.
+     * Sets a predefined theme color for the Dialog. The color applies to the title bar background and border, and updates the text color.
      *
-     * The possible values are:
-     * * `primary`
-     * * `dark`
-     * * `light`
+     * @type {DialogThemeColor}
      */
     set themeColor(themeColor) {
         this.handleThemeColorClass(this.themeColor, themeColor);
@@ -902,12 +929,15 @@ class DialogComponent {
      */
     showLicenseWatermark = false;
     /**
-     * Fires when the user clicks an action button of the Dialog.
-     * The event is fired only when the action buttons are specified through the `actions` options.
+     * Emits when the user clicks an action button in the Dialog. Fires only if you specify action buttons through the `actions` option.
+     *
+     * @type {EventEmitter<DialogAction>}
      */
     action = new EventEmitter();
     /**
-     * Fires when the user clicks the **Close** button of the Dialog or the **ESC** key.
+     * Emits when the user clicks the **Close** button or presses the `ESC` key.
+     *
+     * @type {EventEmitter<any>}
      */
     close = new EventEmitter();
     get dir() {
@@ -1332,16 +1362,14 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
             }] } });
 
 /**
- * Holds references to the object instance and published events of the Dialog.
- * Controls the Dialogs that were opened through the `DialogService`
- * ([see example]({% slug api_dialog_dialogservice %}#toc-open)).
+ * Holds references to the Dialog instance and published events when you open a Dialog through the `DialogService`.
+ *
+ * Use the `DialogRef` class to control and interact with Dialogs opened programmatically. ([See example.]({% slug api_dialog_dialogservice %}#toc-open))
+ *
  */
 class DialogRef {
     /**
-     * Emits events when the Dialog is closed either through the **Close** button of the title bar or through the action buttons.
-     * If the **Close** button of the title bar is clicked, `DialogResult` is a `DialogCloseResult` instance.
-     * If the Dialog is closed through the action buttons, `DialogResult` contains the object that was passed when the Dialog was opened.
-     * When `close` is called with an argument, the result is the passed argument.
+     * Emits events when the Dialog is closed either through the **Close** button of the title bar or through the action buttons. If the **Close** button of the title bar is clicked, `DialogResult` is a `DialogCloseResult` instance. If the Dialog is closed through the action buttons, `DialogResult` contains the object that was passed when the Dialog was opened. When `close` is called with an argument, the result is the passed argument.
      */
     result;
     /**
@@ -1349,19 +1377,13 @@ class DialogRef {
      */
     dialog;
     /**
-     * A reference to the child component of the Dialog.
-     * Available when the Dialog is opened with [component content](slug:service_dialog#toc-rendering-the-content-area).
+     * A reference to the child component of the Dialog. Available when the Dialog is opened with [component content](slug:service_dialog#toc-rendering-the-content-area).
      */
     content;
     /**
-     * Closes the Dialog programmatically.
-     *
-     * When called without a value, the result Observable emits an empty `DialogCloseResult` object.
-     *
-     * When called with a value, the result Observable emits the provided value.
+     * Closes the Dialog programmatically. When called without a value, the resulting Observable emits an empty `DialogCloseResult` object. When called with a value, the resulting Observable emits the provided value.
      *
-     * Usage Examples:
-     * ```typescript
+     * ```ts
      * // Close without arguments: Returns an empty `DialogCloseResult` object.
      * dialogRef.close();
      *
@@ -1376,8 +1398,9 @@ class DialogRef {
 }
 
 /**
- * The base class  which will be extended by a component that is provided as content through `content`
- * ([see example](slug:service_dialog#toc-single-component-rendering)).
+ * Serves as the base class for a component provided as Dialog content through the `content` property.
+ * ([See example.](slug:service_dialog#toc-single-component-rendering)).
+ *
  */
 class DialogContentBase {
     dialog;
@@ -1443,33 +1466,34 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
         }] });
 
 /**
- * The settings for the Dialog actions when the Dialog is opened through `DialogService`
- * ([see example]({% slug api_dialog_dialogservice %}#toc-open)).
+ * Represents the settings for Dialog actions when you open a Dialog through `DialogService`.
+ *
+ * Use the `DialogAction` class to configure action buttons in the Dialog. ([See example.]({% slug api_dialog_dialogservice %}#toc-open))
+ *
  */
 class DialogAction {
     /**
-     * The text of the action button.
+     * Sets the text of the action button.
      */
     text;
     /**
-     * Determines the theme color of the action button. The theme color will be applied as a background and border color while also amending the text color accordingly.
+     * Sets the theme color of the action button. The theme color applies to the background, border, and text.
      */
     themeColor;
     /**
-     * Specifies the background and border styles of the action button.
+     * Sets the background and border styles of the action button.
      */
     fillMode;
     /**
-     * Sets the CSS classes that will be rendered on the action button.
-     * Supports the union type of values that [ngClass](link:site.data.urls.angular['ngclassapi']) accepts.
+     * Sets the CSS classes for the action button. Accepts any value supported by [`ngClass`](link:site.data.urls.angular['ngclassapi']).
      */
     cssClass;
     /**
-     * Specifies the [SVG icon](slug:svgicon_list) to be rendered within the action button.
+     * Sets the [SVG icon](slug:svgicon_list) to display in the action button.
      */
     svgIcon;
     /**
-     * Specifies the name of the [font icon](slug:icon_list) to be rendered within the action button.
+     * Sets the name of the [font icon](slug:icon_list) to display in the action button.
      */
     icon;
     /**
@@ -1479,104 +1503,93 @@ class DialogAction {
 }
 
 /**
- * The settings that can be used when the Dialog is opened through `DialogService`.
- * ([see example]({% slug api_dialog_dialogservice %}#toc-open)).
+ * Represents the settings for opening a Dialog through the `DialogService`.
+ * ([See example.]({% slug api_dialog_dialogservice %}#toc-open))
+ *
  */
 class DialogSettings {
     /**
-     * Defines a predicate that verifies if the pressed dialog action should be prevented. Returning true from the predicate prevents the dialog from closing.
-     * If the **Close** button of the title bar is clicked, `DialogResult` is a `DialogCloseResult` instance.
-     * If the Dialog is closed through the action buttons, `DialogResult` contains the object that was passed when the Dialog was opened. ([see example](slug:service_dialog#toc-dialog-close-prevention))
-     * @param {DialogResult} ev
-     * @param {DialogRef} [dialogRef] - provided only when the dialog is created using a component.
-     * @returns
+     * Use the `preventAction` callback to check if the pressed Dialog action should be prevented. If `true`, the Dialog does not close.
+     * If the **Close** button in the title bar is clicked, `DialogResult` is a `DialogCloseResult` instance.
+     * If the action buttons are used to close the Dialog, `DialogResult` contains the object passed when opening the Dialog. ([See example.](slug:service_dialog#toc-dialog-close-prevention))
+     * @param {DialogResult} ev The Dialog result.
+     * @param {DialogRef} [dialogRef] The Dialog reference, provided only when you create the Dialog using a component.
+     * @returns Returns `true` to prevent closing the Dialog.
      */
     preventAction;
     /**
-     * Sets the title of the Dialog. If `title` is omitted,
-     * the Dialog will not render a **Close** button.
+     * Sets the Dialog `title`. If you omit `title`, the Dialog does not render a **Close** button.
      */
     title;
     /**
-     * Sets the CSS classes that will be rendered on the Dialog wrapper element.
-     * Supports the union type of values that NgClass accepts [ngClass](link:site.data.urls.angular['ngclassapi']).
+     * Sets the CSS classes for the Dialog wrapper element. Accepts any value supported by [`ngClass`](link:site.data.urls.angular['ngclassapi']).
      */
     cssClass;
     /**
-     * Configures the Dialog opening animation ([see example]({% slug animations_dialog %})).
-     * By default the animation type is set to `translate` and its duration is `300ms`.
+     * Configures the Dialog opening `animation` ([see example]({% slug animations_dialog %})).
+     * @default { type: 'translate', duration: 300 }
      */
     animation;
     /**
-     * Sets the HTML attributes of the Dialog wrapper element.
-     * The property accepts string key-value based pairs.
+     * Sets the HTML attributes for the Dialog wrapper element. Accepts string key-value pairs.
      */
     htmlAttributes;
     /**
-     * Defines the content of the Dialog.
-     * ([see example](slug:service_dialog#toc-rendering-the-content-area)).
+     * Defines the Dialog `content`. ([See example.](slug:service_dialog#toc-rendering-the-content-area))
      */
     content;
     /**
-     * Specifies the width of the Dialog.
-     * A numeric value sets the width in pixels.
-     * A string value sets the width in arbitrary units&mdash;for example, `50%`.
+     * Sets the width of the Dialog.
+     * Use a number for pixels or a string for other units, for example, `50%`.
      */
     width;
     /**
-     * Specifies the minimum width of the Dialog.
-     * A numeric value sets the minimum width in pixels.
-     * A string value sets the minimum width in arbitrary units&mdash;for example, `50%`.
+     * Sets the minimum width of the Dialog.
+     * Use a number for pixels or a string for other units, for example, `50%`.
      */
     minWidth;
     /**
-     * Specifies the maximum width of the Dialog.
-     * A numeric value sets the maximum width in pixels.
-     * A string value sets the maximum width in arbitrary units&mdash;for example, `50%`.
+     * Sets the maximum width of the Dialog.
+     * Use a number for pixels or a string for other units, for example, `50%`.
      */
     maxWidth;
     /**
-     * Specifies the height of the Dialog.
-     * A numeric value sets the height in pixels.
-     * A string value sets the height in arbitrary units&mdash;for example, `50%`.
+     * Sets the height of the Dialog.
+     * Use a number for pixels or a string for other units, for example, `50%`.
      */
     height;
     /**
-     * Specifies the minimum height of the Dialog.
-     * A numeric value sets the minimum height in pixels.
-     * A string value sets the minimum height in arbitrary units&mdash;for example, `50%`.
+     * Sets the minimum height of the Dialog.
+     * Use a number for pixels or a string for other units, for example, `50%`.
      */
     minHeight;
     /**
-     * Specifies the maximum height of the Dialog.
-     * A numeric value sets the maximum height in pixels.
-     * A string value sets the maximum height in arbitrary units&mdash;for example, `50%`.
+     * Sets the maximum height of the Dialog.
+     * Use a number for pixels or a string for other units, for example, `50%`.
      */
     maxHeight;
     /**
-     * Defines the container in which the Dialog will be inserted.
-     * Specifying this option changes the place in the page hierarchy where the Dialog will be inserted.
-     * The styling of the component will remain the same.
+     * Defines the container where the Dialog is inserted. This changes the place in the page hierarchy where the Dialog appears. The component styling stays the same.
      */
     appendTo;
     /**
-     * Specifies the title of the close button.
+     * Sets the `closeTitle` for the **Close** button.
      */
     closeTitle;
     /**
-     * Sets the action buttons of the Dialog.
+     * Sets the Dialog `actions` buttons.
      */
     actions;
     /**
-     * Specifies the layout of the action buttons in the Dialog.
+     * Sets the layout of the Dialog action buttons with `actionsLayout`.
      */
     actionsLayout;
     /**
-     * Sets the focused element query selector.
+     * Sets the query selector for the element to focus automatically with `autoFocusedElement`.
      */
     autoFocusedElement;
     /**
-     * Specifies the theme color of the Dialog.
+     * Sets the theme color of the Dialog.
      */
     themeColor;
 }
@@ -1598,8 +1611,7 @@ class DialogInjector {
     }
 }
 /**
- * A service for opening Dialog windows dynamically
- * ([see example]({% slug service_dialog %})).
+ * Provides a service for opening Dialog windows dynamically ([see example]({% slug service_dialog %})).
  */
 class DialogService {
     resolver;
@@ -1615,45 +1627,25 @@ class DialogService {
     /**
      * Opens a Dialog window. Requires an element in the application that uses the
      * [`kendoDialogContainer`]({% slug api_dialog_dialogcontainerdirective %}) directive.
-     * Created Dialogs will be mounted in the DOM directly after that element.
+     * The created Dialog mounts in the DOM directly after that element.
      *
      * @param {DialogAction} options - The options that define the Dialog.
-     * @returns {DialogRef} - A reference to the Dialog object and the convenience properties.
+     * @returns {DialogRef} - A reference to the Dialog object and its convenience properties.
      *
      * @example
-     *
-     * ```ts-no-run
-     * _@Component({
-     *   selector: 'my-app',
-     *   template: `
-     *     <button kendoButton (click)="open()">Harmless button</button>
-     *     <div kendoDialogContainer></div>
-     *   `
-     * })
-     * export class AppComponent {
-     *     constructor( private dialogService: DialogService ) {}
-     *
-     *     public open() {
-     *         var dialog = this.dialogService.open({
-     *           title: "Please confirm",
-     *           content: "Are you sure?",
-     *           actions: [
-     *             { text: "No" },
-     *             { text: "Yes", themeColor: 'primary' }
-     *           ]
-     *         });
-     *
-     *         dialog.result.subscribe((result) => {
-     *           if (result instanceof DialogCloseResult) {
-     *             console.log("close");
-     *           } else {
-     *             console.log("action", result);
-     *           }
-     *         });
-     *     }
-     * }
+     * ```typescript
+     * const dialog = this.dialogService.open({
+     *   title: 'Confirm',
+     *   content: 'Are you sure?',
+     *   actions: [
+     *     { text: 'No' },
+     *     { text: 'Yes', themeColor: 'primary' }
+     *   ]
+     * });
+     * dialog.result.subscribe(result => {
+     *   // handle result
+     * });
      * ```
-     *
      */
     open(options) {
         const factory = this.resolver.resolveComponentFactory(DialogComponent);
@@ -2189,6 +2181,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
                 args: ['class.k-resize-handle']
             }] } });
 
+/**
+ * Represents the title bar of the Window component.
+ *
+ */
 class WindowTitleBarComponent {
     el;
     ngZone;
@@ -2866,6 +2862,12 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
 
 /**
  * Represents the [Kendo UI Window component for Angular]({% slug overview_window_dialogs %}).
+ *
+ * @example
+ * ```html
+ * <kendo-window title="My Window" [width]="400" [height]="300">
+ * </kendo-window>
+ * ```
  */
 class WindowComponent {
     el;
@@ -2879,11 +2881,11 @@ class WindowComponent {
      */
     autoFocusedElement;
     /**
-     * Specifies the text that is rendered in the title bar.
+     * Sets the text in the title bar.
      */
     title;
     /**
-     * Specifies whether the user will be able to drag the component.
+     * Specifies if the user can drag the component.
      * @default true
      */
     set draggable(value) {
@@ -2893,7 +2895,7 @@ class WindowComponent {
         return this.options.draggable;
     }
     /**
-     * Specifies whether the user will be able to resize the component.
+     * Specifies if the user can resize the component.
      * @default true
      */
     set resizable(value) {
@@ -2903,13 +2905,7 @@ class WindowComponent {
         return this.options.resizable;
     }
     /**
-     * The Window allows you to specify predefined theme colors.
-     * The theme color will be applied as a background and border color to the titlebar while also amending the text color accordingly.
-     *
-     * The possible values are:
-     * * `primary`
-     * * `dark`
-     * * `light`
+     * Sets the predefined theme color for the Window. The color applies to the title bar background and border, and updates the text color.
      */
     set themeColor(themeColor) {
         this.handleThemeColorClass(this.themeColor, themeColor);
@@ -2948,18 +2944,12 @@ class WindowComponent {
         return this._htmlAttributes;
     }
     /**
-     * Specifies if the content of the component is persisted in the DOM when minimized.
+     * Specifies if the content stays in the DOM when minimized.
      * @default false
      */
     keepContent = false;
     /**
-     * Specifies the initial state of the component.
-     * If not specified, the value is set to `default`.
-     *
-     * The possible values are:
-     * * `minimized`
-     * * `maximized`
-     * * `default`
+     * Sets the initial state of the Window.
      */
     set state(value) {
         this.options.state = value;
@@ -2968,8 +2958,7 @@ class WindowComponent {
         return this.options.state;
     }
     /**
-     * Specifies the minimum width of the component.
-     * The `minWidth` property has to be set in pixels.
+     * Sets the minimum width in pixels.
      * @default 120
      */
     set minWidth(value) {
@@ -2979,8 +2968,7 @@ class WindowComponent {
         return this.options.minWidth;
     }
     /**
-     * Specifies the minimum height of the Window.
-     * The `minHeight` property has to be set in pixels.
+     * Sets the minimum height in pixels.
      * @default 100
      */
     set minHeight(value) {
@@ -2990,8 +2978,7 @@ class WindowComponent {
         return this.options.minHeight;
     }
     /**
-     * Specifies the width of the Window.
-     * The `width` property has to be set in pixels.
+     * Sets the width in pixels.
      */
     set width(value) {
         this.setOption('width', value);
@@ -3000,8 +2987,7 @@ class WindowComponent {
         return this.options.width;
     }
     /**
-     * Specifies the height of the Window.
-     * The `height` property has to be set in pixels.
+     * Sets the height in pixels.
      */
     set height(value) {
         this.setOption('height', value);
@@ -3010,8 +2996,7 @@ class WindowComponent {
         return this.options.height;
     }
     /**
-     * Specifies the initial top offset of the Window.
-     * The `top` property has to be set in pixels.
+     * Sets the initial top offset in pixels.
      */
     set top(value) {
         this.setOption('top', value);
@@ -3020,8 +3005,7 @@ class WindowComponent {
         return this.options.top;
     }
     /**
-     * Specifies the initial left offset of the Window.
-     * Numeric values are treated as pixels.
+     * Sets the initial left offset in pixels.
      */
     set left(value) {
         this.setOption('left', value);
@@ -3058,7 +3042,7 @@ class WindowComponent {
      */
     dragStart = new EventEmitter();
     /**
-     * Fires when the Window was moved by the user.
+     * Fires after the Window has been moved by the user.
      */
     dragEnd = new EventEmitter();
     /**
@@ -3066,7 +3050,7 @@ class WindowComponent {
      */
     resizeStart = new EventEmitter();
     /**
-     * Fires when the Window was resized by the user.
+     * Fires after the Window has been resized by the user.
      */
     resizeEnd = new EventEmitter();
     /**
@@ -3074,28 +3058,23 @@ class WindowComponent {
      */
     close = new EventEmitter();
     /**
-     * Fires when the `width` property of the component was updated. The event is triggered only after the resizing
-     * has ended. The event data contains the new width. Allows a two-way binding of the `width` property.
+     * Fires when the `width` property is updated after resizing. The event data contains the new width. Allows two-way binding of the `width` property.
      */
     widthChange = new EventEmitter();
     /**
-     * Fires when the `height` property of the component was updated. The event is triggered only after the resizing
-     * has ended. The event data contains the new height. Allows a two-way binding of the `height` property.
+     * Fires when the `height` property is updated after resizing. The event data contains the new height. Allows two-way binding of the `height` property.
      */
     heightChange = new EventEmitter();
     /**
-     * Fires when the `top` property of the component was updated. The event is triggered only after the dragging
-     * and resizing have ended. The event data contains the new top offset. Allows a two-way binding of the `top` property.
+     * Fires when the `top` property is updated after dragging or resizing. The event data contains the new top offset. Allows two-way binding of the `top` property.
      */
     topChange = new EventEmitter();
     /**
-     * Fires when the `left` property of the component was updated. The event is triggered only after the dragging
-     * and resizing have ended. The event data contains the new left offset. Allows a two-way binding of the `left` property.
+     * Fires when the `left` property is updated after dragging or resizing. The event data contains the new left offset. Allows two-way binding of the `left` property.
      */
     leftChange = new EventEmitter();
     /**
-     * Fires when the `state` property of the component was updated. The event data contains the new state. Allows a
-     * two-way binding of the `state` property.
+     * Fires when the `state` property is updated. The event data contains the new state. Allows two-way binding of the `state` property.
      */
     stateChange = new EventEmitter();
     /**
@@ -3227,8 +3206,8 @@ class WindowComponent {
      * corresponding property of the component instance will be updated.
      * This method is intended to be used for sizing dynamically created components using the
      * [`WindowService`]({% slug api_dialog_windowservice %})
-     * @param {WindowDimensionSetting} dimension - The option that will be updated
-     * @param {number} value - The value set in pixels
+     * @param dimension The option to update.
+     * @param value The value in pixels.
      */
     setDimension(dimension, value) {
         this.setOption(dimension, value);
@@ -3240,8 +3219,8 @@ class WindowComponent {
      * corresponding property of the component instance will be updated.
      * This method is intended to be used for positioning dynamically created components using the
      * [`WindowService`]({% slug api_dialog_windowservice %})
-     * @param {WindowOffsetSetting} offset - The option that will be updated
-     * @param {number} value - The value set in pixels
+     * @param offset The option to update.
+     * @param value The value in pixels.
      */
     setOffset(offset, value) {
         this.setOption(offset, value);
@@ -3650,65 +3629,51 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
             }] } });
 
 /**
- * Indicates that the **Close** button of a Window that is opened through `WindowService` is clicked.
+ * Indicates that the **Close** button of a Window opened through `WindowService` is clicked.
+ *
  */
 class WindowCloseResult {
 }
 
 /**
- * Holds references to the object instance of the Window.
- * Controls the Windows that were opened through `WindowService`
- * ([see example]({% slug api_dialog_windowservice %}#toc-open)).
+ * Holds references to the Window instance. Controls Windows opened through `WindowService`. ([See example.]({% slug api_dialog_windowservice %}#toc-open))
  */
 class WindowRef {
     /**
-     * A reference to the Window instance.
+     * Represents a reference to the Window instance.
      */
     window;
     /**
-     * A reference to the child component of the Window.
-     * Available when the Window is opened with
-     * [component content](slug:service_window#toc-rendering-the-content-area).
+     * Represents a reference to the child component of the Window. Available when you open the Window with [component content](slug:service_window#toc-rendering-the-content-area).
      */
     content;
     /**
-     * Allows you to close the Window by using code.
-     * When called with no arguments,
-     * the `result` Observable will be of type WindowCloseResult.
-     * When called with an argument, the `result` Observable will hold the provided value.
+     * Allows you to close the Window by using code. When called with no arguments, the `result` Observable is of type `WindowCloseResult`. When called with an argument, the `result` Observable holds the provided value.
      */
     close;
     /**
-     * Emits events when the Window is closed through the **Esc** key, the **Close** button of the title bar or
-     * by calling the `close` method.
-     * When the Window is closed with the title bar button, **Esc** or by calling `close` with no arguments,
-     * the result is of type [WindowCloseResult]({% slug api_dialog_windowcloseresult %}).
-     * When `close` is called with an argument, the result is the passed argument.
+     * Emits events when the Window is closed through the `Esc` key, the **Close** button of the title bar, or by calling the `close` method. When the Window is closed with the title bar button, `Esc`, or by calling `close` with no arguments, the result is of type [`WindowCloseResult`]({% slug api_dialog_windowcloseresult %}). When `close` is called with an argument, the result is the passed argument.
      */
     result;
 }
 
 /**
- * The settings for the Window actions when the Window is opened through `WindowService`
- * ([see example]({% slug api_dialog_windowservice %}#toc-open)).
+ * Represents the settings for the Window actions when you open a Window through `WindowService`. ([See example.]({% slug api_dialog_windowservice %}#toc-open))
  */
 class WindowSettings {
     /**
-     * Defines a predicate that verifies if the closing of the Window should be prevented.
-     * It applies to clicking the **Close** button of the title bar, pressing the **Esc** key or calling the `close` method.
-     * Returning true from the predicate prevents the Window from closing.
-     * If the **Close** button of the title bar is clicked or **Esc** is pressed, a [WindowCloseResult]({% slug api_dialog_windowcloseresult %}) instance is passed.
-     * @param {any} ev
-     * @param {WindowRef} [windowRef] - provided only when the window is created using a component.
-     * @returns
+     * Use the `preventClose` predicate to check if closing the Window should be prevented. Applies to clicking the **Close** button, pressing **Esc**, or calling the `close` method. Return `true` to prevent closing. If the **Close** button or **Esc** is used, a [`WindowCloseResult`]({% slug api_dialog_windowcloseresult %}) instance is passed.
+     * @param {any} ev The event argument.
+     * @param {WindowRef} [windowRef] - The window reference, provided only when you create the window using a component.
+     * @returns Returns `true` to prevent closing the window.
      */
     preventClose;
     /**
-     * Sets the title of the Window.
+     * Sets the Window `title`.
      */
     title;
     /**
-     * Defines the content of the Window.
+     * Defines the Window `content`.
      */
     content;
     /**
@@ -3716,37 +3681,35 @@ class WindowSettings {
      */
     titleBarContent;
     /**
-     * Defines the text of the labels that are shown within the Window.
-     * Used primarily for localization.
+     * Sets the text of the labels shown in the Window. Use for localization.
      */
     messages;
     /**
-     * Specifies if the content of the Window is persisted in the DOM
-     * when the Window is minimized.
+     * Set to `true` to persist the Window content in the DOM when minimized.
      */
     keepContent;
     /**
-     * Specifies the width of the Window.
+     * Sets the width of the Window in pixels.
      */
     width;
     /**
-     * Specifies the minimum width of the Window.
+     * Sets the minimum width of the Window in pixels.
      */
     minWidth;
     /**
-     * Specifies the height of the Window.
+     * Sets the height of the Window in pixels.
      */
     height;
     /**
-     * Specifies the minimum height of the Window.
+     * Sets the minimum height of the Window in pixels.
      */
     minHeight;
     /**
-     * Specifies the left offset of the Window.
+     * Sets the left offset of the Window in pixels.
      */
     left;
     /**
-     * Specifies the top offset of the Window.
+     * Sets the top offset of the Window in pixels.
      */
     top;
     /**
@@ -3754,13 +3717,11 @@ class WindowSettings {
      */
     draggable;
     /**
-     * Sets the custom CSS classes that will be rendered on the Window wrapper element.
-     * Supports the union type of values that NgClass accepts [ngClass](link:site.data.urls.angular['ngclassapi']).
+     * Sets custom CSS classes for the Window wrapper element. Accepts any value supported by [`ngClass`](link:site.data.urls.angular['ngclassapi']).
      */
     cssClass;
     /**
-     * Sets the HTML attributes of the Window wrapper element.
-     * The property accepts string key-value based pairs.
+     * Sets HTML attributes for the Window wrapper element. Accepts string key-value pairs.
      */
     htmlAttributes;
     /**
@@ -3768,16 +3729,15 @@ class WindowSettings {
      */
     resizable;
     /**
-     * Specifies the initial state of the Window.
+     * Sets the initial state of the Window.
      */
     state;
     /**
-     * Defines the container in which the Window will be inserted.
-     * Specifying this option changes the place in the page hierarchy where the Window will be inserted.
+     * Defines the container where the Window is inserted. This changes the place in the page hierarchy where the Window appears.
      */
     appendTo;
     /**
-     * Sets the focused element query selector.
+     * Sets the query selector for the element to focus automatically.
      */
     autoFocusedElement;
     /**
@@ -3823,8 +3783,9 @@ class WindowInjector {
     }
 }
 /**
- * A service for opening Windows dynamically
- * ([see example]({% slug service_window %})).
+ * Provides methods for opening Windows dynamically.
+ *
+ * Use this service to open a Window component and manage its lifecycle. ([See example.]({% slug service_window %}))
  */
 class WindowService {
     resolver;
@@ -3838,39 +3799,18 @@ class WindowService {
         this.containerService = containerService;
     }
     /**
-     * Opens a Window component.
+     * Opens a Window component with the specified settings.
      *
-     * @param {WindowSettings} settings - The settings that define the Window.
-     * @returns {WindowRef} - A reference to the Window object.
+     * @param settings The settings that configure the Window.
+     * @returns A `WindowRef` instance for controlling the Window.
      *
      * @example
-     *
-     * ```ts-no-run
-     * _@Component({
-     *   selector: 'my-app',
-     *   template: `
-     *     <button kendoButton (click)="open()">Open window</button>
-     *     <div kendoWindowContainer></div>
-     *   `
-     * })
-     * export class AppComponent {
-     *     constructor( private windowService: WindowService ) {}
-     *
-     *     public open() {
-     *         var window = this.windowService.open({
-     *           title: "My window",
-     *           content: "My content!"
-     *         });
-     *
-     *         window.result.subscribe((result) => {
-     *           if (result instanceof WindowCloseResult) {
-     *             console.log("Window was closed");
-     *           }
-     *         });
-     *     }
-     * }
+     * ```ts
+     * const window = windowService.open({
+     *   title: 'My window',
+     *   content: 'My content!'
+     * });
      * ```
-     *
      */
     open(settings) {
         const factory = this.resolver.resolveComponentFactory(WindowComponent);
@@ -4021,12 +3961,11 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
                 }] }]; } });
 
 /**
- * Provides an insertion point for the Dialogs which are created through the
- * Dialog service ([see example]({% slug api_dialog_dialogservice %}#toc-open)).
- * Created Dialogs will be mounted after that element.
+ * Represents an insertion point for Dialogs created through the Dialog service.
+ * The created Dialogs mount after this element. ([See example.]({% slug api_dialog_dialogservice %}#toc-open))
  *
  * @example
- * ```html-no-run
+ * ```html
  * <div kendoDialogContainer></div>
  * ```
  */
@@ -4046,8 +3985,29 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
         }], ctorParameters: function () { return [{ type: i0.ViewContainerRef }, { type: DialogContainerService }]; } });
 
 /**
- * Custom component messages override default component messages
- * ([see example](slug:globalization_dialogs#toc-internationalization)).
+ * Represents a component for customizing the messages in Dialog and Window components.
+ *
+ * Use the `CustomMessagesComponent` to override default messages with custom text. ([See example.](slug:globalization_dialogs#toc-internationalization)).
+ *
+ * @example
+ * ```typescript
+ * import { CustomMessagesComponent } from './custom-messages.component';
+ *
+ * @Component({
+ *   selector: 'my-dialog',
+ *   template: `
+ *     <kendo-dialog>
+ *       <kendo-dialog-messages
+ *         [closeTitle]="'Close dialog'"
+ *         [restoreTitle]="'Restore dialog'"
+ *         [maximizeTitle]="'Maximize dialog'"
+ *         [minimizeTitle]="'Minimize dialog'">
+ *       </kendo-dialog-messages>
+ *     </kendo-dialog>
+ *   `
+ * })
+ * export class MyDialogComponent {}
+ * ```
  */
 class CustomMessagesComponent extends Messages {
     service;
@@ -4082,12 +4042,11 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
         }], ctorParameters: function () { return [{ type: i1$1.LocalizationService }]; } });
 
 /**
- * Provides an insertion point for the Windows which are created through the
- * Window service ([see example]({% slug api_dialog_windowservice %}#toc-open)).
- * Created Windows will be mounted after that element.
+ * Represents an insertion point for Windows created through the Window service.
+ * The created Windows mount after this element. ([See example.]({% slug api_dialog_windowservice %}#toc-open))
  *
  * @example
- * ```html-no-run
+ * ```html
  * <div kendoWindowContainer></div>
  * ```
  */
@@ -4107,8 +4066,24 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
         }], ctorParameters: function () { return [{ type: i0.ViewContainerRef }, { type: WindowContainerService }]; } });
 
 /**
-* Utility array that contains all `Dialog` related components and directives.
-*/
+ * Represents the utility array that that contains all `Dialog`-related components and directives.
+ *
+ * Use `KENDO_DIALOG` to import all Dialog components and directives at once.
+ *
+ * @example
+ * ```typescript
+ * import { Component } from '@angular/core';
+ * import { KENDO_DIALOG } from '@progress/kendo-angular-dialog';
+ *
+ * @Component({
+ *   selector: 'my-dialog-app',
+ *   standalone: true,
+ *   imports: [KENDO_DIALOG],
+ *   template: `...`
+ * })
+ * export class DialogAppComponent {}
+ * ```
+ */
 const KENDO_DIALOG = [
     DialogComponent,
     DialogTitleBarComponent,
@@ -4117,8 +4092,24 @@ const KENDO_DIALOG = [
     CustomMessagesComponent
 ];
 /**
-* Utility array that contains all `Window` related components and directives.
-*/
+ * Represents the utility array that contains all `Window`-related components and directives.
+ *
+ * Use `KENDO_WINDOW` to import all Window components and directives at once.
+ *
+ * @example
+ * ```typescript
+ * import { Component } from '@angular/core';
+ * import { KENDO_WINDOW } from '@progress/kendo-angular-dialog';
+ *
+ * @Component({
+ *   selector: 'my-window-app',
+ *   standalone: true,
+ *   imports: [KENDO_WINDOW],
+ *   template: `...`
+ * })
+ * export class WindowAppComponent {}
+ * ```
+ */
 const KENDO_WINDOW = [
     WindowComponent,
     WindowCloseActionDirective,
@@ -4131,8 +4122,24 @@ const KENDO_WINDOW = [
     CustomMessagesComponent
 ];
 /**
-* Utility array that contains all `@progress/kendo-angular-dialog` related components and directives.
-*/
+ * Represents the utility array that contains all `@progress/kendo-angular-dialog`-related components and directives.
+ *
+ * Use `KENDO_DIALOGS` to import all Dialog and Window components and directives at once.
+ *
+ * @example
+ * ```typescript
+ * import { Component } from '@angular/core';
+ * import { KENDO_DIALOGS } from '@progress/kendo-angular-dialog';
+ *
+ * @Component({
+ *   selector: 'my-app',
+ *   standalone: true,
+ *   imports: [KENDO_DIALOGS],
+ *   template: `...`
+ * })
+ * export class AppComponent {}
+ * ```
+ */
 const KENDO_DIALOGS = [
     ...KENDO_DIALOG,
     ...KENDO_WINDOW
@@ -4140,25 +4147,23 @@ const KENDO_DIALOGS = [
 
 //IMPORTANT: NgModule export kept for backwards compatibility
 /**
- * Represents the [NgModule](link:site.data.urls.angular['ngmoduleapi'])
- * definition for the Dialog component that includes all Dialog components and directives.
- * Imports `DialogModule` into the [root module](link:site.data.urls.angular['ngmodules']#angular-modularity)
- * of your application or into any other sub-module that will use the Dialog component.
+ * Represents the [NgModule](link:site.data.urls.angular['ngmoduleapi']) definition for the Dialog component.
+ *
+ * Use the `DialogModule` to include all Dialog components and directives in your application.
  *
  * @example
- * ```ts-no-run
+ * ```typescript
  * import { NgModule } from '@angular/core';
  * import { BrowserModule } from '@angular/platform-browser';
  * import { DialogModule } from '@progress/kendo-angular-dialog';
  * import { AppComponent } from './app.component';
  *
- * _@NgModule({
+ * @NgModule({
  *     bootstrap:    [AppComponent],
  *     declarations: [AppComponent],
  *     imports:      [BrowserModule, DialogModule]
  * })
- * export class AppModule {
- * }
+ * export class AppModule {}
  * ```
  */
 class DialogModule {
@@ -4177,25 +4182,23 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
 
 //IMPORTANT: NgModule export kept for backwards compatibility
 /**
- * Represents the [NgModule](link:site.data.urls.angular['ngmoduleapi'])
- * definition for the Window component. Imports `WindowModule` into the
- * [root module](link:site.data.urls.angular['ngmodules']#angular-modularity)
- * of your application or into any other sub-module that will use the Window component.
+ * Represents the [NgModule](link:site.data.urls.angular['ngmoduleapi']) definition for the Window component.
+ *
+ * Use the `WindowModule` to include all Window components and directives in your application.
  *
  * @example
- * ```ts-no-run
+ * ```typescript
  * import { NgModule } from '@angular/core';
  * import { BrowserModule } from '@angular/platform-browser';
  * import { WindowModule } from '@progress/kendo-angular-window';
  * import { AppComponent } from './app.component';
  *
- * _@NgModule({
+ * @NgModule({
  *     bootstrap:    [AppComponent],
  *     declarations: [AppComponent],
  *     imports:      [BrowserModule, WindowModule]
  * })
- * export class AppModule {
- * }
+ * export class AppModule {}
  * ```
  */
 class WindowModule {
@@ -4214,28 +4217,24 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
 
 //IMPORTANT: NgModule export kept for backwards compatibility
 /**
- * Represents the [NgModule](link:site.data.urls.angular['ngmoduleapi'])
- * definition for the Dialogs components.
+ * Represents the [NgModule](link:site.data.urls.angular['ngmoduleapi']) definition for the Dialogs components.
  *
- * @example
+ * Use the `DialogsModule` to include all Dialog and Window components and services in your application.
  *
- * ```ts
+ * @example
+ * ```typescript
  * import { DialogsModule } from '@progress/kendo-angular-dialog';
- *
  * import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';
  * import { NgModule } from '@angular/core';
- *
  * import { AppComponent } from './app.component';
  *
- * _@NgModule({
+ * @NgModule({
  *     declarations: [AppComponent],
  *     imports:      [BrowserModule, DialogsModule],
  *     bootstrap:    [AppComponent]
  * })
  * export class AppModule {}
  *
- * platformBrowserDynamic().bootstrapModule(AppModule);
- *
  * ```
  */
 class DialogsModule {