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

package/context-menu/context-menu-event.d.ts

@@ -4,23 +4,23 @@
 *-------------------------------------------------------------------------------------------*/
 import { ContextMenuComponent } from './context-menu.component';
 /**
- * Arguments for the `open` and `close` events of the ContextMenu.
+ * Represents the arguments for the `open` and `close` events of the ContextMenu.
  */
 export declare class ContextMenuEvent {
     /**
-     * The target element for which the ContextMenu is opened.
+     * Specifies the target element for which the ContextMenu is opened.
      */
     target: any;
     /**
-     * The ContextMenuComponent that triggered the event.
+     * Specifies the ContextMenuComponent that triggered the event.
      */
     sender: ContextMenuComponent;
     /**
-     * The item data of the event.
+     * Specifies the item data of the event.
      */
     item: any;
     /**
-     * The item index of the event.
+     * Specifies the item index of the event.
      */
     index: string;
 }

package/context-menu/context-menu-popup-event.d.ts

@@ -5,19 +5,19 @@
 import { PreventableEvent } from '../preventable-event';
 import { ContextMenuComponent } from './context-menu.component';
 /**
- * Arguments for the `popupOpen` and `popupClose` events of the ContextMenu.
+ * Represents the arguments for the `popupOpen` and `popupClose` events of the ContextMenu.
  */
 export declare class ContextMenuPopupEvent extends PreventableEvent {
     /**
-     * The target element for which the ContextMenu is opened.
+     * Specifies the target element for which the ContextMenu is opened.
      */
     target: any;
     /**
-     * The DOM event that started the action.
+     * Specifies the DOM event that started the action.
      */
     originalEvent: any;
     /**
-     * The ContextMenuComponent that triggered the event.
+     * Specifies the ContextMenuComponent that triggered the event.
      */
     sender: ContextMenuComponent;
     /**

package/context-menu/context-menu-select-event.d.ts

@@ -4,11 +4,11 @@
 *-------------------------------------------------------------------------------------------*/
 import { ContextMenuEvent } from './context-menu-event';
 /**
- * Arguments for the `select` event of the ContextMenu.
+ * Represents the arguments for the `select` event of the ContextMenu.
  */
 export declare class ContextMenuSelectEvent extends ContextMenuEvent {
     /**
-     * The DOM event that triggered the selection.
+     * Specifies the DOM event that triggered the selection.
      */
     originalEvent: any;
 }

package/context-menu/context-menu-target-container.directive.d.ts

@@ -6,7 +6,18 @@ import { ElementRef } from '@angular/core';
 import { ContextMenuTargetService } from './context-menu-target.service';
 import * as i0 from "@angular/core";
 /**
- * Specifies a container for the [targets]({% slug api_menu_contextmenutargetdirective %}) of the ContextMenu.
+ * Represents a container for the [targets]({% slug api_menu_contextmenutargetdirective %}) of the ContextMenu.
+ *
+ * @example
+ * ```html
+ * <div
+ *   #target="kendoContextMenuTargetContainer"
+ *   kendoContextMenuTargetContainer
+ * >
+ *   <div kendoContextMenuTarget></div>
+ *   <div kendoContextMenuTarget></div>
+ * </div>
+ * ```
  */
 export declare class ContextMenuTargetContainerDirective {
     targetService: ContextMenuTargetService;

package/context-menu/context-menu-target.directive.d.ts

@@ -10,17 +10,22 @@ import * as i0 from "@angular/core";
  */
 export declare const TARGET_CLASS = "k-contextmenu-target";
 /**
- * Specifies a [target]({% slug api_menu_contextmenutargetdirective %}) for the ContextMenu
+ * Represents a [target]({% slug api_menu_contextmenutargetdirective %}) for the ContextMenu
  * ([see example]({% slug target_contextmenu %}#toc-directives)).
+ *
+ * @example
+ * ```html
+ * <div kendoContextMenuTarget> </div>
+ * ```
  */
 export declare class ContextMenuTargetDirective implements OnDestroy {
     targetService: ContextMenuTargetService;
     /**
-     * The data which is associated with the target.
+     * Specifies the data which is associated with the target.
      */
     data: any;
     /**
-     * The target DOM element.
+     * Specifies the target DOM element.
      */
     element: any;
     /**

package/context-menu/context-menu-template.directive.d.ts

@@ -10,6 +10,15 @@ import * as i0 from "@angular/core";
  * ([more information and examples]({% slug templates_contextmenu %})).
  *
  * <demo metaUrl="menus/context-menu/template/" height="200"></demo>
+ *
+ * @example
+ * ```html
+ * <kendo-contextmenu>
+ *   <ng-template kendoContextMenuTemplate let-item="item">
+ *     <span>{{ item.text }}</span>
+ *   </ng-template>
+ * </kendo-contextmenu>
+ * ```
  */
 export declare class ContextMenuTemplateDirective {
     templateRef: TemplateRef<any>;

package/context-menu/context-menu.component.d.ts

@@ -39,6 +39,7 @@ export declare class ContextMenuComponent extends MenuBase implements OnInit, On
     /**
      * Specifies the event on which the ContextMenu will open ([see example]({% slug showon_contextmenu %})).
      * Accepts the name of a native DOM event. For example, `click`, `dblclick`, `mouseover`, etc.
+     *
      * @default 'contextmenu'
      */
     showOn: string;
@@ -52,38 +53,38 @@ export declare class ContextMenuComponent extends MenuBase implements OnInit, On
      */
     filter: string;
     /**
-     * Indicates that the ContextMenu will be aligned to the target or to the `filter` element (if specified).
+     * Specifies if the ContextMenu will be aligned to the target or to the `filter` element (if specified).
+     *
      * @default false
      */
     alignToAnchor: boolean;
     /**
      * Specifies if the Menu will be vertically rendered ([see example]({% slug orientation_contextmenu %})).
+     *
      * @default true
      */
     vertical: boolean;
     /**
      * Specifies the popup animation.
+     *
      * @default true
      */
     popupAnimate: boolean | PopupAnimation;
     /**
      * Specifies the pivot point of the popup.
+     *
      * @default { horizontal: 'left', vertical: 'top' }
-     * The possible values are:
-     * - `horizontal`—`left`, `center`, `right`
-     * - `vertical`—`top`, `center`, `bottom`
      */
     popupAlign: Align;
     /**
      * Specifies the pivot point of the anchor. Applicable if `alignToAnchor` is `true`.
+     *
      * @default { horizontal: 'left', vertical: 'bottom' }
-     * The possible values are:
-     * - `horizontal`—`left`, `center`, `right`
-     * - `vertical`—`top`, `center`, `bottom`
      */
     anchorAlign: Align;
     /**
      * Configures the collision behavior of the popup.
+     *
      * @default { horizontal: 'fit', vertical: 'flip' }
      */
     collision: Collision;
@@ -138,6 +139,7 @@ export declare class ContextMenuComponent extends MenuBase implements OnInit, On
     hide(): void;
     /**
      * Shows the ContextMenu for the specified target.
+     *
      * @param target - The offset or the target element for which the ContextMenu will open.
      */
     show(target: Offset | HTMLElement | ElementRef): void;

package/data-binding/flat-binding.directive.d.ts

@@ -6,11 +6,17 @@ import { MenuBase } from '../menu-base';
 import { BindingDirectiveBase } from './binding-directive-base';
 import * as i0 from "@angular/core";
 /**
- * A directive that converts the provided flat data to [MenuItems]({% slug api_menu_menuitem %}) and binds them to the Menu.
+ * Represents a directive that converts the provided flat data to [MenuItems]({% slug api_menu_menuitem %}) and binds them to the Menu.
+ *
+ * @example
+ * ```html
+ * <kendo-menu [kendoMenuFlatBinding]="flatData" [textField]="'text'" [idField]="'id'" [parentIdField]="'parentId'">
+ * </kendo-menu>
+ * ```
  */
 export declare class FlatBindingDirective extends BindingDirectiveBase {
     /**
-     *  The array of data which will be used to populate the Menu.
+     * Specifies the array of data which will be used to populate the Menu.
      */
     data: any[];
     /**

package/data-binding/hierachy-binding.directive.d.ts

@@ -6,11 +6,17 @@ import { MenuBase } from '../menu-base';
 import { BindingDirectiveBase } from './binding-directive-base';
 import * as i0 from "@angular/core";
 /**
- * A directive that converts the provided hierarchical data to [MenuItems]({% slug api_menu_menuitem %}) and binds them to the Menu.
+ * Represents a directive that converts the provided hierarchical data to [MenuItems]({% slug api_menu_menuitem %}) and binds them to the Menu.
+ *
+ * @example
+ * ```html
+ * <kendo-menu [kendoMenuHierarchyBinding]="hierarchicalData" [textField]="'text'" [childrenField]="'items'">
+ * </kendo-menu>
+ * ```
  */
 export declare class HierarchyBindingDirective extends BindingDirectiveBase {
     /**
-     *  The array of data which will be used to populate the Menu.
+     * Specifies the array of data which will be used to populate the Menu.
      */
     data: any[];
     /**

package/directives.d.ts

@@ -16,14 +16,14 @@ import { ContextMenuTemplateDirective } from './context-menu/context-menu-templa
 import { ContextMenuTargetDirective } from './context-menu/context-menu-target.directive';
 import { ContextMenuTargetContainerDirective } from './context-menu/context-menu-target-container.directive';
 /**
-* Utility array that contains all `Menu` related components and directives.
-*/
+ * Represents a utility array that contains all `Menu` related components and directives.
+ */
 export declare const KENDO_MENU: readonly [typeof MenuComponent, typeof MenuItemComponent, typeof ItemTemplateDirective, typeof ItemLinkTemplateDirective, typeof ItemContentTemplateDirective, typeof HierarchyBindingDirective, typeof FlatBindingDirective, typeof LinkDirective, typeof ExpandArrowComponent];
 /**
-* Utility array that contains all `ContextMenu` related components and directives.
-*/
+ * Represents a utility array that contains all `ContextMenu` related components and directives.
+ */
 export declare const KENDO_CONTEXTMENU: readonly [typeof ContextMenuComponent, typeof ContextMenuTemplateDirective, typeof ContextMenuTargetDirective, typeof ContextMenuTargetContainerDirective, typeof MenuComponent, typeof MenuItemComponent, typeof ItemTemplateDirective, typeof ItemLinkTemplateDirective, typeof ItemContentTemplateDirective, typeof HierarchyBindingDirective, typeof FlatBindingDirective, typeof LinkDirective, typeof ExpandArrowComponent];
 /**
-* Utility array that contains all `@progress/kendo-angular-menu` related components and directives.
-*/
+ * Represents a utility array that contains all `@progress/kendo-angular-menu` related components and directives.
+ */
 export declare const KENDO_MENUS: readonly [typeof MenuComponent, typeof MenuItemComponent, typeof ItemTemplateDirective, typeof ItemLinkTemplateDirective, typeof ItemContentTemplateDirective, typeof HierarchyBindingDirective, typeof FlatBindingDirective, typeof LinkDirective, typeof ExpandArrowComponent, typeof ContextMenuComponent, typeof ContextMenuTemplateDirective, typeof ContextMenuTargetDirective, typeof ContextMenuTargetContainerDirective, typeof MenuComponent, typeof MenuItemComponent, typeof ItemTemplateDirective, typeof ItemLinkTemplateDirective, typeof ItemContentTemplateDirective, typeof HierarchyBindingDirective, typeof FlatBindingDirective, typeof LinkDirective, typeof ExpandArrowComponent];

package/esm2022/context-menu/context-menu-event.mjs

@@ -3,23 +3,23 @@
 * Licensed under commercial license. See LICENSE.md in the project root for more information
 *-------------------------------------------------------------------------------------------*/
 /**
- * Arguments for the `open` and `close` events of the ContextMenu.
+ * Represents the arguments for the `open` and `close` events of the ContextMenu.
  */
 export class ContextMenuEvent {
     /**
-     * The target element for which the ContextMenu is opened.
+     * Specifies the target element for which the ContextMenu is opened.
      */
     target;
     /**
-     * The ContextMenuComponent that triggered the event.
+     * Specifies the ContextMenuComponent that triggered the event.
      */
     sender;
     /**
-     * The item data of the event.
+     * Specifies the item data of the event.
      */
     item;
     /**
-     * The item index of the event.
+     * Specifies the item index of the event.
      */
     index;
 }

package/esm2022/context-menu/context-menu-popup-event.mjs

@@ -4,19 +4,19 @@
 *-------------------------------------------------------------------------------------------*/
 import { PreventableEvent } from '../preventable-event';
 /**
- * Arguments for the `popupOpen` and `popupClose` events of the ContextMenu.
+ * Represents the arguments for the `popupOpen` and `popupClose` events of the ContextMenu.
  */
 export class ContextMenuPopupEvent extends PreventableEvent {
     /**
-     * The target element for which the ContextMenu is opened.
+     * Specifies the target element for which the ContextMenu is opened.
      */
     target;
     /**
-     * The DOM event that started the action.
+     * Specifies the DOM event that started the action.
      */
     originalEvent;
     /**
-     * The ContextMenuComponent that triggered the event.
+     * Specifies the ContextMenuComponent that triggered the event.
      */
     sender;
     /**

package/esm2022/context-menu/context-menu-select-event.mjs

@@ -4,11 +4,11 @@
 *-------------------------------------------------------------------------------------------*/
 import { ContextMenuEvent } from './context-menu-event';
 /**
- * Arguments for the `select` event of the ContextMenu.
+ * Represents the arguments for the `select` event of the ContextMenu.
  */
 export class ContextMenuSelectEvent extends ContextMenuEvent {
     /**
-     * The DOM event that triggered the selection.
+     * Specifies the DOM event that triggered the selection.
      */
     originalEvent;
 }

package/esm2022/context-menu/context-menu-target-container.directive.mjs

@@ -7,7 +7,18 @@ import { ContextMenuTargetService } from './context-menu-target.service';
 import * as i0 from "@angular/core";
 import * as i1 from "./context-menu-target.service";
 /**
- * Specifies a container for the [targets]({% slug api_menu_contextmenutargetdirective %}) of the ContextMenu.
+ * Represents a container for the [targets]({% slug api_menu_contextmenutargetdirective %}) of the ContextMenu.
+ *
+ * @example
+ * ```html
+ * <div
+ *   #target="kendoContextMenuTargetContainer"
+ *   kendoContextMenuTargetContainer
+ * >
+ *   <div kendoContextMenuTarget></div>
+ *   <div kendoContextMenuTarget></div>
+ * </div>
+ * ```
  */
 export class ContextMenuTargetContainerDirective {
     targetService;

package/esm2022/context-menu/context-menu-target.directive.mjs

@@ -11,17 +11,22 @@ import * as i1 from "./context-menu-target.service";
  */
 export const TARGET_CLASS = 'k-contextmenu-target';
 /**
- * Specifies a [target]({% slug api_menu_contextmenutargetdirective %}) for the ContextMenu
+ * Represents a [target]({% slug api_menu_contextmenutargetdirective %}) for the ContextMenu
  * ([see example]({% slug target_contextmenu %}#toc-directives)).
+ *
+ * @example
+ * ```html
+ * <div kendoContextMenuTarget> </div>
+ * ```
  */
 export class ContextMenuTargetDirective {
     targetService;
     /**
-     * The data which is associated with the target.
+     * Specifies the data which is associated with the target.
      */
     data;
     /**
-     * The target DOM element.
+     * Specifies the target DOM element.
      */
     element;
     /**

package/esm2022/context-menu/context-menu-template.directive.mjs

@@ -10,6 +10,15 @@ import * as i0 from "@angular/core";
  * ([more information and examples]({% slug templates_contextmenu %})).
  *
  * <demo metaUrl="menus/context-menu/template/" height="200"></demo>
+ *
+ * @example
+ * ```html
+ * <kendo-contextmenu>
+ *   <ng-template kendoContextMenuTemplate let-item="item">
+ *     <span>{{ item.text }}</span>
+ *   </ng-template>
+ * </kendo-contextmenu>
+ * ```
  */
 export class ContextMenuTemplateDirective {
     templateRef;

package/esm2022/context-menu/context-menu.component.mjs

@@ -53,6 +53,7 @@ export class ContextMenuComponent extends MenuBase {
     /**
      * Specifies the event on which the ContextMenu will open ([see example]({% slug showon_contextmenu %})).
      * Accepts the name of a native DOM event. For example, `click`, `dblclick`, `mouseover`, etc.
+     *
      * @default 'contextmenu'
      */
     showOn = CONTEXT_MENU;
@@ -66,38 +67,38 @@ export class ContextMenuComponent extends MenuBase {
      */
     filter;
     /**
-     * Indicates that the ContextMenu will be aligned to the target or to the `filter` element (if specified).
+     * Specifies if the ContextMenu will be aligned to the target or to the `filter` element (if specified).
+     *
      * @default false
      */
     alignToAnchor = false;
     /**
      * Specifies if the Menu will be vertically rendered ([see example]({% slug orientation_contextmenu %})).
+     *
      * @default true
      */
     vertical = true;
     /**
      * Specifies the popup animation.
+     *
      * @default true
      */
     popupAnimate;
     /**
      * Specifies the pivot point of the popup.
+     *
      * @default { horizontal: 'left', vertical: 'top' }
-     * The possible values are:
-     * - `horizontal`—`left`, `center`, `right`
-     * - `vertical`—`top`, `center`, `bottom`
      */
     popupAlign;
     /**
      * Specifies the pivot point of the anchor. Applicable if `alignToAnchor` is `true`.
+     *
      * @default { horizontal: 'left', vertical: 'bottom' }
-     * The possible values are:
-     * - `horizontal`—`left`, `center`, `right`
-     * - `vertical`—`top`, `center`, `bottom`
      */
     anchorAlign;
     /**
      * Configures the collision behavior of the popup.
+     *
      * @default { horizontal: 'fit', vertical: 'flip' }
      */
     collision;
@@ -162,6 +163,7 @@ export class ContextMenuComponent extends MenuBase {
     }
     /**
      * Shows the ContextMenu for the specified target.
+     *
      * @param target - The offset or the target element for which the ContextMenu will open.
      */
     show(target) {

package/esm2022/data-binding/flat-binding.directive.mjs

@@ -9,11 +9,17 @@ import { getter } from './utils';
 import * as i0 from "@angular/core";
 import * as i1 from "../menu-base";
 /**
- * A directive that converts the provided flat data to [MenuItems]({% slug api_menu_menuitem %}) and binds them to the Menu.
+ * Represents a directive that converts the provided flat data to [MenuItems]({% slug api_menu_menuitem %}) and binds them to the Menu.
+ *
+ * @example
+ * ```html
+ * <kendo-menu [kendoMenuFlatBinding]="flatData" [textField]="'text'" [idField]="'id'" [parentIdField]="'parentId'">
+ * </kendo-menu>
+ * ```
  */
 export class FlatBindingDirective extends BindingDirectiveBase {
     /**
-     *  The array of data which will be used to populate the Menu.
+     * Specifies the array of data which will be used to populate the Menu.
      */
     data;
     /**

package/esm2022/data-binding/hierachy-binding.directive.mjs

@@ -10,11 +10,17 @@ import * as i0 from "@angular/core";
 import * as i1 from "../menu-base";
 const getField = (field, level) => Array.isArray(field) ? field[level] || last(field) : field;
 /**
- * A directive that converts the provided hierarchical data to [MenuItems]({% slug api_menu_menuitem %}) and binds them to the Menu.
+ * Represents a directive that converts the provided hierarchical data to [MenuItems]({% slug api_menu_menuitem %}) and binds them to the Menu.
+ *
+ * @example
+ * ```html
+ * <kendo-menu [kendoMenuHierarchyBinding]="hierarchicalData" [textField]="'text'" [childrenField]="'items'">
+ * </kendo-menu>
+ * ```
  */
 export class HierarchyBindingDirective extends BindingDirectiveBase {
     /**
-     *  The array of data which will be used to populate the Menu.
+     * Specifies the array of data which will be used to populate the Menu.
      */
     data;
     /**

package/esm2022/directives.mjs

@@ -16,8 +16,8 @@ import { ContextMenuTemplateDirective } from './context-menu/context-menu-templa
 import { ContextMenuTargetDirective } from './context-menu/context-menu-target.directive';
 import { ContextMenuTargetContainerDirective } from './context-menu/context-menu-target-container.directive';
 /**
-* Utility array that contains all `Menu` related components and directives.
-*/
+ * Represents a utility array that contains all `Menu` related components and directives.
+ */
 export const KENDO_MENU = [
     MenuComponent,
     MenuItemComponent,
@@ -30,8 +30,8 @@ export const KENDO_MENU = [
     ExpandArrowComponent
 ];
 /**
-* Utility array that contains all `ContextMenu` related components and directives.
-*/
+ * Represents a utility array that contains all `ContextMenu` related components and directives.
+ */
 export const KENDO_CONTEXTMENU = [
     ContextMenuComponent,
     ContextMenuTemplateDirective,
@@ -40,8 +40,8 @@ export const KENDO_CONTEXTMENU = [
     ...KENDO_MENU
 ];
 /**
-* Utility array that contains all `@progress/kendo-angular-menu` related components and directives.
-*/
+ * Represents a utility array that contains all `@progress/kendo-angular-menu` related components and directives.
+ */
 export const KENDO_MENUS = [
     ...KENDO_MENU,
     ...KENDO_CONTEXTMENU

package/esm2022/menu-event.mjs

@@ -4,19 +4,19 @@
 *-------------------------------------------------------------------------------------------*/
 import { PreventableEvent } from './preventable-event';
 /**
- * Arguments for the `open` and `close` events of the Menu.
+ * Represents the arguments for the `open` and `close` events of the Menu.
  */
 export class MenuEvent extends PreventableEvent {
     /**
-     * The MenuComponent that triggered the event.
+     * Specifies the MenuComponent that triggered the event.
      */
     sender;
     /**
-     * The item data of the event.
+     * Specifies the item data of the event.
      */
     item;
     /**
-     * The item index of the event.
+     * Specifies the item index of the event.
      */
     index;
 }

package/esm2022/menu-item.component.mjs

@@ -8,7 +8,7 @@ import { ItemLinkTemplateDirective } from './templates/item-link-template.direct
 import { ItemContentTemplateDirective } from './templates/item-content-template.directive';
 import * as i0 from "@angular/core";
 /**
- * A component that can be used to specify the Menu items
+ * Represents a component that can be used to specify the Menu items
  * ([more information and examples]({% slug items_menu %})).
  *
  * @example

package/esm2022/package-metadata.mjs

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

package/esm2022/rendering/arrow.component.mjs

@@ -11,11 +11,18 @@ import * as i1 from "../services/items.service";
 /**
  * Represents a component that can be used in the [`linkTemplate`]({% slug api_menu_itemlinktemplatedirective %})
  * of the items to render the default expand arrow.
+ *
+ * @example
+ * ```html
+ * <ng-template kendoMenuItemLinkTemplate let-item="item" let-index="index">
+ *   <span [kendoMenuExpandArrow]="index"></span>
+ * </ng-template>
+ * ```
  */
 export class ExpandArrowComponent {
     itemsService;
     /**
-     * The index of the Menu item. The input is mandatory.
+     * Specifies the index of the Menu item. The input is mandatory.
      */
     index;
     hostClasses = true;

package/esm2022/rendering/link.directive.mjs

@@ -9,11 +9,18 @@ import * as i1 from "../services/items.service";
 /**
  * Represents a directive that can be used in the [`linkTemplate`]({% slug api_menu_itemlinktemplatedirective %})
  * of the items to apply the default styling and behavior.
+ *
+ * @example
+ * ```html
+ * <ng-template kendoMenuItemLinkTemplate let-item="item" let-index="index">
+ *   <a [kendoMenuItemLink]="index">{{ item.text }}</a>
+ * </ng-template>
+ * ```
  */
 export class LinkDirective {
     itemsService;
     /**
-     * The index of the Menu item. The input is mandatory.
+     * Specifies the index of the Menu item. The input is mandatory.
      */
     index;
     hostClasses = true;

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

@@ -22,8 +22,8 @@ const packageMetadata = {
     productName: 'Kendo UI for Angular',
     productCode: 'KENDOUIANGULAR',
     productCodes: ['KENDOUIANGULAR'],
-    publishDate: 1749540187,
-    version: '19.1.1',
+    publishDate: 1749820535,
+    version: '19.1.2-develop.2',
     licensingDocsUrl: 'https://www.telerik.com/kendo-angular-ui/my-license/'
 };
 
@@ -988,7 +988,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
                 }] }]; } });
 
 /**
- * A component that can be used to specify the Menu items
+ * Represents a component that can be used to specify the Menu items
  * ([more information and examples]({% slug items_menu %})).
  *
  * @example
@@ -2209,11 +2209,18 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
 /**
  * Represents a directive that can be used in the [`linkTemplate`]({% slug api_menu_itemlinktemplatedirective %})
  * of the items to apply the default styling and behavior.
+ *
+ * @example
+ * ```html
+ * <ng-template kendoMenuItemLinkTemplate let-item="item" let-index="index">
+ *   <a [kendoMenuItemLink]="index">{{ item.text }}</a>
+ * </ng-template>
+ * ```
  */
 class LinkDirective {
     itemsService;
     /**
-     * The index of the Menu item. The input is mandatory.
+     * Specifies the index of the Menu item. The input is mandatory.
      */
     index;
     hostClasses = true;
@@ -2264,11 +2271,18 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
 /**
  * Represents a component that can be used in the [`linkTemplate`]({% slug api_menu_itemlinktemplatedirective %})
  * of the items to render the default expand arrow.
+ *
+ * @example
+ * ```html
+ * <ng-template kendoMenuItemLinkTemplate let-item="item" let-index="index">
+ *   <span [kendoMenuExpandArrow]="index"></span>
+ * </ng-template>
+ * ```
  */
 class ExpandArrowComponent {
     itemsService;
     /**
-     * The index of the Menu item. The input is mandatory.
+     * Specifies the index of the Menu item. The input is mandatory.
      */
     index;
     hostClasses = true;
@@ -2347,19 +2361,19 @@ class PreventableEvent {
 }
 
 /**
- * Arguments for the `open` and `close` events of the Menu.
+ * Represents the arguments for the `open` and `close` events of the Menu.
  */
 class MenuEvent extends PreventableEvent {
     /**
-     * The MenuComponent that triggered the event.
+     * Specifies the MenuComponent that triggered the event.
      */
     sender;
     /**
-     * The item data of the event.
+     * Specifies the item data of the event.
      */
     item;
     /**
-     * The item index of the event.
+     * Specifies the item index of the event.
      */
     index;
 }
@@ -2443,11 +2457,17 @@ const last = (arr) => arr[arr.length - 1];
 
 const getField = (field, level) => Array.isArray(field) ? field[level] || last(field) : field;
 /**
- * A directive that converts the provided hierarchical data to [MenuItems]({% slug api_menu_menuitem %}) and binds them to the Menu.
+ * Represents a directive that converts the provided hierarchical data to [MenuItems]({% slug api_menu_menuitem %}) and binds them to the Menu.
+ *
+ * @example
+ * ```html
+ * <kendo-menu [kendoMenuHierarchyBinding]="hierarchicalData" [textField]="'text'" [childrenField]="'items'">
+ * </kendo-menu>
+ * ```
  */
 class HierarchyBindingDirective extends BindingDirectiveBase {
     /**
-     *  The array of data which will be used to populate the Menu.
+     * Specifies the array of data which will be used to populate the Menu.
      */
     data;
     /**
@@ -2548,11 +2568,17 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
             }] } });
 
 /**
- * A directive that converts the provided flat data to [MenuItems]({% slug api_menu_menuitem %}) and binds them to the Menu.
+ * Represents a directive that converts the provided flat data to [MenuItems]({% slug api_menu_menuitem %}) and binds them to the Menu.
+ *
+ * @example
+ * ```html
+ * <kendo-menu [kendoMenuFlatBinding]="flatData" [textField]="'text'" [idField]="'id'" [parentIdField]="'parentId'">
+ * </kendo-menu>
+ * ```
  */
 class FlatBindingDirective extends BindingDirectiveBase {
     /**
-     *  The array of data which will be used to populate the Menu.
+     * Specifies the array of data which will be used to populate the Menu.
      */
     data;
     /**
@@ -2669,19 +2695,19 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
             }] } });
 
 /**
- * Arguments for the `popupOpen` and `popupClose` events of the ContextMenu.
+ * Represents the arguments for the `popupOpen` and `popupClose` events of the ContextMenu.
  */
 class ContextMenuPopupEvent extends PreventableEvent {
     /**
-     * The target element for which the ContextMenu is opened.
+     * Specifies the target element for which the ContextMenu is opened.
      */
     target;
     /**
-     * The DOM event that started the action.
+     * Specifies the DOM event that started the action.
      */
     originalEvent;
     /**
-     * The ContextMenuComponent that triggered the event.
+     * Specifies the ContextMenuComponent that triggered the event.
      */
     sender;
     /**
@@ -2719,6 +2745,15 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
  * ([more information and examples]({% slug templates_contextmenu %})).
  *
  * <demo metaUrl="menus/context-menu/template/" height="200"></demo>
+ *
+ * @example
+ * ```html
+ * <kendo-contextmenu>
+ *   <ng-template kendoContextMenuTemplate let-item="item">
+ *     <span>{{ item.text }}</span>
+ *   </ng-template>
+ * </kendo-contextmenu>
+ * ```
  */
 class ContextMenuTemplateDirective {
     templateRef;
@@ -2761,7 +2796,18 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
         }] });
 
 /**
- * Specifies a container for the [targets]({% slug api_menu_contextmenutargetdirective %}) of the ContextMenu.
+ * Represents a container for the [targets]({% slug api_menu_contextmenutargetdirective %}) of the ContextMenu.
+ *
+ * @example
+ * ```html
+ * <div
+ *   #target="kendoContextMenuTargetContainer"
+ *   kendoContextMenuTargetContainer
+ * >
+ *   <div kendoContextMenuTarget></div>
+ *   <div kendoContextMenuTarget></div>
+ * </div>
+ * ```
  */
 class ContextMenuTargetContainerDirective {
     targetService;
@@ -2796,17 +2842,22 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
  */
 const TARGET_CLASS = 'k-contextmenu-target';
 /**
- * Specifies a [target]({% slug api_menu_contextmenutargetdirective %}) for the ContextMenu
+ * Represents a [target]({% slug api_menu_contextmenutargetdirective %}) for the ContextMenu
  * ([see example]({% slug target_contextmenu %}#toc-directives)).
+ *
+ * @example
+ * ```html
+ * <div kendoContextMenuTarget> </div>
+ * ```
  */
 class ContextMenuTargetDirective {
     targetService;
     /**
-     * The data which is associated with the target.
+     * Specifies the data which is associated with the target.
      */
     data;
     /**
-     * The target DOM element.
+     * Specifies the target DOM element.
      */
     element;
     /**
@@ -2873,6 +2924,7 @@ class ContextMenuComponent extends MenuBase {
     /**
      * Specifies the event on which the ContextMenu will open ([see example]({% slug showon_contextmenu %})).
      * Accepts the name of a native DOM event. For example, `click`, `dblclick`, `mouseover`, etc.
+     *
      * @default 'contextmenu'
      */
     showOn = CONTEXT_MENU;
@@ -2886,38 +2938,38 @@ class ContextMenuComponent extends MenuBase {
      */
     filter;
     /**
-     * Indicates that the ContextMenu will be aligned to the target or to the `filter` element (if specified).
+     * Specifies if the ContextMenu will be aligned to the target or to the `filter` element (if specified).
+     *
      * @default false
      */
     alignToAnchor = false;
     /**
      * Specifies if the Menu will be vertically rendered ([see example]({% slug orientation_contextmenu %})).
+     *
      * @default true
      */
     vertical = true;
     /**
      * Specifies the popup animation.
+     *
      * @default true
      */
     popupAnimate;
     /**
      * Specifies the pivot point of the popup.
+     *
      * @default { horizontal: 'left', vertical: 'top' }
-     * The possible values are:
-     * - `horizontal`—`left`, `center`, `right`
-     * - `vertical`—`top`, `center`, `bottom`
      */
     popupAlign;
     /**
      * Specifies the pivot point of the anchor. Applicable if `alignToAnchor` is `true`.
+     *
      * @default { horizontal: 'left', vertical: 'bottom' }
-     * The possible values are:
-     * - `horizontal`—`left`, `center`, `right`
-     * - `vertical`—`top`, `center`, `bottom`
      */
     anchorAlign;
     /**
      * Configures the collision behavior of the popup.
+     *
      * @default { horizontal: 'fit', vertical: 'flip' }
      */
     collision;
@@ -2982,6 +3034,7 @@ class ContextMenuComponent extends MenuBase {
     }
     /**
      * Shows the ContextMenu for the specified target.
+     *
      * @param target - The offset or the target element for which the ContextMenu will open.
      */
     show(target) {
@@ -3340,8 +3393,8 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
             }] } });
 
 /**
-* Utility array that contains all `Menu` related components and directives.
-*/
+ * Represents a utility array that contains all `Menu` related components and directives.
+ */
 const KENDO_MENU = [
     MenuComponent,
     MenuItemComponent,
@@ -3354,8 +3407,8 @@ const KENDO_MENU = [
     ExpandArrowComponent
 ];
 /**
-* Utility array that contains all `ContextMenu` related components and directives.
-*/
+ * Represents a utility array that contains all `ContextMenu` related components and directives.
+ */
 const KENDO_CONTEXTMENU = [
     ContextMenuComponent,
     ContextMenuTemplateDirective,
@@ -3364,8 +3417,8 @@ const KENDO_CONTEXTMENU = [
     ...KENDO_MENU
 ];
 /**
-* Utility array that contains all `@progress/kendo-angular-menu` related components and directives.
-*/
+ * Represents a utility array that contains all `@progress/kendo-angular-menu` related components and directives.
+ */
 const KENDO_MENUS = [
     ...KENDO_MENU,
     ...KENDO_CONTEXTMENU
@@ -3419,33 +3472,33 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
         }] });
 
 /**
- * Arguments for the `open` and `close` events of the ContextMenu.
+ * Represents the arguments for the `open` and `close` events of the ContextMenu.
  */
 class ContextMenuEvent {
     /**
-     * The target element for which the ContextMenu is opened.
+     * Specifies the target element for which the ContextMenu is opened.
      */
     target;
     /**
-     * The ContextMenuComponent that triggered the event.
+     * Specifies the ContextMenuComponent that triggered the event.
      */
     sender;
     /**
-     * The item data of the event.
+     * Specifies the item data of the event.
      */
     item;
     /**
-     * The item index of the event.
+     * Specifies the item index of the event.
      */
     index;
 }
 
 /**
- * Arguments for the `select` event of the ContextMenu.
+ * Represents the arguments for the `select` event of the ContextMenu.
  */
 class ContextMenuSelectEvent extends ContextMenuEvent {
     /**
-     * The DOM event that triggered the selection.
+     * Specifies the DOM event that triggered the selection.
      */
     originalEvent;
 }

package/menu-animation.interface.d.ts

@@ -3,16 +3,18 @@
 * Licensed under commercial license. See LICENSE.md in the project root for more information
 *-------------------------------------------------------------------------------------------*/
 /**
- * The animation settings for the Popup component.
+ * Represents the animation settings for the Popup component.
  */
 export interface MenuAnimation {
     /**
-     * The type of the animation.
+     * Specifies the type of the animation.
+     *
      * @default 'slide'
      */
     type?: 'slide' | 'expand' | 'zoom' | 'fade';
     /**
-     * The animation duration in milliseconds.
+     * Specifies the animation duration in milliseconds.
+     *
      * @default 100
      */
     duration: number;

package/menu-event.d.ts

@@ -5,19 +5,19 @@
 import { MenuComponent } from './menu.component';
 import { PreventableEvent } from './preventable-event';
 /**
- * Arguments for the `open` and `close` events of the Menu.
+ * Represents the arguments for the `open` and `close` events of the Menu.
  */
 export declare class MenuEvent extends PreventableEvent {
     /**
-     * The MenuComponent that triggered the event.
+     * Specifies the MenuComponent that triggered the event.
      */
     sender: MenuComponent;
     /**
-     * The item data of the event.
+     * Specifies the item data of the event.
      */
     item: any;
     /**
-     * The item index of the event.
+     * Specifies the item index of the event.
      */
     index: string;
 }

package/menu-item.component.d.ts

@@ -10,7 +10,7 @@ import { MenuItem } from './menu-item.interface';
 import { SVGIcon } from '@progress/kendo-svg-icons';
 import * as i0 from "@angular/core";
 /**
- * A component that can be used to specify the Menu items
+ * Represents a component that can be used to specify the Menu items
  * ([more information and examples]({% slug items_menu %})).
  *
  * @example

package/menu-item.interface.d.ts

@@ -5,7 +5,7 @@
 import { TemplateRef } from '@angular/core';
 import { SVGIcon } from '@progress/kendo-angular-icons';
 /**
- * An interface for the Menu items.
+ * Represents an interface for the Menu items.
  */
 export interface MenuItem {
     /**
@@ -32,12 +32,12 @@ export interface MenuItem {
      */
     disabled?: boolean;
     /**
-     * The CSS classes that will be rendered on the item element ([see example](slug:items_menu#toc-adding-styles-and-classes)).
+     * Specifies the CSS classes that will be rendered on the item element ([see example](slug:items_menu#toc-adding-styles-and-classes)).
      * Supports the type of values that are supported by [`ngClass`](link:site.data.urls.angular['ngclassapi']).
      */
     cssClass?: any;
     /**
-     * The CSS styles that will be rendered on the item element ([see example](slug:items_menu#toc-adding-styles-and-classes)).
+     * Specifies the CSS styles that will be rendered on the item element ([see example](slug:items_menu#toc-adding-styles-and-classes)).
      * Supports the type of values that are supported by [`ngStyle`](link:site.data.urls.angular['ngstyleapi']).
      */
     cssStyle?: any;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@progress/kendo-angular-menu",
-  "version": "19.1.1",
+  "version": "19.1.2-develop.2",
   "description": "Kendo UI Angular Menu component",
   "license": "SEE LICENSE IN LICENSE.md",
   "author": "Progress",
@@ -19,7 +19,7 @@
     "package": {
       "productName": "Kendo UI for Angular",
       "productCode": "KENDOUIANGULAR",
-      "publishDate": 1749540187,
+      "publishDate": 1749820535,
       "licensingDocsUrl": "https://www.telerik.com/kendo-angular-ui/my-license/"
     }
   },
@@ -29,15 +29,15 @@
     "@angular/core": "16 - 20",
     "@angular/platform-browser": "16 - 20",
     "@progress/kendo-licensing": "^1.5.0",
-    "@progress/kendo-angular-common": "19.1.1",
-    "@progress/kendo-angular-l10n": "19.1.1",
-    "@progress/kendo-angular-icons": "19.1.1",
-    "@progress/kendo-angular-popup": "19.1.1",
+    "@progress/kendo-angular-common": "19.1.2-develop.2",
+    "@progress/kendo-angular-l10n": "19.1.2-develop.2",
+    "@progress/kendo-angular-icons": "19.1.2-develop.2",
+    "@progress/kendo-angular-popup": "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"
   },
   "schematics": "./schematics/collection.json",
   "module": "fesm2022/progress-kendo-angular-menu.mjs",

package/rendering/arrow.component.d.ts

@@ -9,11 +9,18 @@ import * as i0 from "@angular/core";
 /**
  * Represents a component that can be used in the [`linkTemplate`]({% slug api_menu_itemlinktemplatedirective %})
  * of the items to render the default expand arrow.
+ *
+ * @example
+ * ```html
+ * <ng-template kendoMenuItemLinkTemplate let-item="item" let-index="index">
+ *   <span [kendoMenuExpandArrow]="index"></span>
+ * </ng-template>
+ * ```
  */
 export declare class ExpandArrowComponent implements OnInit {
     private itemsService;
     /**
-     * The index of the Menu item. The input is mandatory.
+     * Specifies the index of the Menu item. The input is mandatory.
      */
     index: string;
     hostClasses: boolean;

package/rendering/link.directive.d.ts

@@ -8,11 +8,18 @@ import * as i0 from "@angular/core";
 /**
  * Represents a directive that can be used in the [`linkTemplate`]({% slug api_menu_itemlinktemplatedirective %})
  * of the items to apply the default styling and behavior.
+ *
+ * @example
+ * ```html
+ * <ng-template kendoMenuItemLinkTemplate let-item="item" let-index="index">
+ *   <a [kendoMenuItemLink]="index">{{ item.text }}</a>
+ * </ng-template>
+ * ```
  */
 export declare class LinkDirective implements OnInit {
     private itemsService;
     /**
-     * The index of the Menu item. The input is mandatory.
+     * Specifies the index of the Menu item. The input is mandatory.
      */
     index: string;
     hostClasses: boolean;