@progress/kendo-react-buttons 13.3.0 → 13.4.0-develop.2

package/ListButton/models/events.d.ts

@@ -0,0 +1,59 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { SplitButton } from './../SplitButton.js';
+import { DropDownButton } from './../DropDownButton.js';
+import { BaseEvent } from '@progress/kendo-react-common';
+export interface SplitButtonFocusEvent extends BaseEvent<SplitButton> {
+}
+export interface SplitButtonBlurEvent extends BaseEvent<SplitButton> {
+}
+export interface SplitButtonClickEvent extends BaseEvent<SplitButton> {
+}
+export interface SplitButtonOpenEvent extends BaseEvent<SplitButton> {
+}
+export interface SplitButtonCloseEvent extends BaseEvent<SplitButton> {
+}
+/**
+ * The arguments for the `itemClick` event.
+ */
+export interface SplitButtonItemClickEvent extends BaseEvent<SplitButton> {
+    /**
+     * The clicked item.
+     */
+    item: any;
+    /**
+     * The zero-based index of the clicked item.
+     */
+    itemIndex: number;
+}
+export interface DropDownButtonFocusEvent extends BaseEvent<DropDownButton> {
+}
+export interface DropDownButtonBlurEvent extends BaseEvent<DropDownButton> {
+}
+/**
+ * @hidden
+ */
+export interface DropDownButtonClickEvent extends BaseEvent<DropDownButton> {
+}
+export interface DropDownButtonOpenEvent extends BaseEvent<DropDownButton> {
+}
+export interface DropDownButtonCloseEvent extends BaseEvent<DropDownButton> {
+}
+/**
+ * The arguments for the `itemClick` event.
+ */
+export interface DropDownButtonItemClickEvent extends BaseEvent<DropDownButton> {
+    /**
+     * The clicked item.
+     */
+    item: any;
+    /**
+     * The zero-based index of the clicked item.
+     */
+    itemIndex: number;
+}

package/ListButton/utils/navigation.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+/**
+ * @hidden
+ */
+declare const navigate: (focusedIndex: number, keyCode: number, altKey: boolean, total: number) => number;
+export { navigate };

package/ListButton/utils/popup.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { Align } from '@progress/kendo-react-popup';
+/**
+ * @hidden
+ */
+export declare function getAnchorAlign(isDirectionRightToLeft?: boolean): Align;
+/**
+ * @hidden
+ */
+export declare function getPopupAlign(isDirectionRightToLeft?: boolean): Align;

package/SpeechToTextButton/SpeechToTextButton.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { default as React } from 'react';
+import { SpeechToTextButtonProps } from './interfaces/SpeechToTextButtonProps.js';
+import { SpeechToTextButtonHandle } from './interfaces/SpeechToTextButtonHandle.js';
+/**
+ * Represents a speech recognition engine that will be used.
+ */
+export declare enum SpeechToTextButtonMode {
+    /**
+     * Uses the [Web Speech API](https://developer.mozilla.org/en-US/docs/Web/API/Web_Speech_API) for speech recognition.
+     */
+    WebSpeech = "webSpeech",
+    /**
+     * Does not use any speech recognition engine. Use when you need to integrate the component with external speech recognition services or APIs.
+     */
+    None = "none"
+}
+/**
+ * Represents the [KendoReact SpeechToTextButton component](https://www.telerik.com/kendo-react-ui/components/buttons/speechtotextbutton).
+ *
+ * @example
+ * ```jsx
+ * const App = () => {
+ *   return (
+ *     <SpeechToTextButton />
+ *   );
+ * };
+ * ```
+ */
+export declare const SpeechToTextButton: React.ForwardRefExoticComponent<SpeechToTextButtonProps & React.RefAttributes<SpeechToTextButtonHandle>>;

package/SpeechToTextButton/SpeechToTextButton.js

