@progress/kendo-angular-buttons 19.1.1-develop.2 → 19.1.1

package/listbutton/popup-settings.d.ts

@@ -4,44 +4,49 @@
 *-------------------------------------------------------------------------------------------*/
 import { ViewContainerRef } from '@angular/core';
 /**
- * Used for configuring the popup settings.
+ * Configures the popup settings.
  *
  * @example
  * ```ts
- * _@Component({
+ * @Component({
  * selector: 'my-app',
  * template: `
- * <kendo-splitbutton [data]="listItems" [popupSettings]="{ animate: animate, popupClass: popupClass, appendTo: 'component' }">
+ * <kendo-splitbutton [data]="items" [popupSettings]="popupSettings">
  *    SplitButton
  * </kendo-splitbutton>
  * `
  * })
  * class AppComponent {
- *   public animate: boolean = false;
- *   public popupClass: string = 'customClass';
- *   public listItems: Array<any> = [{
+ *   public popupSettings: PopupSettings = {
+ *      popupClass: 'customClass',
+ *      align: 'center',
+ *   };
+ *   public items: Array<any> = [{
  *      text: 'item1'
- *  }, {
+ *   }, {
  *      text: 'item2'
- *  }]
+ *   }];
  * }
  * ```
  */
 export interface PopupSettings {
     /**
-     * Controls the popup animation. By default, the open and close animation are enabled.
+     * Enables or disables the popup animation.
+     * By default, the open and close animations are enabled.
      */
     animate?: boolean;
     /**
-     * Specifies a list of CSS classes used for styling the popup.
+     * Specifies CSS classes for styling the popup.
      */
     popupClass?: string;
     /**
-     * Controls the popup container. By default, the popup will be appended to the root component.
+     * Specifies the container for the popup.
+     * By default, the popup is appended to the root component.
      */
     appendTo?: 'root' | 'component' | ViewContainerRef;
     /**
-     * Controls the alignment of the popup. By default, the popup is left aligned.
+     * Specifies the alignment of the popup.
+     * By default, the popup is left-aligned.
      */
     align?: 'left' | 'center' | 'right';
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@progress/kendo-angular-buttons",
-  "version": "19.1.1-develop.2",
+  "version": "19.1.1",
   "description": "Buttons Package for Angular",
   "license": "SEE LICENSE IN LICENSE.md",
   "author": "Progress",
@@ -21,7 +21,7 @@
     "package": {
       "productName": "Kendo UI for Angular",
       "productCode": "KENDOUIANGULAR",
-      "publishDate": 1749196463,
+      "publishDate": 1749539933,
       "licensingDocsUrl": "https://www.telerik.com/kendo-angular-ui/my-license/"
     }
   },
@@ -31,15 +31,15 @@
     "@angular/core": "16 - 20",
     "@angular/platform-browser": "16 - 20",
     "@progress/kendo-licensing": "^1.5.0",
-    "@progress/kendo-angular-common": "19.1.1-develop.2",
-    "@progress/kendo-angular-l10n": "19.1.1-develop.2",
-    "@progress/kendo-angular-popup": "19.1.1-develop.2",
-    "@progress/kendo-angular-icons": "19.1.1-develop.2",
+    "@progress/kendo-angular-common": "19.1.1",
+    "@progress/kendo-angular-l10n": "19.1.1",
+    "@progress/kendo-angular-popup": "19.1.1",
+    "@progress/kendo-angular-icons": "19.1.1",
     "rxjs": "^6.5.3 || ^7.0.0"
   },
   "dependencies": {
     "tslib": "^2.3.1",
-    "@progress/kendo-angular-schematics": "19.1.1-develop.2",
+    "@progress/kendo-angular-schematics": "19.1.1",
     "@progress/kendo-common": "^1.0.1"
   },
   "schematics": "./schematics/collection.json",

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

