@progress/kendo-angular-buttons 23.0.0-develop.6 → 23.0.0-develop.8

package/index.d.ts

@@ -44,6 +44,9 @@ export { SpeechToTextResultEvent } from './speechtotextbutton/models/result-even
 export { SpeechToTextErrorEvent } from './speechtotextbutton/models/error-event';
 export { SpeechToTextButtonSettings } from './speechtotextbutton/models/speechtotextbutton-settings';
 export { SpeechToTextButtonModule } from './speechtotextbutton/speechtotextbutton.module';
+export { SmartPasteButtonComponent } from './smartpastebutton/smartpastebutton.component';
+export { SmartPasteButtonModule } from './smartpastebutton/smartpastebutton.module';
+export { SmartPasteFormField, SmartPasteType, SmartPasteAIRequestData, SmartPasteAIResponse, SmartPasteAIRequestOptions, SmartPasteRequestStartEvent, SmartPasteRequestEndEvent } from './smartpastebutton/models';
 export { ButtonSize, ChipSize, ButtonRounded, ChipRounded, ButtonFillMode, ChipFillMode, ButtonThemeColor, ChipThemeColor, ArrowIconSettings } from './common/models';
 export { FocusableDirective } from './focusable/focusable.directive';
 export { PreventableEvent } from './preventable-event';

package/package-metadata.mjs

@@ -7,7 +7,7 @@ export const packageMetadata = {
   "productCodes": [
     "KENDOUIANGULAR"
   ],
-  "publishDate": 1770369243,
-  "version": "23.0.0-develop.6",
+  "publishDate": 1770381103,
+  "version": "23.0.0-develop.8",
   "licensingDocsUrl": "https://www.telerik.com/kendo-angular-ui/my-license/"
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@progress/kendo-angular-buttons",
-  "version": "23.0.0-develop.6",
+  "version": "23.0.0-develop.8",
   "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": 1770369243,
+      "publishDate": 1770381103,
       "licensingDocsUrl": "https://www.telerik.com/kendo-angular-ui/my-license/"
     }
   },
@@ -31,15 +31,16 @@
     "@angular/core": "19 - 21",
     "@angular/platform-browser": "19 - 21",
     "@progress/kendo-licensing": "^1.10.0",
-    "@progress/kendo-angular-common": "23.0.0-develop.6",
-    "@progress/kendo-angular-l10n": "23.0.0-develop.6",
-    "@progress/kendo-angular-popup": "23.0.0-develop.6",
-    "@progress/kendo-angular-icons": "23.0.0-develop.6",
+    "@progress/kendo-angular-common": "23.0.0-develop.8",
+    "@progress/kendo-angular-l10n": "23.0.0-develop.8",
+    "@progress/kendo-angular-popup": "23.0.0-develop.8",
+    "@progress/kendo-angular-icons": "23.0.0-develop.8",
+    "@progress/kendo-smartpaste-common": "0.0.0-PLACEHOLDER",
     "rxjs": "^6.5.3 || ^7.0.0"
   },
   "dependencies": {
     "tslib": "^2.3.1",
-    "@progress/kendo-angular-schematics": "23.0.0-develop.6",
+    "@progress/kendo-angular-schematics": "23.0.0-develop.8",
     "@progress/kendo-common": "^1.0.1",
     "@progress/kendo-webspeech-common": "1.0.1"
   },

package/smartpastebutton/models/form-field.d.ts