@@ -5,4 +5,4 @@
  * Licensed under commercial license. See LICENSE.md in the package root for more information
  *-------------------------------------------------------------------------------------------
  */
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("react"),ee=require("@progress/kendo-webspeech-common"),te=require("../Button.js"),u=require("@progress/kendo-react-common"),M=require("@progress/kendo-svg-icons"),a=require("../messages/index.js"),ne=require("@progress/kendo-react-intl"),I=require("../package-metadata.js"),y=e.forwardRef((r,A)=>{const q=!u.validatePackage(I.packageMetadata,{component:"SpeechToTextButton"}),B=u.getLicenseMessage(I.packageMetadata),h=ne.useLocalization(),{fillMode:E="solid",rounded:L="medium",size:z="medium",themeColor:H="base",ariaLabel:d,svgIcon:S,disabled:N,iconSize:O="medium",title:f,className:F,id:P,style:W,lang:k="en-US",continuous:b=!1,interimResults:v=!1,maxAlternatives:T=1,integrationMode:K="webSpeech",onStart:g,onResult:i,onEnd:m,onError:s,...j}=r,o=e.useRef(null),n=e.useRef(!1),[c,l]=e.useState(!1),U=e.useCallback(async()=>{n.current=!0,l(!0),g&&await g()},[g]),D=e.useCallback(async()=>{n.current=!1,l(!1),m&&await m()},[m]),G=e.useCallback(t=>{const w=t.results,C=w[w.length-1],$=Array.from(C).map(x=>({transcript:x.transcript,confidence:x.confidence}));i==null||i({isFinal:C.isFinal,alternatives:$})},[i]),J=e.useCallback(t=>{l(!1),n.current=!1,s==null||s({errorMessage:t.error})},[s]),Q=()=>{var t;if(typeof window!="undefined"&&!("webkitSpeechRecognition"in window||"SpeechRecognition"in window)){s&&s({errorMessage:"Speech Recognition API is not supported in this browser."});return}(t=o.current)!=null&&t.isActive()&&o.current.stop(),o.current=new ee.KendoSpeechRecognition({lang:k,continuous:b,interimResults:v,maxAlternatives:T,events:{start:U,end:D,result:G,error:J}})},R=e.useCallback(()=>{var t;n.current||(t=o.current)==null||t.start()},[]),p=e.useCallback(()=>{var t;n.current&&((t=o.current)==null||t.stop())},[]),V=e.useCallback(()=>{var t;n.current&&((t=o.current)==null||t.abort(),n.current=!1,l(!1))},[]),X=()=>n.current;e.useImperativeHandle(A,()=>({start:R,stop:p,abort:V,isActive:X})),e.useEffect(()=>(Q(),()=>{n.current&&p()}),[k,b,v,T,K]);const Y=()=>{c?p():R()},Z=r.icon!==void 0||r.iconClass!==void 0,_=e.useMemo(()=>c?M.stopSmIcon:S||M.microphoneOutlineIcon,[c,S]);return e.createElement(e.Fragment,null,e.createElement(te.Button,{id:P,className:u.classNames({"k-speech-to-text-button":!0,"k-listening":c},F),style:W,svgIcon:Z?void 0:_,iconSize:O,fillMode:E,rounded:L,size:z,themeColor:H,"aria-label":d!=null?d:h.toLanguageString(a.speechToTextAriaLabel,a.messages[a.speechToTextAriaLabel]),"aria-pressed":c,disabled:N,title:f!=null?f:h.toLanguageString(a.speechToTextTitle,a.messages[a.speechToTextTitle]),onClick:Y,...j},r.children),q&&e.createElement(u.WatermarkOverlay,{message:B}))});y.displayName="KendoSpeechToTextButton";exports.SpeechToTextButton=y;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("react"),ee=require("@progress/kendo-webspeech-common"),te=require("../Button.js"),u=require("@progress/kendo-react-common"),M=require("@progress/kendo-svg-icons"),a=require("../messages/index.js"),ne=require("@progress/kendo-react-intl"),I=require("../package-metadata.js"),y=e.forwardRef((r,A)=>{const q=!u.validatePackage(I.packageMetadata,{component:"SpeechToTextButton"}),B=u.getLicenseMessage(I.packageMetadata),h=ne.useLocalization(),{fillMode:E,rounded:L,size:z,themeColor:H,ariaLabel:d,svgIcon:S,disabled:N,iconSize:O="medium",title:f,className:F,id:P,style:W,lang:k="en-US",continuous:v=!1,interimResults:b=!1,maxAlternatives:T=1,integrationMode:K="webSpeech",onStart:g,onResult:i,onEnd:m,onError:s,...j}=r,o=e.useRef(null),n=e.useRef(!1),[c,l]=e.useState(!1),U=e.useCallback(async()=>{n.current=!0,l(!0),g&&await g()},[g]),D=e.useCallback(async()=>{n.current=!1,l(!1),m&&await m()},[m]),G=e.useCallback(t=>{const w=t.results,C=w[w.length-1],$=Array.from(C).map(x=>({transcript:x.transcript,confidence:x.confidence}));i==null||i({isFinal:C.isFinal,alternatives:$})},[i]),J=e.useCallback(t=>{l(!1),n.current=!1,s==null||s({errorMessage:t.error})},[s]),Q=()=>{var t;if(typeof window!="undefined"&&!("webkitSpeechRecognition"in window||"SpeechRecognition"in window)){s&&s({errorMessage:"Speech Recognition API is not supported in this browser."});return}(t=o.current)!=null&&t.isActive()&&o.current.stop(),o.current=new ee.KendoSpeechRecognition({lang:k,continuous:v,interimResults:b,maxAlternatives:T,events:{start:U,end:D,result:G,error:J}})},R=e.useCallback(()=>{var t;n.current||(t=o.current)==null||t.start()},[]),p=e.useCallback(()=>{var t;n.current&&((t=o.current)==null||t.stop())},[]),V=e.useCallback(()=>{var t;n.current&&((t=o.current)==null||t.abort(),n.current=!1,l(!1))},[]),X=()=>n.current;e.useImperativeHandle(A,()=>({start:R,stop:p,abort:V,isActive:X})),e.useEffect(()=>(Q(),()=>{n.current&&p()}),[k,v,b,T,K]);const Y=()=>{c?p():R()},Z=r.icon!==void 0||r.iconClass!==void 0,_=e.useMemo(()=>c?M.stopSmIcon:S||M.microphoneOutlineIcon,[c,S]);return e.createElement(e.Fragment,null,e.createElement(te.Button,{id:P,className:u.classNames({"k-speech-to-text-button":!0,"k-listening":c},F),style:W,svgIcon:Z?void 0:_,iconSize:O,fillMode:E,rounded:L,size:z,themeColor:H,"aria-label":d!=null?d:h.toLanguageString(a.speechToTextAriaLabel,a.messages[a.speechToTextAriaLabel]),"aria-pressed":c,disabled:N,title:f!=null?f:h.toLanguageString(a.speechToTextTitle,a.messages[a.speechToTextTitle]),onClick:Y,...j},r.children),q&&e.createElement(u.WatermarkOverlay,{message:B}))});y.displayName="KendoSpeechToTextButton";exports.SpeechToTextButton=y;