@@ -6,8 +6,8 @@ import { LocalizationService } from '@progress/kendo-angular-l10n';
 import { Messages } from './messages';
 import * as i0 from "@angular/core";
 /**
- * Custom component messages override default component messages
- * ([see example]({% slug rtl_buttons %}).
+ * Represents a custom component for overriding the default SplitButton messages.
+ * ([see example]({% slug rtl_buttons %})).
  */
 export declare class SplitButtonCustomMessagesComponent extends Messages {
     protected service: LocalizationService;

package/splitbutton/localization/messages.d.ts

@@ -9,25 +9,24 @@ import * as i0 from "@angular/core";
  */
 export declare class Messages extends ComponentMessages {
     /**
-     * The text for the SplitButton aria-label.
+     * Specifies the text for the SplitButton `aria-label`.
      *
-     * The text for the aria-label consists of a two-part message - the text of the SplitButton and a localizable string.
-     * For a SplitButton with text 'Reply', the default aria-label will be 'Reply splitbutton'.
+     * The `aria-label` text consists of two parts: the SplitButton text and a localizable string.
+     * For example, for a SplitButton with the text `'Reply'`, the default `aria-label` is `'Reply splitbutton'`.
      *
-     * To allow reordering of the SplitButton text and the localizable part, the splitButtonLabel accepts a string with a
-     * placeholder for the button text - e.g. 'splitbutton for {buttonText}'. The '{buttonText}' placeholder will be replaced
-     * internally with the current SplitButton text, and the resulting aria-label will be rendered as 'splitbutton for Reply'.
+     * To reorder the SplitButton text and the localizable part, use the `splitButtonLabel` property with a
+     * placeholder for the button text, such as `'splitbutton for {buttonText}'`. The `{buttonText}` placeholder
+     * is replaced internally with the current SplitButton text. For instance, the resulting `aria-label` is
+     * rendered as `'splitbutton for Reply'`.
      *
      * @example
-     *
-     * ```ts-no-run
-     *      <kendo-splitbutton>
-     *          <kendo-splitbutton-messages
-     *              splitButtonLabel="splitbutton for {buttonText}"
-     *          >
-     *          </kendo-splitbutton-messages>
-     *      </kendo-splitbutton>
-     *  ```
+     * ```ts
+     * <kendo-splitbutton>
+     *     <kendo-splitbutton-messages
+     *         splitButtonLabel="splitbutton for {buttonText}">
+     *     </kendo-splitbutton-messages>
+     * </kendo-splitbutton>
+     * ```
      */
     splitButtonLabel: string;
     static ɵfac: i0.ɵɵFactoryDeclaration<Messages, never>;

package/splitbutton/splitbutton.component.d.ts

@@ -20,39 +20,27 @@ import * as i0 from "@angular/core";
  *
  * @example
  * ```ts
- * _@Component({
+ * @Component({
  * selector: 'my-app',
  * template: `
- *  <kendo-splitbutton [data]="data" icon="clipboard"
- *      (itemClick)="onSplitButtonItemClick($event)"
- *      (buttonClick)="onSplitButtonClick()">Paste</kendo-splitbutton>
+ *  <kendo-splitbutton [data]="items" (buttonClick)="onSplitButtonClick()">Paste</kendo-splitbutton>
  * `
  * })
  *
  * class AppComponent {
- *   public data: Array<any> = [{
+ *   public items: Array<any> = [{
  *       text: 'Keep Text Only',
  *       icon: 'clipboard-text',
  *       click: () => { console.log('Keep Text Only click handler'); }
  *   }, {
  *       text: 'Paste as HTML',
  *       icon: 'clipboard-code'
- *   }, {
- *       text: 'Paste Markdown',
- *       icon: 'clipboard-markdown'
- *   }, {
- *       text: 'Set Default Paste'
- *   }];
+ *     }
+ *  ];
  *
  *   public onSplitButtonClick(dataItem: any): void {
  *       console.log('Paste');
  *   }
- *
- *   public onSplitButtonItemClick(dataItem: any): void {
- *       if (dataItem) {
- *           console.log(dataItem.text);
- *       }
- *   }
  * }
  * ```
  */
@@ -60,107 +48,67 @@ export declare class SplitButtonComponent extends ListButton implements AfterVie
     private localization;
     private renderer;
     /**
-     * Sets the text of the SplitButton.
+     * Sets the text displayed within the SplitButton.
      */
     text: string;
     /**
-     * Defines an icon to be rendered next to the button text.
-     * ([see example]({% slug databinding_splitbutton %}#toc-arrays-of-complex-data)).
+     * Specifies an icon to display next to the button text ([see example]({% slug databinding_splitbutton %}#arrays-of-complex-data)).
      */
     icon: string;
     /**
-     * Defines an SVGIcon to be rendered next to the button text.
+     * Specifies an `SVGIcon` to display next to the button text.
      */
     svgIcon: SVGIcon;
     /**
-     * Defines an icon with a custom CSS class to be rendered next to the button text
-     * ([see example]({% slug databinding_splitbutton %}#toc-arrays-of-complex-data)).
+     * Specifies a custom CSS class for the icon displayed next to the button text ([see example]({% slug databinding_splitbutton %}#arrays-of-complex-data)).
      */
     iconClass: string;
     /**
-     * Defines the type attribute of the main button
+     * Specifies the `type` attribute of the main button.
      */
     type: string;
     /**
-     * Defines the location of an image to be displayed next to the button text
-     * ([see example]({% slug databinding_splitbutton %}#toc-arrays-of-complex-data)).
+     * Specifies the URL of an image to display next to the button text ([see example]({% slug databinding_splitbutton %}#arrays-of-complex-data)).
      */
     imageUrl: string;
     /**
-     * The size property specifies the padding of the SplitButton
-     * ([see example]({% slug api_buttons_splitbuttoncomponent %}#toc-size)).
+     * Configures the padding of the SplitButton ([see example]({% slug api_buttons_splitbuttoncomponent %}#size)).
      *
-     * The possible values are:
-     * * `small`
-     * * `medium` (default)
-     * * `large`
-     * * `none`
+     * @default 'medium'
      */
     size: ButtonSize;
     /**
-     * The rounded property specifies the border radius of the SplitButton
-     * ([see example]({% slug api_buttons_splitbuttoncomponent %}#toc-rounded)).
+     * Configures the border radius of the SplitButton ([see example]({% slug api_buttons_splitbuttoncomponent %}#rounded)).
      *
-     * The possible values are:
-     * * `small`
-     * * `medium` (default)
-     * * `large`
-     * * `full`
-     * * `none`
+     * @default 'medium'
      */
     set rounded(rounded: ButtonRounded);
     get rounded(): ButtonRounded;
     /**
-     * The fillMode property specifies the background and border styles of the SplitButton
-     * ([see example]({% slug api_buttons_splitbuttoncomponent %}#toc-fillMode)).
+     * Configures the background and border styles of the SplitButton ([see example]({% slug api_buttons_splitbuttoncomponent %}#fillMode)).
      *
-     * The available values are:
-     * * `solid` (default)
-     * * `flat`
-     * * `outline`
-     * * `link`
+     * @default 'solid'
      */
     set fillMode(fillMode: ButtonFillMode);
     get fillMode(): ButtonFillMode;
     /**
-     * The SplitButton allows you to specify predefined theme colors.
-     * The theme color will be applied as a background and border color while also amending the text color accordingly
-     * ([see example]({% slug api_buttons_splitbuttoncomponent %}#toc-themeColor)).
+     * Configures the theme color of the SplitButton. The theme color applies to the background, border, and text ([see example]({% slug api_buttons_splitbuttoncomponent %}#themeColor)).
      *
-     * The possible values are:
-     * * `base` &mdash;Applies coloring based on the `base` theme color. (default)
-     * * `primary` &mdash;Applies coloring based on the `primary` theme color.
-     * * `secondary`&mdash;Applies coloring based on the `secondary` theme color.
-     * * `tertiary`&mdash; Applies coloring based on the `tertiary` theme color.
-     * * `info`&mdash;Applies coloring based on the `info` theme color.
-     * * `success`&mdash; Applies coloring based on the `success` theme color.
-     * * `warning`&mdash; Applies coloring based on the `warning` theme color.
-     * * `error`&mdash; Applies coloring based on the `error` theme color.
-     * * `dark`&mdash; Applies coloring based on the `dark` theme color.
-     * * `light`&mdash; Applies coloring based on the `light` theme color.
-     * * `inverse`&mdash; Applies coloring based on the `inverse` theme color.
-     * * `none`&mdash; Removes the built in theme color.
+     * @default 'base'
      */
     themeColor: ButtonThemeColor;
     /**
-     * When set to `true`, disables a SplitButton item
-     * ([see example]({% slug databinding_splitbutton %}#toc-arrays-of-complex-data)).
+     * Disables the SplitButton when set to `true` ([see example]({% slug databinding_splitbutton %}#arrays-of-complex-data)).
      */
     set disabled(value: boolean);
     get disabled(): boolean;
     /**
-     * Configures the popup of the SplitButton.
-     *
-     * The available options are:
-     * - `animate: Boolean`&mdash;Controls the popup animation. By default, the open and close animations are enabled.
-     * - `popupClass: String`&mdash;Specifies a list of CSS classes that are used to style the popup.
-     * - `appendTo: "root" | "component" | ViewContainerRef`&mdash;Specifies the component to which the popup will be appended.
-     * - `align: "left" | "center" | "right"`&mdash;Specifies the alignment of the popup.
+     * Configures the popup settings of the SplitButton.
      */
     set popupSettings(settings: PopupSettings);
     get popupSettings(): PopupSettings;
     /**
-     * Specifies the [`tabIndex`](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/tabindex) of the component.
+     * Specifies the [`tabindex`](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/tabindex) of the component.
      */
     tabIndex: number;
     /**
@@ -168,29 +116,25 @@ export declare class SplitButtonComponent extends ListButton implements AfterVie
      */
     textField: string;
     /**
-     * Sets the data of the SplitButton.
-     *
-     * > The data has to be provided in an array-like list.
+     * Sets the data for the SplitButton. Provide the data as an array-like list.
      */
     set data(data: any);
     get data(): any;
     /**
-     * The CSS classes that will be rendered on the button which opens the popup.
-     * Supports the type of values that are supported by [`ngClass`](link:site.data.urls.angular['ngclassapi']).
+     * Specifies the CSS classes for the button that opens the popup.
+     * Supports values compatible with [`ngClass`](link:site.data.urls.angular['ngclassapi']).
      */
     arrowButtonClass: any;
     /**
-     * Specifies the name of the [font icon](slug:icons#icons-list) that will
-     * be rendered for the button which opens the popup.
+     * Specifies the name of the font icon displayed on the button that opens the popup.
      */
     arrowButtonIcon: string;
     /**
-     * Specifies the [`SVGIcon`](slug:api_icons_svgicon) that will
-     * be rendered for the button which opens the popup.
+     * Specifies the [`SVGIcon`](slug:api_icons_svgiconcomponent) displayed on the button that opens the popup.
      */
     arrowButtonSvgIcon: SVGIcon;
     /**
-     * Sets attributes to the main button.
+     * Sets attributes for the main button.
      */
     set buttonAttributes(buttonAttributes: {
         [key: string]: string;
@@ -199,75 +143,31 @@ export declare class SplitButtonComponent extends ListButton implements AfterVie
         [key: string]: string;
     };
     /**
-     * Fires each time the user clicks the main button.
-     *
-     * @example
-     * ```ts
-     * _@Component({
-     *    selector: 'my-app',
-     *    template: `
-     *        <kendo-splitbutton (buttonClick)="onSplitButtonClick()" [data]="data">
-     *            Reply
-     *        </kendo-splitbutton>
-     *    `
-     * })
-     * class AppComponent {
-     *    public data: Array<any> = ['Reply All', 'Forward', 'Reply & Delete'];
-     *
-     *    public onSplitButtonClick(): void {
-     *      console.log('SplitButton click');
-     *    }
-     * }
-     * ```
-     *
+     * Emits an event when the main button is clicked.
      */
     buttonClick: EventEmitter<any>;
     /**
-     * Fires each time the user clicks on the drop-down list. The event data contains the data item bound to the clicked list item.
-     *
-     * @example
-     * ```ts
-     * _@Component({
-     *     selector: 'my-app',
-     *    template: `
-     *        <kendo-splitbutton (itemClick)="onSplitButtonItemClick($event)" [data]="data">
-     *          Reply
-     *      </kendo-splitbutton>
-     *    `
-     * })
-     * class AppComponent {
-     *    public data: Array<any> = ['Reply All', 'Forward', 'Reply & Delete'];
-     *
-     *   public onSplitButtonItemClick(dataItem?: string): void {
-     *        if (dataItem) {
-     *            console.log(dataItem);
-     *       }
-     *    }
-     * }
-     * ```
-     *
+     * Emits an event when an item in the drop-down list is clicked. The event data contains the clicked item's data.
      */
     itemClick: EventEmitter<any>;
     /**
-     * Fires each time the SplitButton gets focused.
+     * Emits an event when the SplitButton gains focus.
      */
     onFocus: EventEmitter<any>;
     /**
-     * Fires each time the SplitButton gets blurred.
+     * Emits an event when the SplitButton is blurred.
      */
     onBlur: EventEmitter<any>;
     /**
-     * Fires each time the popup is about to open.
-     * This event is preventable. If you cancel the event, the popup will remain closed.
+     * Emits an event before the popup opens. This event is preventable.
      */
     open: EventEmitter<PreventableEvent>;
     /**
-     * Fires each time the popup is about to close.
-     * This event is preventable. If you cancel the event, the popup will remain open.
+     * Emits an event before the popup closes. This event is preventable.
      */
     close: EventEmitter<PreventableEvent>;
     /**
-     * An item template that helps to customize the item content.
+     * Specifies a template to customize the content of the items in the drop-down list.
      */
     itemTemplate: ButtonItemTemplateDirective;
     activeArrow: boolean;

package/splitbutton/splitbutton.module.d.ts

@@ -8,8 +8,9 @@ import * as i2 from "./localization/custom-messages.component";
 import * as i3 from "@progress/kendo-angular-common";
 import * as i4 from "../listbutton/button-item-template.directive";
 /**
+ * Represents the exported package module.
  *
- * The exported package module.
+ * Required for adding SplitButton features in NgModule-based Angular applications.
  *
  * The package exports:
  * - `SplitButtonComponent`—The SplitButton component class.