@progress/kendo-angular-buttons 19.2.1-develop.4 → 19.3.0-develop.1

package/index.d.ts

@@ -35,6 +35,11 @@ export { DialItemAnimation } from './floatingactionbutton/models/item-animation.
 export { FabAlign } from './floatingactionbutton/models/align';
 export { FabPositionMode } from './floatingactionbutton/models/position-mode';
 export { FabOffset } from './floatingactionbutton/models/offset';
+export { SpeechToTextButtonComponent } from './speechtotextbutton/speechtotextbutton.component';
+export { IntegrationMode } from './speechtotextbutton/models/integration-mode';
+export { SpeechToTextResultEvent } from './speechtotextbutton/models/result-event';
+export { SpeechToTextErrorEvent } from './speechtotextbutton/models/error-event';
+export { SpeechToTextButtonModule } from './speechtotextbutton/speechtotextbutton.module';
 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.json

@@ -1,6 +1,6 @@
 {
   "name": "@progress/kendo-angular-buttons",
-  "version": "19.2.1-develop.4",
+  "version": "19.3.0-develop.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": 1751639440,
+      "publishDate": 1751896251,
       "licensingDocsUrl": "https://www.telerik.com/kendo-angular-ui/my-license/"
     }
   },
@@ -31,16 +31,17 @@
     "@angular/core": "16 - 20",
     "@angular/platform-browser": "16 - 20",
     "@progress/kendo-licensing": "^1.5.0",
-    "@progress/kendo-angular-common": "19.2.1-develop.4",
-    "@progress/kendo-angular-l10n": "19.2.1-develop.4",
-    "@progress/kendo-angular-popup": "19.2.1-develop.4",
-    "@progress/kendo-angular-icons": "19.2.1-develop.4",
+    "@progress/kendo-angular-common": "19.3.0-develop.1",
+    "@progress/kendo-angular-l10n": "19.3.0-develop.1",
+    "@progress/kendo-angular-popup": "19.3.0-develop.1",
+    "@progress/kendo-angular-icons": "19.3.0-develop.1",
     "rxjs": "^6.5.3 || ^7.0.0"
   },
   "dependencies": {
     "tslib": "^2.3.1",
-    "@progress/kendo-angular-schematics": "19.2.1-develop.4",
-    "@progress/kendo-common": "^1.0.1"
+    "@progress/kendo-angular-schematics": "19.3.0-develop.1",
+    "@progress/kendo-common": "^1.0.1",
+    "@progress/kendo-webspeech-common": "1.0.0"
   },
   "schematics": "./schematics/collection.json",
   "module": "fesm2022/progress-kendo-angular-buttons.mjs",

package/speechtotextbutton/models/error-event.d.ts

@@ -0,0 +1,13 @@
+/**-----------------------------------------------------------------------------------------
+* Copyright © 2025 Progress Software Corporation. All rights reserved.
+* Licensed under commercial license. See LICENSE.md in the project root for more information
+*-------------------------------------------------------------------------------------------*/
+/**
+ * Arguments for the `error` event of the `SpeechToTextButton`.
+ */
+export interface SpeechToTextErrorEvent {
+    /**
+     * Message detailing the cause of the speech recognition error. Use this message for debugging or user feedback.
+     */
+    errorMessage: string;
+}

package/speechtotextbutton/models/integration-mode.d.ts

@@ -0,0 +1,11 @@
+/**-----------------------------------------------------------------------------------------
+* Copyright © 2025 Progress Software Corporation. All rights reserved.
+* Licensed under commercial license. See LICENSE.md in the project root for more information
+*-------------------------------------------------------------------------------------------*/
+/**
+ * Specifies the speech recognition engine or integration the component will use. The possible values are:
+ *
+ * * `webSpeech`—Uses the browser's native Web Speech API to perform speech recognition. This is the default mode when available and supported by the browser.
+ * * `none`—Disables built-in speech recognition. Use this when integrating with a custom or third-party speech recognition service.
+ */
+export type IntegrationMode = 'webSpeech' | 'none';

package/speechtotextbutton/models/result-event.d.ts

@@ -0,0 +1,18 @@
+/**-----------------------------------------------------------------------------------------
+* Copyright © 2025 Progress Software Corporation. All rights reserved.
+* Licensed under commercial license. See LICENSE.md in the project root for more information
+*-------------------------------------------------------------------------------------------*/
+/**
+ * Arguments for the `result` event of the `SpeechToTextButton`.
+ */
+export interface SpeechToTextResultEvent {
+    /**
+     * Indicates whether the speech recognition result is final (true) or interim (false).
+     */
+    isFinal: boolean;
+    /**
+     * An array of possible recognition alternatives returned by the speech engine.
+     * Each alternative contains a transcript of the recognized speech and a confidence score (see [SpeechRecognitionAlternative](https://developer.mozilla.org/en-US/docs/Web/API/SpeechRecognitionAlternative)).
+     */
+    alternatives: SpeechRecognitionAlternative[];
+}