@@ -0,0 +1,40 @@
+/**-----------------------------------------------------------------------------------------
+* Copyright © 2026 Progress Software Corporation. All rights reserved.
+* Licensed under commercial license. See LICENSE.md in the project root for more information
+*-------------------------------------------------------------------------------------------*/
+/**
+ * Represents a form field configuration for Smart Paste.
+ */
+export interface SmartPasteFormField {
+    /**
+     * Sets the name or identifier of the form field.
+     */
+    field: string;
+    /**
+     * Sets the data type of the form field.
+     */
+    type: SmartPasteType;
+    /**
+     * Sets the description of the form field.
+     * Helps the AI understand the purpose and expected content of the field.
+     */
+    description: string;
+    /**
+     * Sets the allowed values for enum-type fields.
+     * Use this for fields with a fixed set of options like select or radio buttons.
+     */
+    allowedValues?: string[];
+}
+/**
+ * @hidden
+ */
+export interface SmartPasteFormFieldInternal extends SmartPasteFormField {
+    /**
+     * The DOM element associated with the form field.
+     */
+    element: Element | HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement;
+}
+/**
+ * Defines the data type for a Smart Paste form field.
+ */
+export type SmartPasteType = 'string' | 'boolean' | 'number' | 'fixed-choices' | 'kendo-input';

package/smartpastebutton/models/index.d.ts

@@ -0,0 +1,6 @@
+/**-----------------------------------------------------------------------------------------
+* Copyright © 2026 Progress Software Corporation. All rights reserved.
+* Licensed under commercial license. See LICENSE.md in the project root for more information
+*-------------------------------------------------------------------------------------------*/
+export * from './form-field';
+export * from './service-settings';

package/smartpastebutton/models/service-settings.d.ts

@@ -0,0 +1,108 @@
+/**-----------------------------------------------------------------------------------------
+* Copyright © 2026 Progress Software Corporation. All rights reserved.
+* Licensed under commercial license. See LICENSE.md in the project root for more information
+*-------------------------------------------------------------------------------------------*/
+import { HttpHeaders, HttpResponse } from "@angular/common/http";
+import { PreventableEvent } from "@progress/kendo-angular-common";
+import { SmartPasteFormField } from "./form-field";
+/**
+ * Defines the data structure for the HTTP request body sent by Smart Paste.
+ */
+export interface SmartPasteAIRequestData {
+    /**
+     * Sets the form fields to send to the AI service.
+     */
+    formFields: Array<SmartPasteFormField>;
+    /**
+     * Sets the content to be sent to the AI service.
+     */
+    content: string;
+    /**
+     * Sets the URL of the AI service endpoint.
+     */
+    url?: string;
+    /**
+     * Sets the request options for the AI service.
+     * Includes headers, HTTP method, and other configurations.
+     */
+    requestOptions: {
+        role?: string;
+        headers?: HttpHeaders;
+        method?: string;
+        withCredentials?: boolean;
+        body?: any;
+        responseType?: 'json' | 'arraybuffer' | 'blob' | 'text';
+        [key: string]: any;
+    };
+}
+/**
+ * @hidden
+ *
+ * Represents the response from the AI request in the Smart Paste Button.
+ */
+export interface SmartPasteAIResponse {
+    /**
+     * A record mapping form field names to their parsed values. The id of each field corresponds to the `field` property in `SmartPasteFormField`.
+     */
+    fieldValues: Record<string, unknown>;
+}
+/**
+ * Defines configuration options for the HTTP request sent to the AI service.
+ */
+export interface SmartPasteAIRequestOptions {
+    /**
+     * Sets the HTTP headers to include with the request.
+     */
+    headers?: HttpHeaders;
+    /**
+     * Sets the role of the user making the request.
+     *
+     * @default 'user'
+     */
+    role?: string;
+    /**
+     * Sets the HTTP method for the request.
+     *
+     * @default 'POST'
+     */
+    method?: string;
+    /**
+     * Includes credentials such as cookies and authorization headers with the request.
+     *
+     * @default false
+     */
+    withCredentials?: boolean;
+    /**
+     * Sets the expected response type from the AI service.
+     *
+     * @default 'json'
+     */
+    responseType?: 'json' | 'arraybuffer' | 'blob' | 'text';
+    /**
+     * Sets the body of the request.
+     */
+    body?: any;
+    /**
+     * Sets additional custom options to spread into the request configuration.
+     */
+    [key: string]: any;
+}
+/**
+ * @hidden
+ */
+export declare const DEFAULT_AI_REQUEST_OPTIONS: SmartPasteAIRequestOptions;
+export declare class SmartPasteRequestStartEvent extends PreventableEvent {
+    /**
+     * Gets the request data to send to the AI service.
+     */
+    requestData: SmartPasteAIRequestData;
+    constructor(requestData: SmartPasteAIRequestData);
+}
+export declare class SmartPasteRequestEndEvent extends PreventableEvent {
+    /**
+     * Gets the HTTP response from the AI service.
+     * Contains an error object when the request fails.
+     */
+    response: HttpResponse<any>;
+    constructor(response: HttpResponse<any>);
+}