package/SpeechToTextButton/SpeechToTextButton.mjs

@@ -8,17 +8,17 @@
 import e from "react";
 import { KendoSpeechRecognition as $ } from "@progress/kendo-webspeech-common";
 import { Button as ee } from "../Button.mjs";
-import { validatePackage as te, getLicenseMessage as ne, classNames as re, WatermarkOverlay as se } from "@progress/kendo-react-common";
-import { stopSmIcon as oe, microphoneOutlineIcon as ae } from "@progress/kendo-svg-icons";
-import { speechToTextAriaLabel as T, messages as x, speechToTextTitle as A } from "../messages/index.mjs";
+import { validatePackage as te, getLicenseMessage as ne, classNames as re, WatermarkOverlay as oe } from "@progress/kendo-react-common";
+import { stopSmIcon as se, microphoneOutlineIcon as ae } from "@progress/kendo-svg-icons";
+import { speechToTextTitle as T, messages as x, speechToTextAriaLabel as A } from "../messages/index.mjs";
 import { useLocalization as ce } from "@progress/kendo-react-intl";
 import { packageMetadata as I } from "../package-metadata.mjs";
 const ie = e.forwardRef((a, M) => {
   const y = !te(I, { component: "SpeechToTextButton" }), E = ne(I), p = ce(), {
-    fillMode: z = "solid",
-    rounded: H = "medium",
-    size: L = "medium",
-    themeColor: B = "base",
+    fillMode: z,
+    rounded: H,
+    size: L,
+    themeColor: B,
     ariaLabel: l,
     svgIcon: g,
     disabled: N,
@@ -30,14 +30,14 @@ const ie = e.forwardRef((a, M) => {
     lang: h = "en-US",
     continuous: S = !1,
     interimResults: v = !1,
-    maxAlternatives: b = 1,
+    maxAlternatives: k = 1,
     integrationMode: W = "webSpeech",
     onStart: f,
     onResult: c,
     onEnd: m,
     onError: r,
     ..._
-  } = a, s = e.useRef(null), n = e.useRef(!1), [o, i] = e.useState(!1), U = e.useCallback(async () => {
+  } = a, o = e.useRef(null), n = e.useRef(!1), [s, i] = e.useState(!1), U = e.useCallback(async () => {
     n.current = !0, i(!0), f && await f();
   }, [f]), j = e.useCallback(async () => {
     n.current = !1, i(!1), m && await m();
@@ -66,11 +66,11 @@ const ie = e.forwardRef((a, M) => {
       r && r({ errorMessage: "Speech Recognition API is not supported in this browser." });
       return;
     }
-    (t = s.current) != null && t.isActive() && s.current.stop(), s.current = new $({
+    (t = o.current) != null && t.isActive() && o.current.stop(), o.current = new $({
       lang: h,
       continuous: S,
       interimResults: v,
-      maxAlternatives: b,
+      maxAlternatives: k,
       events: {
         start: U,
         end: j,
@@ -78,27 +78,27 @@ const ie = e.forwardRef((a, M) => {
         error: D
       }
     });
-  }, k = e.useCallback(() => {
+  }, b = e.useCallback(() => {
     var t;
-    n.current || (t = s.current) == null || t.start();
+    n.current || (t = o.current) == null || t.start();
   }, []), d = e.useCallback(() => {
     var t;
-    n.current && ((t = s.current) == null || t.stop());
+    n.current && ((t = o.current) == null || t.stop());
   }, []), J = e.useCallback(() => {
     var t;
-    n.current && ((t = s.current) == null || t.abort(), n.current = !1, i(!1));
+    n.current && ((t = o.current) == null || t.abort(), n.current = !1, i(!1));
   }, []), Q = () => n.current;
   e.useImperativeHandle(M, () => ({
-    start: k,
+    start: b,
     stop: d,
     abort: J,
     isActive: Q
   })), e.useEffect(() => (G(), () => {
     n.current && d();
-  }), [h, S, v, b, W]);
+  }), [h, S, v, k, W]);
   const V = () => {
-    o ? d() : k();
-  }, X = a.icon !== void 0 || a.iconClass !== void 0, Y = e.useMemo(() => o ? oe : g || ae, [o, g]);
+    s ? d() : b();
+  }, X = a.icon !== void 0 || a.iconClass !== void 0, Y = e.useMemo(() => s ? se : g || ae, [s, g]);
   return /* @__PURE__ */ e.createElement(e.Fragment, null, /* @__PURE__ */ e.createElement(
     ee,
     {
@@ -106,7 +106,7 @@ const ie = e.forwardRef((a, M) => {
       className: re(
         {
           "k-speech-to-text-button": !0,
-          "k-listening": o
+          "k-listening": s
         },
         O
       ),
@@ -117,15 +117,15 @@ const ie = e.forwardRef((a, M) => {
       rounded: H,
       size: L,
       themeColor: B,
-      "aria-label": l != null ? l : p.toLanguageString(T, x[T]),
-      "aria-pressed": o,
+      "aria-label": l != null ? l : p.toLanguageString(A, x[A]),
+      "aria-pressed": s,
       disabled: N,
-      title: u != null ? u : p.toLanguageString(A, x[A]),
+      title: u != null ? u : p.toLanguageString(T, x[T]),
       onClick: V,
       ..._
     },
     a.children
-  ), y && /* @__PURE__ */ e.createElement(se, { message: E }));
+  ), y && /* @__PURE__ */ e.createElement(oe, { message: E }));
 });
 ie.displayName = "KendoSpeechToTextButton";
 export {

package/SpeechToTextButton/interfaces/SpeechToTextButtonHandle.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+/**
+ * The SpeechToTextButton ref.
+ */
+export interface SpeechToTextButtonHandle {
+    /**
+     * The `start` event callback that starts the speech recognition service listening to incoming audio with intent to recognize grammars.
+     */
+    start: () => void;
+    /**
+     * The `stop` event callback that stops the speech recognition service from listening to incoming audio, and attempts to return a result using the audio captured so far.
+     */
+    stop: () => void;
+    /**
+     * The `abort` event callback that stops the speech recognition service from listening to incoming audio, and doesn't attempt to return a result.
+     */
+    abort: () => void;
+    /**
+     * The `isActive` event callback that returns boolean value if the SpeechToTextButton is in active state.
+     */
+    isActive: () => boolean;
+}

package/SpeechToTextButton/interfaces/SpeechToTextButtonProps.d.ts

@@ -0,0 +1,117 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { ButtonProps } from '../../Button.js';
+/**
+ * @hidden
+ */
+type Omit<T, K extends keyof T> = Pick<T, Exclude<keyof T, K>>;
+/**
+ * Represents a single recognition alternative from the speech engine.
+ */
+export interface SpeechRecognitionAlternative {
+    /**
+     * The transcript of the recognized speech.
+     */
+    transcript: string;
+    /**
+     * A confidence score for the transcript, where 0 indicates no confidence and 1 indicates complete confidence.
+     */
+    confidence: number;
+}
+/**
+ * The event argument 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.
+     */
+    alternatives: SpeechRecognitionAlternative[];
+}
+/**
+ * The event argument 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;
+}
+/**
+ * Represents the props of the [KendoReact SpeechToTextButton component](https://www.telerik.com/kendo-react-ui/components/buttons/speechtotextbutton).
+ */
+export interface SpeechToTextButtonProps extends Omit<ButtonProps, 'onError' | 'endIcon' | 'startIcon' | 'selected' | 'imageAlt' | 'imageUrl' | 'togglable'> {
+    /**
+     * The valid BCP 47 language tag to use for speech recognition.
+     *
+     * @default 'en-US'
+     */
+    lang?: string;
+    /**
+     * Specifies whether the speech recognition should continue until explicitly stopped.
+     *
+     * @default false
+     */
+    continuous?: boolean;
+    /**
+     * Specifies whether to return interim results.
+     *
+     * @default false
+     */
+    interimResults?: boolean;
+    /**
+     * Specifies the maximum number of alternative transcriptions to return.
+     *
+     * @default 1
+     */
+    maxAlternatives?: number;
+    /**
+     * Specifies which speech recognition engine or integration the component should use.
+     * This allows the component to operate in different environments or use alternative implementations.
+     */
+    integrationMode?: 'webSpeech' | 'none';
+    /**
+     * The accessible label of the component.
+     */
+    ariaLabel?: string;
+    /**
+     * Specifies if the SpeechToTextButton is disabled ([see example](https://www.telerik.com/kendo-react-ui/components/buttons/speechtotextbutton/disabled-state)).
+     *
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * Sets additional classes to the SpeechToTextButton ([see example](https://www.telerik.com/kendo-react-ui/components/buttons/speechtotextbutton/appearance#custom-styling)).
+     */
+    className?: string;
+    /**
+     * Sets additional CSS styles to the SpeechToTextButton ([see example](https://www.telerik.com/kendo-react-ui/components/buttons/speechtotextbutton/appearance#custom-styling)).
+     */
+    style?: React.CSSProperties;
+    /**
+     * Callback function that is called when speech recognition starts.
+     */
+    onStart?: () => void;
+    /**
+     * Callback function that is called when a speech recognition result is available.
+     * The event contains the `isFinal` flag and an array of alternatives.
+     */
+    onResult?: (event: SpeechToTextResultEvent) => void;
+    /**
+     * Callback function that is called when speech recognition ends.
+     */
+    onEnd?: () => void;
+    /**
+     * Callback function that is called when an error occurs during speech recognition.
+     */
+    onError?: (event: SpeechToTextErrorEvent) => void;
+}
+export {};