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

package/esm2022/package-metadata.mjs

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

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

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

package/esm2022/splitbutton/localization/messages.mjs

@@ -10,25 +10,24 @@ import * as i0 from "@angular/core";
  */
 export 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;
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "16.2.12", ngImport: i0, type: Messages, deps: null, target: i0.ɵɵFactoryTarget.Directive });

package/esm2022/splitbutton/splitbutton.component.mjs

@@ -40,39 +40,27 @@ const DEFAULT_FILL_MODE = 'solid';
  *
  * @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);
- *       }
- *   }
  * }
  * ```
  */
@@ -80,53 +68,39 @@ export class SplitButtonComponent extends ListButton {
     localization;
     renderer;
     /**
-     * Sets the text of the SplitButton.
+     * Sets the text displayed within the SplitButton.
      */
     text = '';
     /**
-     * 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 = '';
     /**
-     * Defines an SVGIcon to be rendered next to the button text.
+     * Specifies an `SVGIcon` to display next to the button text.
      */
     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;
     /**
-     * Defines the type attribute of the main button
+     * Specifies the `type` attribute of the main button.
      */
     type = 'button';
     /**
-     * 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 = '';
     /**
-     * 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 = 'medium';
     /**
-     * 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) {
         const newRounded = rounded ? rounded : DEFAULT_ROUNDED;
@@ -137,14 +111,9 @@ export class SplitButtonComponent extends ListButton {
         return this._rounded;
     }
     /**
-     * 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) {
         const newFillMode = fillMode ? fillMode : DEFAULT_FILL_MODE;
@@ -154,28 +123,13 @@ export class SplitButtonComponent extends ListButton {
         return this._fillMode;
     }
     /**
-     * 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 = 'base';
     /**
-     * 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) {
         if (this.isOpen) {
@@ -187,13 +141,7 @@ export class SplitButtonComponent extends ListButton {
         return this._disabled;
     }
     /**
-     * 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) {
         this._popupSettings = Object.assign({ animate: true, popupClass: '' }, settings);
@@ -202,7 +150,7 @@ export class SplitButtonComponent extends ListButton {
         return this._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 = 0;
     /**
@@ -210,9 +158,7 @@ export class SplitButtonComponent extends ListButton {
      */
     textField;
     /**
-     * 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) {
         this._data = data || [];
@@ -224,22 +170,20 @@ export class SplitButtonComponent extends ListButton {
         return this._data;
     }
     /**
-     * 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;
     /**
-     * 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 = 'caret-alt-down';
     /**
-     * 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 = caretAltDownIcon;
     /**
-     * Sets attributes to the main button.
+     * Sets attributes for the main button.
      */
     set buttonAttributes(buttonAttributes) {
         const newButtonAttributes = buttonAttributes ? buttonAttributes : null;
@@ -250,75 +194,31 @@ export class SplitButtonComponent extends ListButton {
         return this._buttonAttributes;
     }
     /**
-     * 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 = new EventEmitter();
     /**
-     * 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 = new EventEmitter();
     /**
-     * Fires each time the SplitButton gets focused.
+     * Emits an event when the SplitButton gains focus.
      */
     onFocus = new EventEmitter();
     /**
-     * Fires each time the SplitButton gets blurred.
+     * Emits an event when the SplitButton is blurred.
      */
     onBlur = new EventEmitter();
     /**
-     * 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 = new EventEmitter();
     /**
-     * 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 = new EventEmitter();
     /**
-     * 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;
     activeArrow = false;

package/esm2022/splitbutton/splitbutton.module.mjs

@@ -12,10 +12,11 @@ import * as i1 from "./splitbutton.component";
 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";
-//IMPORTANT: NgModule export kept for backwards compatibility
+// IMPORTANT: NgModule export kept for backwards compatibility.
 /**
+ * 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.