package/smartpastebutton/smartpastebutton.component.d.ts

@@ -0,0 +1,175 @@
+/**-----------------------------------------------------------------------------------------
+* Copyright © 2026 Progress Software Corporation. All rights reserved.
+* Licensed under commercial license. See LICENSE.md in the project root for more information
+*-------------------------------------------------------------------------------------------*/
+import { ElementRef, OnDestroy, OnInit, Renderer2, NgZone, EventEmitter } from '@angular/core';
+import { HttpClient } from '@angular/common/http';
+import { Subscription } from 'rxjs';
+import { ControlContainer } from '@angular/forms';
+import { SmartPasteAIRequestOptions, SmartPasteFormField, SmartPasteRequestStartEvent, SmartPasteRequestEndEvent } from './models';
+import { LocalizationService } from '@progress/kendo-angular-l10n';
+import { SVGIcon } from '@progress/kendo-svg-icons';
+import { ButtonFillMode, ButtonRounded, ButtonSize, ButtonThemeColor } from '../common/models';
+import { SmartPasteField } from '@progress/kendo-smartpaste-common';
+import * as i0 from "@angular/core";
+/**
+ * Represents the Kendo UI SmartPasteButton component for Angular.
+ *
+ * Fills form fields with AI-powered data extraction from clipboard content.
+ */
+export declare class SmartPasteButtonComponent implements OnInit, OnDestroy {
+    renderer: Renderer2;
+    ngZone: NgZone;
+    private http;
+    private controlContainer;
+    /**
+     * Specifies the form controls to include in Smart Paste.
+     * When not set, all form controls are included.
+     *
+     * @default null
+     */
+    formFields: SmartPasteFormField[] | null;
+    /**
+     * When `true`, disables the SmartPasteButton and prevents user interaction.
+     *
+     * @default false
+     */
+    set disabled(disabled: boolean);
+    get disabled(): boolean;
+    /**
+     * Sets the padding of the SmartPasteButton.
+     *
+     * @default undefined
+     */
+    set size(size: ButtonSize);
+    get size(): ButtonSize;
+    /**
+     * Sets the border radius of the SmartPasteButton.
+     *
+     * @default undefined
+     */
+    set rounded(rounded: ButtonRounded);
+    get rounded(): ButtonRounded;
+    /**
+     * Sets the background and border styles of the SmartPasteButton.
+     *
+     * @default undefined
+     */
+    set fillMode(fillMode: ButtonFillMode);
+    get fillMode(): ButtonFillMode;
+    /**
+     * Sets a predefined theme color for the SmartPasteButton.
+     * The theme color applies as a background and border color and adjusts the text color.
+     *
+     * @default undefined
+     */
+    set themeColor(themeColor: ButtonThemeColor);
+    get themeColor(): ButtonThemeColor;
+    /**
+     * Sets an SVG icon to display inside the SmartPasteButton.
+     */
+    set svgIcon(icon: SVGIcon);
+    get svgIcon(): SVGIcon;
+    /**
+     * Specifies a URL for an `img` element inside the SmartPasteButton.
+     * The URL can be relative or absolute. When relative, the browser evaluates it relative to the web page URL.
+     */
+    imageUrl: string;
+    /**
+     * Defines one or more CSS classes separated by spaces for a `span` element inside the SmartPasteButton.
+     * Use `iconClass` to add custom icons.
+     */
+    set iconClass(value: string);
+    get iconClass(): string;
+    /**
+     * Specifies the icon name to display in the SmartPasteButton.
+     *
+     * @default 'paste-sparkle'
+     */
+    set icon(name: string);
+    get icon(): string;
+    /**
+     * Sets the URL to which Smart Paste sends the AI request.
+     * When set, the component sends and handles an HTTP request automatically. Handle the `requestStart` event to modify request options before sending.
+     * When not set, the component does not send an HTTP request. Handle the `requestStart` event to send and manage a custom HTTP request.
+     */
+    requestUrl?: string;
+    /**
+     * Configures the HTTP request options for the AI request.
+     * Use this to customize headers, method, credentials, and other request settings.
+     */
+    requestOptions?: SmartPasteAIRequestOptions;
+    /**
+     * Sets static form field metadata to bypass DOM extraction when Smart Paste runs.
+     * Use this when you want to provide form field configuration directly instead of extracting it from the DOM.
+     *
+     * @default null
+     */
+    smartPasteFormFields: SmartPasteField[] | null;
+    /**
+     * Fires when the Smart Paste request is about to start.
+     * Prevent the event to stop the request before sending it.
+     */
+    requestStart: EventEmitter<SmartPasteRequestStartEvent>;
+    /**
+     * Fires when the Smart Paste request completes, either successfully or with an error.
+     * Prevent the event to cancel populating the form fields with the response data.
+     */
+    requestEnd: EventEmitter<SmartPasteRequestEndEvent>;
+    /**
+     * Fires when the user cancels an ongoing Smart Paste request.
+     */
+    requestCancel: EventEmitter<void>;
+    get iconButtonClass(): boolean;
+    classButton: boolean;
+    get classDisabled(): boolean;
+    get getDirection(): string;
+    onFocus(): void;
+    onBlur(): void;
+    /**
+     * Focuses the SmartPasteButton.
+     */
+    focus(): void;
+    /**
+     * Removes focus from the SmartPasteButton.
+     */
+    blur(): void;
+    get hasText(): boolean;
+    set isFocused(isFocused: boolean);
+    get isFocused(): boolean;
+    element: HTMLElement;
+    isDisabled: boolean;
+    subs: Subscription;
+    private _size;
+    private _rounded;
+    private _fillMode;
+    private _themeColor;
+    private _focused;
+    private direction;
+    private _iconClass;
+    private _icon;
+    private _svgIcon;
+    private kendoSmartPaste;
+    private smartPasteBusy;
+    private currentRequestSubscription;
+    private nativeForm;
+    constructor(elementRef: ElementRef, renderer: Renderer2, localization: LocalizationService, ngZone: NgZone, http: HttpClient, controlContainer: ControlContainer);
+    ngOnInit(): void;
+    ngOnDestroy(): void;
+    /**
+     * Starts the Smart Paste operation.
+     * Reads clipboard content and sends it to the AI service for processing.
+     */
+    paste(): Promise<void>;
+    private sendSmartPasteRequest;
+    private unsubscribeCurrentRequest;
+    private defaultGetSmartPasteField;
+    private defaultSetKendoInputValue;
+    private setControlValue;
+    private extractFormFields;
+    private handleClasses;
+    private handleThemeColor;
+    private handleSmartPasteRequest;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SmartPasteButtonComponent, [null, null, null, null, null, { optional: true; skipSelf: true; }]>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SmartPasteButtonComponent, "button[kendoSmartPasteButton]", ["kendoSmartPasteButton"], { "formFields": { "alias": "formFields"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "size": { "alias": "size"; "required": false; }; "rounded": { "alias": "rounded"; "required": false; }; "fillMode": { "alias": "fillMode"; "required": false; }; "themeColor": { "alias": "themeColor"; "required": false; }; "svgIcon": { "alias": "svgIcon"; "required": false; }; "imageUrl": { "alias": "imageUrl"; "required": false; }; "iconClass": { "alias": "iconClass"; "required": false; }; "icon": { "alias": "icon"; "required": false; }; "requestUrl": { "alias": "requestUrl"; "required": false; }; "requestOptions": { "alias": "requestOptions"; "required": false; }; "smartPasteFormFields": { "alias": "smartPasteFormFields"; "required": false; }; }, { "requestStart": "requestStart"; "requestEnd": "requestEnd"; "requestCancel": "requestCancel"; }, never, ["*"], true, never>;
+}

package/smartpastebutton/smartpastebutton.module.d.ts

@@ -0,0 +1,27 @@
+/**-----------------------------------------------------------------------------------------
+* Copyright © 2026 Progress Software Corporation. All rights reserved.
+* Licensed under commercial license. See LICENSE.md in the project root for more information
+*-------------------------------------------------------------------------------------------*/
+import * as i0 from "@angular/core";
+import * as i1 from "./smartpastebutton.component";
+/**
+ * Represents the [NgModule](link:site.data.urls.angular['ngmoduleapi'])
+ * definition for the SmartPasteButton component.
+ *
+ * The module is meant for backward compatibility. For new applications, use the standalone SmartPasteButton component.
+ *
+ * @example
+ * ```ts-no-run
+ * import { SmartPasteButtonModule } from '@progress/kendo-angular-buttons';
+ *
+ * _@NgModule({
+ *     imports: [SmartPasteButtonModule]
+ * })
+ * export class AppModule {}
+ * ```
+ */
+export declare class SmartPasteButtonModule {
+    static ɵfac: i0.ɵɵFactoryDeclaration<SmartPasteButtonModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<SmartPasteButtonModule, never, [typeof i1.SmartPasteButtonComponent], [typeof i1.SmartPasteButtonComponent]>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<SmartPasteButtonModule>;
+}

package/smartpastebutton/utils.d.ts

@@ -0,0 +1,50 @@
+/**-----------------------------------------------------------------------------------------
+* Copyright © 2026 Progress Software Corporation. All rights reserved.
+* Licensed under commercial license. See LICENSE.md in the project root for more information
+*-------------------------------------------------------------------------------------------*/
+import { SmartPasteCustomInput } from "@progress/kendo-smartpaste-common";
+import { HttpClient, HttpResponse } from "@angular/common/http";
+import { Observable } from "rxjs";
+import { SmartPasteAIResponse } from './models';
+/**
+ * Checks if a field should be ignored during Smart Paste.
+ *
+ * @hidden
+ */
+export declare function isFieldIgnored(element: Element | HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement): boolean;
+/**
+ * @hidden
+ */
+export declare const getElementIdentifier: (element: HTMLElement) => string | null;
+/**
+ * Specifies custom inputs (Kendo components) to include in Smart Paste.
+ * Each custom input has an identifier used to detect the component.
+ * Defaults to common Kendo UI components (DropDownList, ComboBox, AutoComplete, MultiSelect, DatePicker, etc.).
+ *
+ * @hidden
+ */
+export declare const customInputs: SmartPasteCustomInput[];
+/**
+ * @hidden
+ */
+export declare const requiresDateValue: (element: HTMLElement) => boolean;
+/**
+ * @hidden
+ */
+export declare const requiresBooleanValue: (element: HTMLElement) => boolean;
+/**
+ * @hidden
+ */
+export declare const requiresNumericValue: (element: HTMLElement) => boolean;
+/**
+ * @hidden
+ */
+export declare const populateCustomInputs: (element: HTMLElement, value: any) => any;
+/**
+ * @hidden
+ */
+export declare const readClipboard: () => Promise<string>;
+/**
+ * @hidden
+ */
+export declare const sendSmartPasteRequest: (http: HttpClient, requestData: any) => Observable<HttpResponse<SmartPasteAIResponse>>;