package/speechtotextbutton/speechtotextbutton.component.d.ts

@@ -0,0 +1,199 @@
+/**-----------------------------------------------------------------------------------------
+* Copyright © 2025 Progress Software Corporation. All rights reserved.
+* Licensed under commercial license. See LICENSE.md in the project root for more information
+*-------------------------------------------------------------------------------------------*/
+import { ElementRef, EventEmitter, NgZone, OnDestroy, OnInit, Renderer2 } from '@angular/core';
+import { Subscription } from 'rxjs';
+import { SVGIcon } from '@progress/kendo-svg-icons';
+import { LocalizationService } from '@progress/kendo-angular-l10n';
+import { IntegrationMode } from './models/integration-mode';
+import { SpeechToTextResultEvent } from './models/result-event';
+import { SpeechToTextErrorEvent } from './models/error-event';
+import { ButtonFillMode, ButtonRounded, ButtonSize, ButtonThemeColor } from '../common/models';
+import * as i0 from "@angular/core";
+/**
+ * Represents the Kendo UI SpeechToTextButton component for Angular.
+ *
+ * @example
+ * ```html
+ * <button kendoSpeechToTextButton></button>
+ * ```
+ */
+export declare class SpeechToTextButtonComponent implements OnInit, OnDestroy {
+    renderer: Renderer2;
+    ngZone: NgZone;
+    /**
+     * When `true`, disables the SpeechToTextButton and prevents user interaction.
+     *
+     * @default false
+     */
+    set disabled(disabled: boolean);
+    get disabled(): boolean;
+    /**
+     * Sets the padding of the SpeechToTextButton.
+     *
+     * @default 'medium'
+     */
+    set size(size: ButtonSize);
+    get size(): ButtonSize;
+    /**
+     * Sets the border radius of the SpeechToTextButton.
+     *
+     * @default 'medium'
+     */
+    set rounded(rounded: ButtonRounded);
+    get rounded(): ButtonRounded;
+    /**
+     * Sets the background and border styles of the SpeechToTextButton.
+     *
+     * @default 'solid'
+     */
+    set fillMode(fillMode: ButtonFillMode);
+    get fillMode(): ButtonFillMode;
+    /**
+     * Sets a predefined theme color for the SpeechToTextButton.
+     * The theme color applies as a background and border color and adjusts the text color.
+     *
+     * @default 'base'
+     */
+    set themeColor(themeColor: ButtonThemeColor);
+    get themeColor(): ButtonThemeColor;
+    /**
+     * Specifies which speech recognition engine or integration the component should use. Allows the component to operate in different environments or use alternative implementations.
+     */
+    integrationMode: IntegrationMode;
+    /**
+     * Specifies a `BCP 47` language tag (e.g., 'en-US', 'bg-BG') used for speech recognition.
+     *
+     * @default 'en-US'
+     */
+    lang: string;
+    /**
+     * Specifies whether continuous results are returned for each recognition, or only a single result once recognition stops.
+     *
+     * @default false
+     */
+    continuous: boolean;
+    /**
+     * Specifies whether interim results should be returned or not. Interim results are results that are not yet final.
+     *
+     * @default false
+     */
+    interimResults: boolean;
+    /**
+     * Represents the maximum number of alternative transcriptions to return for each result.
+     *
+     * @default 1
+     */
+    maxAlternatives: number;
+    /**
+     * Fires when the speech recognition service has begun listening to incoming audio.
+     */
+    start: EventEmitter<any>;
+    /**
+     * Fires when the speech recognition service has disconnected.
+     */
+    end: EventEmitter<any>;
+    /**
+     * Fires when the speech recognition service returns a result - a word or phrase has been positively recognized.
+     */
+    result: EventEmitter<SpeechToTextResultEvent>;
+    /**
+     * Fires when a speech recognition error occurs. The event argument is a string, containing the error message.
+     */
+    error: EventEmitter<SpeechToTextErrorEvent>;
+    /**
+     * Fires when the user clicks the SpeechToTextButton.
+     */
+    click: EventEmitter<any>;
+    get iconButtonClass(): boolean;
+    get listeningClass(): boolean;
+    speechToTextButtonClass: boolean;
+    classButton: boolean;
+    get classDisabled(): boolean;
+    get getDirection(): string;
+    get ariaPressed(): boolean;
+    /**
+     * @hidden
+     */
+    onFocus(): void;
+    /**
+     * @hidden
+     */
+    onBlur(): void;
+    /**
+     * Focuses the SpeechToTextButton component.
+     */
+    focus(): void;
+    /**
+     * Removes focus from the SpeechToTextButton component.
+     */
+    blur(): void;
+    ngOnInit(): void;
+    ngOnChanges(changes: any): void;
+    ngAfterViewInit(): void;
+    ngOnDestroy(): void;
+    constructor(element: ElementRef, renderer: Renderer2, localization: LocalizationService, ngZone: NgZone);
+    /**
+     * Indicates whether the button is actively listening for incoming audio.
+     */
+    isListening: boolean;
+    /**
+     * Indicates whether web speech functionality is supported.
+     */
+    get isWebSpeechSupported(): boolean;
+    set isFocused(isFocused: boolean);
+    get isFocused(): boolean;
+    /**
+     * @hidden
+     */
+    get hasText(): boolean;
+    /**
+     * @hidden
+     */
+    onClick(): void;
+    /**
+     * @hidden
+     */
+    get buttonSvgIcon(): SVGIcon;
+    /**
+     * @hidden
+     */
+    get buttonIcon(): string;
+    /**
+     * @hidden
+     */
+    setAttribute(attribute: string, value: string): void;
+    /**
+     * @hidden
+     */
+    element: HTMLElement;
+    /**
+     * @hidden
+     */
+    isDisabled: boolean;
+    /**
+     * @hidden
+     */
+    subs: Subscription;
+    private microphoneSvgIcon;
+    private stopSvgIcon;
+    private speechRecognition;
+    private _size;
+    private _rounded;
+    private _fillMode;
+    private _themeColor;
+    private _focused;
+    private direction;
+    private handleClasses;
+    private handleStart;
+    private handleEnd;
+    private handleResult;
+    private handleError;
+    private toObservable;
+    private handleThemeColor;
+    private destroyWebSpeech;
+    private createWebSpeech;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SpeechToTextButtonComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SpeechToTextButtonComponent, "button[kendoSpeechToTextButton]", ["kendoSpeechToTextButton"], { "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; }; "integrationMode": { "alias": "integrationMode"; "required": false; }; "lang": { "alias": "lang"; "required": false; }; "continuous": { "alias": "continuous"; "required": false; }; "interimResults": { "alias": "interimResults"; "required": false; }; "maxAlternatives": { "alias": "maxAlternatives"; "required": false; }; }, { "start": "start"; "end": "end"; "result": "result"; "error": "error"; "click": "click"; }, never, ["*"], true, never>;
+}

package/speechtotextbutton/speechtotextbutton.module.d.ts

@@ -0,0 +1,19 @@
+/**-----------------------------------------------------------------------------------------
+* Copyright © 2025 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 "./speechtotextbutton.component";
+/**
+ * Represents the exported package module.
+ *
+ * Required for adding SpeechToTextButton features in NgModule-based Angular applications.
+ *
+ * The package exports:
+ * - `SpeechToTextButtonComponent`—The SpeechToTextButton component class.
+ */
+export declare class SpeechToTextButtonModule {
+    static ɵfac: i0.ɵɵFactoryDeclaration<SpeechToTextButtonModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<SpeechToTextButtonModule, never, [typeof i1.SpeechToTextButtonComponent], [typeof i1.SpeechToTextButtonComponent]>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<SpeechToTextButtonModule>;
+}

package/util.d.ts

@@ -2,6 +2,7 @@
 * Copyright © 2025 Progress Software Corporation. All rights reserved.
 * Licensed under commercial license. See LICENSE.md in the project root for more information
 *-------------------------------------------------------------------------------------------*/
+import { Renderer2 } from "@angular/core";
 import { ButtonStylingClasses } from "./common/models";
 /**
  * @hidden
@@ -39,6 +40,10 @@ export declare const getStylingClasses: (componentType: any, stylingOption: stri
  * Returns the themeColor classes to be added and removed
  */
 export declare const getThemeColorClasses: (componentType: any, prevFillMode: any, fillMode: any, previousValue: any, newValue: any) => ButtonStylingClasses;
+/**
+ * @hidden
+ */
+export declare const toggleClass: (className: string, add: boolean, renderer: Renderer2, element: any) => void;
 /**
  * @hidden
  *