botframework-webchat-api 4.18.0 → 4.18.1-hotfix.20260127.b53acdf

package/dist/botframework-webchat-api.d.ts

@@ -0,0 +1,1612 @@
+import { WebChatActivity, DirectLineAttachment, DirectLineCardAction, DirectLineJSBotConnection, Observable, sendFiles, sendMessage, setSendBoxAttachments, OneOrMany, GlobalScopePonyfill, SendBoxAttachment } from 'botframework-webchat-core';
+import PropTypes from 'prop-types';
+import * as react from 'react';
+import react__default, { ReactNode, ReactElement, Context, ComponentType } from 'react';
+import * as react_chain_of_responsibility from 'react-chain-of-responsibility';
+import { ComponentMiddleware as ComponentMiddleware$1 } from 'react-chain-of-responsibility';
+
+type StyleOptions = {
+    /**
+     * Basic styling
+     */
+    /** Web Chat component accent color */
+    accent?: string;
+    /**
+     * Transcript background color
+     */
+    backgroundColor?: string;
+    /**
+     * Secondary component color
+     */
+    subtle?: string;
+    /**
+     * Default padding used in most visual components
+     */
+    paddingRegular?: number;
+    /**
+     * Padding used for suggestedAction buttons
+     */
+    paddingWide?: number;
+    /**
+    Transition for Bubble, Carousel, and StackedLayout
+     */
+    transitionDuration?: string;
+    /**
+     * Fonts
+     * Default font size will be inherited from the host app
+     */
+    /**
+     * Font size used for secondary components such as sendStatus
+     */
+    fontSizeSmall?: number | string;
+    /**
+     * Font used for ErrorBox
+     * comma-space separated string
+     */
+    monospaceFont?: string;
+    /**
+     * Font used in most visual components
+     * comma-space separated string
+     */
+    primaryFont?: string;
+    rootHeight?: number | string;
+    rootWidth?: number | string;
+    /**
+     * "z-index" for the root container of Web Chat. This will form a new stacking context so "z-index" used in children won't pollute.
+     */
+    rootZIndex?: number;
+    /**
+     * Avatar styling
+     */
+    /**
+     * Border radius used for both bot and user avatar
+     */
+    avatarBorderRadius?: number | string;
+    /**
+     * Height and width of avatar
+     */
+    avatarSize?: number;
+    /**
+     * Background color defaults to accent
+     */
+    botAvatarBackgroundColor?: string;
+    /**
+     * URL string. Can be data URI or blob
+     * botAvatarInitials must be set to empty string
+     */
+    botAvatarImage?: string;
+    /**
+     * Typically rendered as two letters, e.g. 'WC'
+     * Empty string is required when setting botAvatarImage
+     */
+    botAvatarInitials?: string;
+    /**
+     * Background color defaults to accent
+     */
+    userAvatarBackgroundColor?: string;
+    /**
+     * URL string. Can be data URI or blob
+     * userAvatarInitials must be set to empty string
+     */
+    userAvatarImage?: string;
+    /**
+     * Typically rendered as two letters, i.e. 'WC'
+     * Empty string is required when setting userAvatarImage
+     */
+    userAvatarInitials?: string;
+    /**
+     * Avatar grouping can be set at 3 different levels:
+     * Show avatar on activities sharing the same sender ('sender')
+     * Show avatar on activities sharing the same status ('status'; default)
+     * Show avatar on every activity (true)
+     */
+    showAvatarInGroup?: true | 'sender' | 'status';
+    /**
+     *  Bubble styling
+     * 'Bubble' refers to the container of the activit(ies) from the bot and user. Below, non-'fromUser' props refer to styling for the bot activities.
+     */
+    bubbleBackground?: string;
+    bubbleBorderColor?: string;
+    bubbleBorderRadius?: number;
+    bubbleBorderStyle?: string;
+    bubbleBorderWidth?: number;
+    bubbleFromUserBackground?: string;
+    bubbleFromUserBorderColor?: string;
+    bubbleFromUserBorderRadius?: number;
+    bubbleFromUserBorderStyle?: string;
+    bubbleFromUserBorderWidth?: number;
+    /**
+     * Nub offset 'bottom' will render nub at the bottom
+     * A positive or negative number will shift nub offset up/down
+     * "top" is equivalent to positive zero.
+     * "bottom" is equivalent to negative zero.
+     */
+    bubbleFromUserNubOffset?: number | 'bottom' | 'top';
+    /**
+     * Nub size 0 will render a sharp corner
+     */
+    bubbleFromUserNubSize?: number;
+    bubbleFromUserTextColor?: string;
+    /**
+     * Specifies the fixed height of the bubble for image, default to unset.
+     *
+     * @deprecated Use `bubbleImageMaxHeight` and `bubbleImageMinHeight` instead. To mimick behavior before deprecation, set both options to 240px.
+     */
+    bubbleImageHeight?: number | undefined;
+    /**
+     * Specifies the maximum height of the bubble for image, default to 240px.
+     *
+     * CSS variable: `--webchat__max-height--image-bubble`.
+     *
+     * New in 4.18.0.
+     */
+    bubbleImageMaxHeight?: number | undefined;
+    /**
+     * Specifies the minimum height of the bubble for image, default to 240px.
+     *
+     * CSS variable: `--webchat__min-height--image-bubble`.
+     *
+     * New in 4.18.0.
+     */
+    bubbleImageMinHeight?: number | undefined;
+    bubbleMaxWidth?: number | undefined;
+    bubbleMinWidth?: number | undefined;
+    bubbleAttachmentMaxWidth?: number | undefined;
+    bubbleAttachmentMinWidth?: number | undefined;
+    bubbleMessageMaxWidth?: number | undefined;
+    bubbleMessageMinWidth?: number | undefined;
+    bubbleMinHeight?: number;
+    /**
+     * Nub offset ''bottom' will render nub at the bottom
+     * A positive or negative number will shift nub offset up/down
+     * "top" is equivalent to positive zero.
+     * "bottom" is equivalent to negative zero.
+     */
+    bubbleNubOffset?: number | 'bottom' | 'top';
+    /**
+     * Nub size 0 will render a sharp corner
+     */
+    bubbleNubSize?: number;
+    bubbleTextColor?: string;
+    messageActivityWordBreak?: 'normal' | 'break-all' | 'break-word' | 'keep-all';
+    /**
+     * Connectivity UI styling
+     */
+    connectivityIconPadding?: number;
+    connectivityMarginLeftRight?: number;
+    connectivityMarginTopBottom?: number;
+    connectivityTextSize?: number | string;
+    failedConnectivity?: number | string;
+    slowConnectivity?: string;
+    notificationText?: string;
+    /**
+     * Slow connection status will render after x amount of time with no service response
+     */
+    slowConnectionAfter?: number;
+    /**
+     * Emoji styling
+     * If true, Web Chat's default set of emoji will be enabled. See patchStyleOptions.js for default list.
+     * A custom object will enable unicode emoji specified by the developer.
+     * key: emoticon
+     * value: unicode emoji
+     */
+    emojiSet?: boolean | Record<string, string>;
+    /**
+     * Live region - Accessibility
+     * New activities will be rendered in the non-visual live region and removed after a certain amount of time. Modify this property to change fade time.
+     */
+    internalLiveRegionFadeAfter?: number;
+    /**
+     * Markdown styling
+     * Parse markdown to ensure carriage return is respected
+     */
+    markdownRespectCRLF?: boolean;
+    /**
+     * Render HTML inside Markdown.
+     *
+     * `true` to render HTML inside Markdown, otherwise, `false`. Defaults to `true`.
+     *
+     * New in 4.17: This option is enabled by default.
+     */
+    markdownRenderHTML?: boolean;
+    /**
+     * Assign new image for anchor links to indicate external
+     */
+    markdownExternalLinkIconImage?: string;
+    /**
+     * Scroll behavior styling
+     */
+    /**
+     * Prevent scroll to end button from rendering
+     *
+     * @deprecated Since 4.14.0: To hide the scroll to end button, please set `scrollToEndButtonBehavior` to `false`.
+     */
+    hideScrollToEndButton?: boolean;
+    /**
+     * Snap to activity to 'snap-point'
+     * If true, scrolling will pause after 1 activity is received.
+     * Specifying a number will pause after X number of activities
+     */
+    autoScrollSnapOnActivity?: boolean | number;
+    /**
+     * Specify number of pixels to overscroll or underscroll after pause
+     */
+    autoScrollSnapOnActivityOffset?: number;
+    /**
+     * If true, scrolling will pause after activities have filled the page.
+     * Specifying a number (0 to 1) will pause after % of page is filled
+     */
+    autoScrollSnapOnPage?: boolean | number;
+    /**
+     * Specify number of pixels to overscroll or underscroll after pause
+     */
+    autoScrollSnapOnPageOffset?: number;
+    /**
+     * Send box styling
+     */
+    hideSendBox?: boolean;
+    hideUploadButton?: boolean;
+    /**
+     * (EXPERIMENTAL) `true`, if the telephone keypad button should be shown, otherwise, `false`. Defaults to `true`.
+     *
+     * @deprecated This is an experimental style options and should not be used without understanding its risk.
+     */
+    hideTelephoneKeypadButton?: boolean | undefined;
+    microphoneButtonColorOnDictate?: string;
+    sendBoxBackground?: string;
+    /**
+     * The comma-delimited file types that the upload button should accept.
+     * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input/file#accept
+     * @example 'image/*,.pdf'
+     */
+    uploadAccept?: string;
+    /**
+     * If true, the upload button will accept multiple files.
+     * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input/file#multiple
+     */
+    uploadMultiple?: boolean;
+    /**
+     * If set to `send` (default), attachment will be sent when the send button is clicked, or when the message is being sent.
+     *
+     * Otherwise, if set to `attach`, attachment will be sent immediately after file is selected.
+     */
+    sendAttachmentOn?: 'attach' | 'send';
+    /** Send box button: Icon color, defaults to subtle */
+    sendBoxButtonColor?: string;
+    /**
+     * Send box button: Shade border radius
+     *
+     * @default 2
+     */
+    sendBoxButtonShadeBorderRadius?: number;
+    /** Send box button: Shade color */
+    sendBoxButtonShadeColor?: string;
+    /**
+     * Send box button: Shade inset
+     *
+     * @default 2
+     */
+    sendBoxButtonShadeInset?: number;
+    /** Send box button (while `:active`): Icon color */
+    sendBoxButtonColorOnActive?: string;
+    /**
+     * Send box button (while `:active`): Shade color
+     *
+     * @default '#EDEBE9'
+     */
+    sendBoxButtonShadeColorOnActive?: string;
+    /**
+     * Send box button (while `:disabled`): Icon color
+     *
+     * @default '#A19F9D'
+     */
+    sendBoxButtonColorOnDisabled?: string;
+    /**
+     * Send box button (while `:disabled`): Shade color
+     *
+     * @default '#F3F2F1'
+     */
+    sendBoxButtonShadeColorOnDisabled?: string;
+    /** Send box button (while `:focus`): Icon color */
+    sendBoxButtonColorOnFocus?: string;
+    /** Send box button (while `:focus`): Shade color */
+    sendBoxButtonShadeColorOnFocus?: string;
+    /** Send box button (while `:hover`): Icon color */
+    sendBoxButtonColorOnHover?: string;
+    /**
+     * Send box button (while `:hover`): Shade color
+     *
+     * @default '#F3F2F1'
+     */
+    sendBoxButtonShadeColorOnHover?: string;
+    /**
+     * Send box button (while `:focus-visible`): Keyboard focus indicator border color
+     *
+     * @default '#605E5C'
+     */
+    sendBoxButtonKeyboardFocusIndicatorBorderColor?: string;
+    /**
+     * Send box button (while `:focus-visible`): Keyboard focus indicator border radius
+     *
+     * @default 0
+     */
+    sendBoxButtonKeyboardFocusIndicatorBorderRadius?: number | string;
+    /**
+     * Send box button (while `:focus-visible`): Keyboard focus indicator border style
+     *
+     * @default 'solid'
+     */
+    sendBoxButtonKeyboardFocusIndicatorBorderStyle?: string;
+    /**
+     * Send box button (while` :focus-visible`): Keyboard focus indicator border width
+     *
+     * @default 4
+     */
+    sendBoxButtonKeyboardFocusIndicatorBorderWidth?: number;
+    /**
+     * Send box button (while `:focus-visible`): Keyboard focus indicator inset
+     *
+     * @default 4
+     */
+    sendBoxButtonKeyboardFocusIndicatorInset?: number;
+    /**
+     * Disabled text color defaults to subtle
+     */
+    sendBoxDisabledTextColor?: string;
+    sendBoxHeight?: number | string;
+    sendBoxMaxHeight?: number | string;
+    sendBoxTextColor?: string;
+    sendBoxBorderBottom?: number | string;
+    sendBoxBorderLeft?: number | string;
+    sendBoxBorderRight?: number | string;
+    sendBoxBorderTop?: number | string;
+    sendBoxPlaceholderColor?: string;
+    sendBoxTextWrap?: boolean;
+    sendBoxButtonAlignment?: 'bottom' | 'stretch' | 'top';
+    /**
+     * Show spoken text
+     */
+    showSpokenText?: boolean;
+    /**
+     * Spinner animation styling
+     */
+    spinnerAnimationBackgroundImage?: string;
+    spinnerAnimationHeight?: number | string;
+    spinnerAnimationWidth?: number | string;
+    spinnerAnimationPadding?: number | string;
+    /**
+     * Suggested Actions
+     */
+    /**
+     * Suggested action: border radius
+     *
+     * @default 0
+     */
+    suggestedActionBorderRadius?: number | string;
+    /**
+     * Suggested action: Background
+     *
+     * @deprecated Since 4.15.0: Please use `suggestedActionBackgroundColor` instead. This option will be removed on or after 2023-09-16.
+     */
+    suggestedActionBackground?: string;
+    /**
+     * Suggested action: Background color
+     *
+     * @default 'White'
+     */
+    suggestedActionBackgroundColor?: string;
+    /** Suggested action: Border color, defaults to accent color */
+    suggestedActionBorderColor?: string;
+    /**
+     * Suggested action: Border style
+     *
+     * @default 'solid'
+     */
+    suggestedActionBorderStyle?: string;
+    /**
+     * Suggested action: Border width
+     *
+     * @default 2
+     */
+    suggestedActionBorderWidth?: number;
+    /** Suggested action: Text color, defaults to accent color */
+    suggestedActionTextColor?: string;
+    /** Suggested action (while `:disabled`): Background color, defaults to suggestedActionBackground */
+    suggestedActionBackgroundColorOnDisabled?: string;
+    /**
+     * Suggested action (while `:disabled`): Border color
+     *
+     * @default '#E6E6E6'
+     */
+    suggestedActionBorderColorOnDisabled?: string;
+    /** Suggested action (while `:disabled`): Border style */
+    suggestedActionBorderStyleOnDisabled?: string;
+    /** Suggested action (while `:disabled`): Border width */
+    suggestedActionBorderWidthOnDisabled?: number;
+    /** Suggested action (while `:disabled`): Foreground color, defaults to subtle color */
+    suggestedActionTextColorOnDisabled?: string;
+    /**
+     * Suggested action (while `:active`): Background color
+     *
+     * @default '#EDEBE9'
+     */
+    suggestedActionBackgroundColorOnActive?: string;
+    /** Suggested action (while `:active`): Border color */
+    suggestedActionBorderColorOnActive?: string;
+    /** Suggested action (while `:active`): Border style */
+    suggestedActionBorderStyleOnActive?: string;
+    /** Suggested action (while `:active`): Border width */
+    suggestedActionBorderWidthOnActive?: number;
+    /** Suggested action (while `:active`): Text color */
+    suggestedActionTextColorOnActive?: string;
+    /** Suggested action (while `:focus`): Background color */
+    suggestedActionBackgroundColorOnFocus?: string;
+    /** Suggested action (while `:focus`): Border color */
+    suggestedActionBorderColorOnFocus?: string;
+    /** Suggested action (while `:focus`): Border style */
+    suggestedActionBorderStyleOnFocus?: string;
+    /** Suggested action (while `:focus`): Border width */
+    suggestedActionBorderWidthOnFocus?: number;
+    /** Suggested action (while `:focus`): Text color */
+    suggestedActionTextColorOnFocus?: string;
+    /**
+     * Suggested action (while `:hover`): Background color
+     *
+     * @default '#F3F2F1'
+     */
+    suggestedActionBackgroundColorOnHover?: string;
+    /** Suggested action (while `:hover`): Border color */
+    suggestedActionBorderColorOnHover?: string;
+    /** Suggested action (while `:hover`): Border style */
+    suggestedActionBorderStyleOnHover?: string;
+    /** Suggested action (while `:hover`): Border width */
+    suggestedActionBorderWidthOnHover?: number;
+    /** Suggested action (while `:hover`): Text color */
+    suggestedActionTextColorOnHover?: string;
+    /**
+     * Suggested action (while `:disabled`): Background, defaults to suggestedActionBackground.
+     *
+     * @deprecated Since 4.15.0: Please use `suggestedActionBackgroundColorOnDisabled` instead. This option will be removed on or after 2023-09-16.
+     */
+    suggestedActionDisabledBackground?: string;
+    /**
+     * Suggested action (while `:disabled`): Border color
+     *
+     * @deprecated Since 4.15.0: Please use `suggestedActionBorderColorOnDisabled` instead. This option will be removed on or after 2023-09-16.
+     */
+    suggestedActionDisabledBorderColor?: string;
+    /**
+     * Suggested action (while `:disabled`): Border style
+     *
+     * @deprecated Since 4.15.0: Please use `suggestedActionBorderStyleOnDisabled` instead. This option will be removed on or after 2023-09-16.
+     */
+    suggestedActionDisabledBorderStyle?: string;
+    /**
+     * Suggested action (while `:disabled`): Border width
+     *
+     * @deprecated Since 4.15.0: Please use `suggestedActionBorderWidthOnDisabled` instead. This option will be removed on or after 2023-09-16.
+     */
+    suggestedActionDisabledBorderWidth?: number;
+    /**
+     * Suggested action (while `:disabled`): Foreground color, defaults to subtle color
+     *
+     * @deprecated Since 4.15.0: Please use `suggestedActionTextColorOnDisabled` instead. This option will be removed on or after 2023-09-16.
+     */
+    suggestedActionDisabledTextColor?: string;
+    /**
+     * Suggested action: Height
+     *
+     * @default 40
+     */
+    suggestedActionHeight?: number | string;
+    /**
+     * Suggested action: Image height
+     *
+     * @default 20
+     */
+    suggestedActionImageHeight?: number | string;
+    /**
+     * Suggested action: Layout type
+     *
+     * @default 'carousel'
+     */
+    suggestedActionLayout?: 'carousel' | 'flow' | 'stacked';
+    /**
+     * Suggested action (while `:focus-visible`): Keyboard focus indicator border color
+     *
+     * @default '#605E5C'
+     */
+    suggestedActionKeyboardFocusIndicatorBorderColor?: string;
+    /**
+     * Suggested action (while `:focus-visible`): Keyboard focus indicator border radius
+     *
+     * @default 0
+     */
+    suggestedActionKeyboardFocusIndicatorBorderRadius?: number | string;
+    /**
+     * Suggested action (while `:focus-visible`): Keyboard focus indicator border style
+     *
+     * @default 'solid'
+     */
+    suggestedActionKeyboardFocusIndicatorBorderStyle?: string;
+    /**
+     * Suggested action (while `:focus-visible`): Keyboard focus indicator border width
+     *
+     * @default 1
+     */
+    suggestedActionKeyboardFocusIndicatorBorderWidth?: number;
+    /**
+     * Suggested action (while `:focus-visible`): Keyboard focus indicator inset
+     *
+     * @default 2
+     */
+    suggestedActionKeyboardFocusIndicatorInset?: number;
+    /**
+     * Suggested action (while `:active`): background
+     *
+     * @deprecated Since 4.15.0: Please use `suggestedActionBackgroundColorOnActive` instead. This option will be removed on or after 2023-09-16.
+     */
+    suggestedActionActiveBackground?: string;
+    /**
+     * Suggested action (while `:focus`): background
+     *
+     * @deprecated Since 4.15.0: Please use `suggestedActionBackgroundColorOnFocus` instead. This option will be removed on or after 2023-09-16.
+     */
+    suggestedActionFocusBackground?: string;
+    /**
+     * Suggested action (while `:hover`): background
+     *
+     * @deprecated Since 4.15.0: Please use `suggestedActionBackgroundColorOnHover` instead. This option will be removed on or after 2023-09-16.
+     */
+    suggestedActionHoverBackground?: string;
+    /**
+     * Suggested actions carousel layout
+     */
+    /**
+     * Cursor when mouseover on flipper
+     */
+    suggestedActionsCarouselFlipperCursor?: string;
+    /**
+     * Flipper bounding box size
+     */
+    suggestedActionsCarouselFlipperBoxWidth?: number;
+    /**
+     * Flipper button's visible size
+     */
+    suggestedActionsCarouselFlipperSize?: number;
+    /**
+     * Suggested actions flow layout
+     * Default value is 'auto',
+     */
+    suggestedActionsFlowMaxHeight?: undefined;
+    /**
+     * Suggested actions stacked layout
+     */
+    /**
+     * Stacked height container's max height. Default value is 'auto'
+     */
+    suggestedActionsStackedHeight?: number | 'auto';
+    /**
+     * Stacked overflow default value is 'auto'
+     */
+    suggestedActionsStackedOverflow?: 'auto' | 'hidden' | 'scroll' | 'visible';
+    /**
+     * Button max height default value is 100% if suggestedActionsStackedLayoutButtonTextWrap is true
+     */
+    suggestedActionsStackedLayoutButtonMaxHeight?: number | string;
+    /**
+     * Button Text Wrap, if set to true, will wrap long text in buttons in STACKED mode ONLY
+     */
+    suggestedActionsStackedLayoutButtonTextWrap?: boolean;
+    /** Suggested actions: Visual keyboard indicator color for the container. */
+    suggestedActionsVisualKeyboardIndicatorColor?: string;
+    /** Suggested actions: Visual keyboard indicator style for the container. */
+    suggestedActionsVisualKeyboardIndicatorStyle?: string;
+    /** Suggested actions: Visual keyboard indicator width for the container. */
+    suggestedActionsVisualKeyboardIndicatorWidth?: number;
+    /**
+     * Timestamp
+     */
+    /**
+     * Specifies the time window for grouping related timestamps.
+     *
+     * `number` - time window for grouping related timestamps (in milliseconds)
+     * `false` - never group timestamps
+     * `true` - group all timestamps
+     */
+    groupTimestamp?: boolean | number;
+    sendTimeout?: number | ((activity: WebChatActivity) => number);
+    sendTimeoutForAttachments?: number;
+    /**
+     * Timestamp color default value is subtle
+     */
+    timestampColor?: string;
+    timestampFormat?: 'absolute' | 'relative';
+    /**
+     * Transcript styling
+     */
+    transcriptTerminatorBackgroundColor?: string;
+    transcriptTerminatorBorderRadius?: number | string;
+    transcriptTerminatorColor?: string;
+    transcriptTerminatorFontSize?: number | string;
+    transcriptActivityVisualKeyboardIndicatorColor?: string;
+    transcriptActivityVisualKeyboardIndicatorStyle?: string;
+    transcriptActivityVisualKeyboardIndicatorWidth?: number | string;
+    transcriptVisualKeyboardIndicatorColor?: string;
+    transcriptVisualKeyboardIndicatorStyle?: string;
+    transcriptVisualKeyboardIndicatorWidth?: number | string;
+    /**
+     * Transcript overlay button
+     * e.g. carousel and suggested action flippers, scroll to bottom, etc.
+     */
+    /**
+     * Controls when the new messages button should show.
+     *
+     * - `"unread"` will show when there are any unread and offscreen messages (default)
+     * - `"any"` will show when there are any offscreen messages
+     * - `false` will always hide the button
+     */
+    scrollToEndButtonBehavior?: false | 'any' | 'unread';
+    /** Font size of the new message button. */
+    scrollToEndButtonFontSize?: number | string;
+    /**
+     * Font size of the new message button.
+     *
+     * @deprecated Since 4.14.0: Renamed to {@linkcode scrollToEndButtonFontSize}.
+     */
+    newMessagesButtonFontSize?: number | string;
+    transcriptOverlayButtonBackground?: string;
+    transcriptOverlayButtonBackgroundOnDisabled?: string;
+    transcriptOverlayButtonBackgroundOnFocus?: string;
+    transcriptOverlayButtonBackgroundOnHover?: string;
+    transcriptOverlayButtonColor?: string;
+    transcriptOverlayButtonColorOnDisabled?: string;
+    /**
+     * Default value is transcriptOverlayButtonColor
+     */
+    transcriptOverlayButtonColorOnFocus?: string;
+    /**
+     * Default value is transcriptOverlayButtonColor
+     */
+    transcriptOverlayButtonColorOnHover?: string;
+    /**
+     * Toast UI
+     */
+    /**
+     * New debounce timeout value only affects new notifications.
+     */
+    notificationDebounceTimeout?: number;
+    hideToaster?: boolean;
+    toasterHeight?: number | string;
+    toasterMaxHeight?: number | string;
+    toasterSingularMaxHeight?: number | string;
+    toastFontSize?: number | string;
+    toastIconWidth?: number | string;
+    toastSeparatorColor?: string;
+    toastTextPadding?: number | string;
+    toastErrorBackgroundColor?: string;
+    toastErrorColor?: string;
+    toastInfoBackgroundColor?: string;
+    toastInfoColor?: string;
+    toastSuccessBackgroundColor?: string;
+    toastSuccessColor?: string;
+    toastWarnBackgroundColor?: string;
+    toastWarnColor?: string;
+    /**
+     * Typing animation
+     */
+    typingAnimationBackgroundImage?: string;
+    typingAnimationDuration?: number;
+    typingAnimationHeight?: number | string;
+    typingAnimationWidth?: number | string;
+    /**
+     * Upload thumbnail
+     */
+    enableUploadThumbnail?: boolean;
+    uploadThumbnailContentType?: string;
+    uploadThumbnailHeight?: number;
+    uploadThumbnailQuality?: number;
+    uploadThumbnailWidth?: number;
+    /**
+     * Video
+     */
+    videoHeight?: number | string;
+    /**
+     * Maximum message length in characters
+     *
+     * @default 2000
+     */
+    maxMessageLength?: number;
+    /**
+     * The node to place Web Chat styles into. Needed when using as a Web Component.
+     *
+     * @default document.head
+     */
+    stylesRoot?: Node;
+    /**
+     * Border animation
+     */
+    /**
+     * Border animation 1st color
+     *
+     * CSS variable: `--webchat__animation--border-color-1` CSS variable to adjust the color
+     *
+     * New in 4.19.0.
+     */
+    borderAnimationColor1?: string;
+    /**
+     * Border animation 2nd color
+     *
+     * CSS variable: `--webchat__animation--border-color-2` CSS variable to adjust the color
+     *
+     * New in 4.19.0.
+     */
+    borderAnimationColor2?: string;
+    /**
+     * Border animation 3rd color
+     *
+     * CSS variable: `--webchat__animation--border-color-3` CSS variable to adjust the color
+     *
+     * New in 4.19.0.
+     */
+    borderAnimationColor3?: string;
+    /**
+     * Code block theme
+     *
+     * - `'github-light-default'` - use light theme for code blocks
+     * - `'github-dark-default'` - use dark theme for code blocks
+     *
+     * @default 'github-light-default'
+     *
+     * New in 4.19.0.
+     */
+    codeBlockTheme?: 'github-light-default' | 'github-dark-default';
+    /**
+     * (EXPERIMENTAL) Feedback buttons placement
+     *
+     * - `'activity-actions'` - place feedback buttons inside activity actions - will show feedback form
+     * - `'activity-status'` - place feedback buttons inside activity status
+     *
+     * @default 'activity-status'
+     *
+     * @deprecated This is an experimental style options and should not be used without understanding its risk.
+     *
+     * New in 4.19.0.
+     */
+    feedbackActionsPlacement?: 'activity-actions' | 'activity-status';
+    /**
+     * Use continuous mode for speech recognition. Default to `false`.
+     *
+     * - `true` to use continuous mode which focuses on a hands-off experience, keeping speech recognition active for extended periods, supporting barge-in, non-speech interactions will not stop speech recognition
+     * - `false` to use interactive mode which focuses on privacy, keeping speech recognition active only for the minimal time required, no barge-in, non-speech interactions will stop speech recognition
+     *
+     * @see https://github.com/microsoft/BotFramework-WebChat/pull/5426
+     */
+    speechRecognitionContinuous?: boolean | undefined;
+    /**
+     * Defines how activities are being grouped by (in the order of appearance in the array). Default to `['sender', 'status']` or `sender,status` in CSS.
+     *
+     * Values are key of result of `groupActivitiesMiddleware`. The default implementation of `groupActivitiesMiddleware` has `sender` and `status`.
+     *
+     * To add new groupings, configure `groupActivitiesMiddleware` to output extra groups. Then, add the group names to `styleOptions.groupActivitiesBy`.
+     */
+    groupActivitiesBy?: readonly string[] | undefined;
+};
+type StrictStyleOptions = Required<Omit<StyleOptions, 'bubbleImageHeight' | 'bubbleMaxWidth' | 'bubbleMinWidth' | 'hideScrollToEndButton' | 'newMessagesButtonFontSize'>> & {
+    bubbleFromUserNubOffset: number;
+    bubbleNubOffset: number;
+    emojiSet: false | Record<string, string>;
+};
+
+declare const DEFAULT_OPTIONS: Required<StyleOptions>;
+
+type AttachmentProps = {
+    activity: WebChatActivity;
+    attachment: DirectLineAttachment;
+};
+type RenderAttachment = (props?: AttachmentProps) => ReactNode;
+type AttachmentEnhancer = (next: RenderAttachment) => RenderAttachment;
+type AttachmentMiddleware = () => AttachmentEnhancer;
+
+type ActivityProps = {
+    hideTimestamp: boolean;
+    renderActivityStatus: (options: {
+        hideTimestamp: boolean;
+    }) => ReactNode;
+    renderAvatar: false | (() => Exclude<ReactNode, boolean | null | undefined>);
+    showCallout: boolean;
+};
+type ActivityComponent = (props: ActivityProps) => Exclude<ReactNode, boolean | null | undefined>;
+type ActivityComponentFactoryOptions = {
+    activity: WebChatActivity;
+    nextVisibleActivity: WebChatActivity;
+};
+type ActivityComponentFactory = (options: ActivityComponentFactoryOptions) => ActivityComponent | false;
+type LegacyRenderActivity = (renderAttachment: RenderAttachment, { hideTimestamp, renderActivityStatus, renderAvatar, showCallout }: ActivityProps) => Exclude<ReactNode, boolean>;
+type LegacyActivityRenderer = (options: ActivityComponentFactoryOptions) => LegacyRenderActivity | false;
+type ActivityEnhancer = (next: LegacyActivityRenderer) => LegacyActivityRenderer;
+type ActivityMiddleware = () => ActivityEnhancer;
+
+type SendStatus = 'send failed' | 'sending' | 'sent';
+
+type RenderActivityStatusOptions = {
+    activity: WebChatActivity;
+    hideTimestamp: boolean;
+    sendState: SendStatus;
+    /** @deprecated */
+    nextVisibleActivity: WebChatActivity;
+    /** @deprecated */
+    sameTimestampGroup: boolean;
+};
+type RenderActivityStatus = (options: RenderActivityStatusOptions) => ReactElement;
+type ActivityStatusEnhancer = (next: RenderActivityStatus) => RenderActivityStatus;
+type ActivityStatusMiddleware = () => ActivityStatusEnhancer;
+
+type OnScreenReactNode = Exclude<ReactNode, boolean | null | undefined>;
+/**
+ * Renders a UI component by returning a React component, or `false`, if nothing should be rendered.
+ *
+ * @returns {(React.FC|false)} Returns a React component to render, or `false`, if nothing should be rendered.
+ */
+type ComponentFactory<TComponentFactoryArguments extends any[], TProps> = (...args: TComponentFactoryArguments) => ((props?: TProps) => OnScreenReactNode) | false;
+/**
+ * Enhances a UI component through decoration, replacement, or removal.
+ */
+type ComponentEnhancer<TComponentFactoryArguments extends any[], TProps> = (next: ComponentFactory<TComponentFactoryArguments, TProps>) => ComponentFactory<TComponentFactoryArguments, TProps>;
+/**
+ * Middleware for rendering a UI component.
+ *
+ * The middleware is a series of enhancers that are chained through functional composition. Each enhancer can:
+ *
+ * - Decorate: call the next enhancer to get its React component, then decorate it through UI composition
+ * - Replace: return a React component without calling the next enhancer
+ * - Remove: return `false` without calling the next enhancer
+ *
+ * The signature of the middleware is:
+ *
+ * ```
+ * (...args: SetupArguments) => (next: Enhancer) => (...args: ComponentFactoryArguments) => false | React.ComponentType<Props>
+ * ```
+ */
+type ComponentMiddleware<TSetupArguments extends any[], TComponentFactoryArguments extends any[], TProps> = (...args: TSetupArguments) => ComponentEnhancer<TComponentFactoryArguments, TProps>;
+
+type AttachmentForScreenReaderComponentFactoryOptions = [
+    {
+        activity: WebChatActivity;
+        attachment: DirectLineAttachment;
+    }
+];
+type AttachmentForScreenReaderComponentFactory = ComponentFactory<AttachmentForScreenReaderComponentFactoryOptions, {}>;
+type AttachmentForScreenReaderMiddleware = ComponentMiddleware<[
+], AttachmentForScreenReaderComponentFactoryOptions, {}>;
+
+type AvatarComponentFactoryArguments = [
+    {
+        activity: WebChatActivity;
+        fromUser: boolean;
+        styleOptions: StrictStyleOptions;
+    }
+];
+type AvatarComponentFactory = ComponentFactory<AvatarComponentFactoryArguments, {}>;
+type AvatarMiddleware = ComponentMiddleware<[], AvatarComponentFactoryArguments, {}>;
+
+type CallFunction<TArguments extends any[], TResult> = (...args: TArguments) => TResult;
+type FunctionEnhancer<TCallArguments extends any[], TResult> = (next: CallFunction<TCallArguments, TResult>) => CallFunction<TCallArguments, TResult>;
+type FunctionMiddleware<TSetupArguments extends any[], TCallArguments extends any[], TResult> = (...args: TSetupArguments) => FunctionEnhancer<TCallArguments, TResult>;
+
+type PerformCardAction = (cardAction: DirectLineCardAction, event?: {
+    target: EventTarget;
+}) => void;
+type CardActionMiddleware = FunctionMiddleware<[
+    {
+        dispatch: (action: any) => void;
+    }
+], [
+    {
+        cardAction: DirectLineCardAction;
+        getSignInUrl?: () => string;
+        target: any;
+    }
+], {}>;
+
+type ContextOf<T> = T extends Context<infer P> ? P : never;
+
+type GroupedActivities$1 = readonly (readonly WebChatActivity[])[];
+type GroupActivities = CallFunction<[
+    Readonly<{
+        activities: readonly WebChatActivity[];
+    }>
+], {
+    [key: string]: GroupedActivities$1;
+}>;
+type GroupActivitiesMiddleware = FunctionMiddleware<[
+    string
+], [
+    Readonly<{
+        activities: readonly WebChatActivity[];
+    }>
+], {
+    [key: string]: GroupedActivities$1;
+}>;
+
+type LocalizedStrings = {
+    [stringId: string]: boolean | string;
+};
+
+/**
+ * @type {object}
+ * @property {boolean} atEnd - `true`, if the transcript scroll view is at the end, otherwise, `false`.
+ * @property {object} styleOptions - Normalized style options.
+ * @property {boolean} unread - `true`, if there are unread messages in the transcripts, otherwise, `false`.
+ */
+type ScrollToEndButtonComponentArguments = [
+    {
+        atEnd: boolean;
+        styleOptions: StrictStyleOptions;
+        unread: boolean;
+    }
+];
+/**
+ * @type {object}
+ * @property {function} onClick - The callback function to call when the user click on the button.
+ */
+type ScrollToEndButtonProps = {
+    onClick: () => any;
+};
+/**
+ * The middleware for rendering scroll to end button.
+ */
+type ScrollToEndButtonMiddleware = ComponentMiddleware<[], ScrollToEndButtonComponentArguments, ScrollToEndButtonProps>;
+type ScrollToEndButtonComponentFactory = ComponentFactory<ScrollToEndButtonComponentArguments, ScrollToEndButtonProps>;
+
+type BaseTelemetryMeasurementEvent = {
+    dimension?: any;
+};
+type TelemetryEventMeasurementEvent = BaseTelemetryMeasurementEvent & {
+    type: 'event';
+    name: string;
+    level: 'debug' | 'info' | 'warn' | 'error';
+    data?: number | string | {
+        [key: string]: number | string;
+    };
+};
+type TelemetryExceptionMeasurementEvent = BaseTelemetryMeasurementEvent & {
+    type: 'exception';
+    error: Error;
+    fatal: boolean;
+};
+type TelemetryTimingStartMeasurementEvent = BaseTelemetryMeasurementEvent & {
+    type: 'timingstart';
+    name: string;
+    timingId: string;
+};
+type TelemetryTimingEndMeasurementEvent = BaseTelemetryMeasurementEvent & {
+    type: 'timingend';
+    name: string;
+    timingId: string;
+    duration: number;
+};
+type TelemetryMeasurementEvent = TelemetryEventMeasurementEvent | TelemetryExceptionMeasurementEvent | TelemetryTimingStartMeasurementEvent | TelemetryTimingEndMeasurementEvent;
+
+type Notification = {
+    alt: string;
+    data?: any;
+    id: string;
+    level: string;
+    message?: string;
+    timestamp?: number;
+};
+
+type ToastProps = {
+    notification: Notification;
+};
+type RenderToast = (props: ToastProps) => ReactNode;
+type ToastEnhancer = (next: RenderToast) => RenderToast;
+type ToastMiddleware = () => ToastEnhancer;
+
+type Typing = {
+    at: number;
+    expireAt: number;
+    name: string;
+    role: 'bot' | 'user';
+    type: 'busy' | 'livestream';
+};
+
+type TypingIndicatorProps = {
+    activeTyping: {
+        [id: string]: Typing;
+    };
+    typing: {
+        [id: string]: Typing;
+    };
+    visible: boolean;
+};
+type RenderTypingIndicator = (props: TypingIndicatorProps) => ReactNode;
+type TypingIndicatorEnhancer = (next: RenderTypingIndicator) => RenderTypingIndicator;
+type TypingIndicatorMiddleware = () => TypingIndicatorEnhancer;
+
+type MiddlewareWithInit<M extends ComponentMiddleware$1<any, any, any>, I> = (init: I) => ReturnType<M> | false;
+
+declare const initSendBoxMiddleware: (middleware: readonly MiddlewareWithInit<react_chain_of_responsibility.ComponentMiddleware<unknown, unknown>, undefined>[], init: undefined) => readonly react_chain_of_responsibility.ComponentMiddleware<void, {
+    className?: string | undefined;
+}>[];
+declare const SendBoxMiddlewareProxy: react.ComponentType<{
+    className?: string | undefined;
+} & {
+    fallbackComponent?: react.ComponentType<{
+        className?: string | undefined;
+    }>;
+    request?: undefined;
+} & {
+    children?: react.ReactNode | undefined;
+}>;
+declare const types$1: {
+    init: undefined;
+    middleware: react_chain_of_responsibility.ComponentMiddleware<void, {
+        className?: string | undefined;
+    }>;
+    props: {
+        className?: string | undefined;
+    };
+    request: void;
+};
+type SendBoxMiddleware = typeof types$1.middleware;
+type SendBoxMiddlewareProps = typeof types$1.props;
+type SendBoxMiddlewareRequest = typeof types$1.request;
+
+declare const initSendBoxToolbarMiddleware: (middleware: readonly MiddlewareWithInit<react_chain_of_responsibility.ComponentMiddleware<unknown, unknown>, undefined>[], init: undefined) => readonly react_chain_of_responsibility.ComponentMiddleware<void, {
+    className?: string | undefined;
+}>[];
+declare const SendBoxToolbarMiddlewareProxy: react.ComponentType<{
+    className?: string | undefined;
+} & {
+    fallbackComponent?: react.ComponentType<{
+        className?: string | undefined;
+    }>;
+    request?: undefined;
+} & {
+    children?: react.ReactNode | undefined;
+}>;
+declare const types: {
+    init: undefined;
+    middleware: react_chain_of_responsibility.ComponentMiddleware<void, {
+        className?: string | undefined;
+    }>;
+    props: {
+        className?: string | undefined;
+    };
+    request: void;
+};
+type SendBoxToolbarMiddleware = typeof types.middleware;
+type SendBoxToolbarMiddlewareProps = typeof types.props;
+type SendBoxToolbarMiddlewareRequest = typeof types.request;
+
+type PrecompiledGlobalize = {
+    dateFormatter: ({ skeleton }: {
+        skeleton: 'MMMMdhm';
+    }) => string;
+    relativeTimeFormatter: (format: 'hour' | 'minute') => string;
+    unitFormatter: ((unit: 'byte', options: {
+        form: 'long';
+    }) => string) | ((unit: 'kilobyte' | 'megabyte' | 'gigabyte', options: {
+        form: 'short';
+    }) => string);
+};
+
+type WebChatAPIContextType = {
+    activityRenderer?: LegacyActivityRenderer;
+    activityStatusRenderer: RenderActivityStatus;
+    attachmentForScreenReaderRenderer?: AttachmentForScreenReaderComponentFactory;
+    attachmentRenderer?: RenderAttachment;
+    avatarRenderer: AvatarComponentFactory;
+    clearSuggestedActions?: () => void;
+    dir?: string;
+    directLine?: DirectLineJSBotConnection;
+    dismissNotification?: (id: string) => void;
+    downscaleImageToDataURL?: (blob: Blob, maxWidth: number, maxHeight: number, type: string, quality: number) => Promise<URL>;
+    emitTypingIndicator?: () => void;
+    grammars?: any;
+    groupActivities?: GroupActivities;
+    internalErrorBoxClass?: ComponentType<Readonly<{
+        error: Error;
+        type?: string;
+    }>> | undefined;
+    language?: string;
+    localizedGlobalizeState?: PrecompiledGlobalize[];
+    localizedStrings?: {
+        [language: string]: LocalizedStrings;
+    };
+    markActivity?: (activity: {
+        id: string;
+    }, name: string, value?: any) => void;
+    onCardAction?: PerformCardAction;
+    onTelemetry?: (event: TelemetryMeasurementEvent) => void;
+    postActivity?: (activity: WebChatActivity) => Observable<string>;
+    renderMarkdown?: (markdown: string, newLineOptions: {
+        markdownRespectCRLF: boolean;
+    }, linkOptions: {
+        externalLinkAlt: string;
+    }) => string;
+    scrollToEndButtonRenderer?: ScrollToEndButtonComponentFactory;
+    selectVoice?: (voices: (typeof window.SpeechSynthesisVoice)[], activity: WebChatActivity) => typeof window.SpeechSynthesisVoice;
+    sendEvent?: (name: string, value: any) => void;
+    sendFiles?: (...args: Parameters<typeof sendFiles>) => void;
+    sendMessage?: (...args: Parameters<typeof sendMessage>) => void;
+    sendMessageBack?: (value: any, text?: string, displayText?: string) => void;
+    sendPostBack?: (value?: any) => void;
+    sendTypingIndicator?: boolean;
+    setDictateInterims?: (interims: string[]) => void;
+    setDictateState?: (dictateState: number) => void;
+    setNotification?: (notification: Notification) => void;
+    setSendBox?: (value: string) => void;
+    setSendBoxAttachments?: (...args: Parameters<typeof setSendBoxAttachments>) => void;
+    setSendTimeout?: (timeout: number) => void;
+    startDictate?: () => void;
+    startSpeakingActivity?: () => void;
+    stopDictate?: () => void;
+    stopSpeakingActivity?: () => void;
+    styleOptions?: StrictStyleOptions;
+    submitSendBox?: (method?: string, { channelData }?: {
+        channelData: any;
+    }) => void;
+    telemetryDimensionsRef?: React.Ref<any>;
+    toastRenderer?: RenderToast;
+    trackDimension?: (name: string, data: any) => void;
+    typingIndicatorRenderer?: any;
+    uiState: 'blueprint' | 'disabled' | undefined;
+    userID?: string;
+    username?: string;
+};
+
+type ComposerCoreProps = Readonly<{
+    activityMiddleware?: OneOrMany<ActivityMiddleware>;
+    activityStatusMiddleware?: OneOrMany<ActivityStatusMiddleware>;
+    attachmentForScreenReaderMiddleware?: OneOrMany<AttachmentForScreenReaderMiddleware>;
+    attachmentMiddleware?: OneOrMany<AttachmentMiddleware>;
+    avatarMiddleware?: OneOrMany<AvatarMiddleware>;
+    cardActionMiddleware?: OneOrMany<CardActionMiddleware>;
+    children?: ReactNode | ((context: ContextOf<react__default.Context<WebChatAPIContextType>>) => ReactNode);
+    dir?: string;
+    directLine: DirectLineJSBotConnection;
+    /**
+     * @deprecated Please use `uiState="disabled"` instead. This feature will be removed on or after 2026-09-04.
+     */
+    disabled?: boolean;
+    downscaleImageToDataURL?: (blob: Blob, maxWidth: number, maxHeight: number, type: string, quality: number) => Promise<URL>;
+    grammars?: any;
+    groupActivitiesMiddleware?: OneOrMany<GroupActivitiesMiddleware>;
+    internalErrorBoxClass?: ComponentType<Readonly<{
+        error: Error;
+        type?: string;
+    }>> | undefined;
+    locale?: string;
+    onTelemetry?: (event: TelemetryMeasurementEvent) => void;
+    overrideLocalizedStrings?: LocalizedStrings | ((strings: LocalizedStrings, language: string) => LocalizedStrings);
+    renderMarkdown?: (markdown: string, newLineOptions: {
+        markdownRespectCRLF: boolean;
+    }, linkOptions: {
+        externalLinkAlt: string;
+    }) => string;
+    scrollToEndButtonMiddleware?: OneOrMany<ScrollToEndButtonMiddleware>;
+    selectVoice?: (voices: (typeof window.SpeechSynthesisVoice)[], activity: WebChatActivity) => void;
+    sendBoxMiddleware?: readonly SendBoxMiddleware[] | undefined;
+    sendBoxToolbarMiddleware?: readonly SendBoxToolbarMiddleware[] | undefined;
+    sendTypingIndicator?: boolean;
+    styleOptions?: StyleOptions;
+    toastMiddleware?: OneOrMany<ToastMiddleware>;
+    typingIndicatorMiddleware?: OneOrMany<TypingIndicatorMiddleware>;
+    /**
+     * Sets the state of the UI.
+     *
+     * - `undefined` will render normally
+     * - `"blueprint"` will render as few UI elements as possible and should be non-functional
+     *   - Useful for loading scenarios
+     * - `"disabled"` will render most UI elements as non-functional
+     *   - Scrolling may continue to trigger read acknowledgements
+     */
+    uiState?: 'blueprint' | 'disabled' | undefined;
+    userID?: string;
+    username?: string;
+}>;
+type ComposerWithStoreProps = ComposerCoreProps & Readonly<{
+    store?: any;
+}>;
+type ComposerProps = ComposerWithStoreProps & {
+    internalRenderErrorBox?: any;
+    /**
+     * Ponyfill to overrides specific global scope members. This prop cannot be changed after initial render.
+     *
+     * This option is for development use only. Not all features in Web Chat are ponyfilled.
+     *
+     * To fake timers, `setTimeout` and related functions can be passed to overrides the original global scope members.
+     *
+     * Please see [#4662](https://github.com/microsoft/BotFramework-WebChat/pull/4662) for details.
+     */
+    ponyfill?: Partial<GlobalScopePonyfill>;
+};
+declare const Composer: {
+    ({ internalRenderErrorBox, onTelemetry, ponyfill, ...props }: ComposerProps): any;
+    defaultProps: {
+        internalRenderErrorBox: any;
+        onTelemetry: any;
+        ponyfill: any;
+        store: any;
+    };
+    propTypes: {
+        internalRenderErrorBox: PropTypes.Requireable<any>;
+        onTelemetry: PropTypes.Requireable<(...args: any[]) => any>;
+        ponyfill: PropTypes.Requireable<any>;
+        store: PropTypes.Requireable<any>;
+    };
+};
+
+declare function useActiveTyping(expireAfter?: number): readonly [Readonly<Record<string, Typing>>];
+
+declare function useActivities(): [WebChatActivity[]];
+
+declare function useActivityKeys(): readonly [readonly string[]];
+
+/**
+ * Returns an arrays of two list of activity keys: read and unread.
+ */
+declare function useActivityKeysByRead(): readonly [readonly string[], readonly string[]];
+
+declare function useAvatarForBot(): [{
+    image: string;
+    initials: string;
+}];
+
+declare function useAvatarForUser(): [{
+    image: string;
+    initials: string;
+}];
+
+declare function useByteFormatter(): (bytes: number) => string;
+
+declare function useConnectivityStatus(): [string];
+
+declare function useCreateActivityRenderer(): ActivityComponentFactory;
+
+type ActivityStatusRenderer = (renderOptions: {
+    activity: WebChatActivity;
+    nextVisibleActivity: WebChatActivity;
+}) => (props?: {
+    hideTimestamp?: boolean;
+}) => ReactNode;
+declare function useCreateActivityStatusRenderer(): ActivityStatusRenderer;
+
+declare function useCreateAttachmentForScreenReaderRenderer(): AttachmentForScreenReaderComponentFactory;
+
+declare function useCreateAvatarRenderer(): ({ activity }: {
+    activity: WebChatActivity;
+}) => false | (() => Exclude<ReactNode, boolean | null | undefined>);
+
+declare function useCreateScrollToEndButtonRenderer(): ScrollToEndButtonComponentFactory;
+
+declare function useDateFormatter(): (date: Date | number | string) => string;
+
+type DebouncedNotification = Notification & {
+    outOfDate: boolean;
+    updateNotBefore: number;
+};
+type DebouncedNotifications = {
+    [id: string]: DebouncedNotification;
+};
+declare function useDebouncedNotifications(): [DebouncedNotifications];
+
+declare function useDictateInterims(): [string[], (interims: string[]) => void];
+
+declare function useDictateState(): [number];
+
+declare function useDirection(): ['auto' | 'ltr' | 'rtl'];
+
+/**
+ * @deprecated Please use `useUIState() === 'disabled'` instead. This hook will be removed on or after 2026-09-04.
+ */
+declare function useDisabled(): readonly [boolean];
+
+declare function useDismissNotification(): (id: string) => void;
+
+declare function useEmitTypingIndicator(): () => void;
+
+declare function useGetActivitiesByKey(): (key?: string) => readonly WebChatActivity[] | undefined;
+
+declare function useGetActivityByKey(): (key?: string) => undefined | WebChatActivity;
+
+declare function useGetHasAcknoweledgedByActivityKey(): (activityKey: string) => boolean | undefined;
+
+declare function useGetKeyByActivity(): (activity?: WebChatActivity) => string | undefined;
+
+declare function useGetKeyByActivityId(): (activityId?: string) => string | undefined;
+
+declare function useGetSendTimeoutForActivity(): ({ activity }: {
+    activity: WebChatActivity;
+}) => number;
+
+declare function useGrammars(): [any];
+
+type GroupedActivities = readonly (readonly WebChatActivity[])[];
+/**
+ * This hook will return a callback function. When called with `activities`, the callback function will run the `groupActivitiesMiddleware` and will return all groupings.
+ *
+ * @deprecated This function is deprecated and will be removed on or after 2027-05-04. Developers should migrate to [`useGroupActivitiesByName`](#usegroupactivitiesbyname) for performance reason.
+ */
+declare function useGroupActivities(): ({ activities }: Readonly<{
+    activities: readonly WebChatActivity[];
+}>) => Readonly<{
+    [key: string]: GroupedActivities;
+}>;
+
+/**
+ * This hook will return a callback function. When called with `activities`, the callback function will run the `groupActivitiesMiddleware` for the specified grouping name.
+ *
+ * Unlike the [`useGroupActivities`](#usegroupactivities) hook which provide result for all groupings, this hook only provide result for the specified grouping name and the grouping name must be one of the name specified in `styleOptions.groupActivitiesBy`.
+ *
+ * @returns Result of `groupActivitiesMiddleware` for the specified grouping name
+ */
+declare function useGroupActivitiesBy(): (activities: readonly WebChatActivity[], name: string) => readonly (readonly WebChatActivity[])[];
+
+declare function useGroupTimestamp(): [boolean | number];
+
+declare function useLanguage(options?: 'speech'): [string];
+
+declare function useLastAcknowledgedActivityKey(): readonly [string];
+
+declare function useLastReadActivityKey(): readonly [string | undefined];
+
+type Plural = {
+    zero?: string;
+    one?: string;
+    two?: string;
+    few?: string;
+    many?: string;
+    other: string;
+};
+declare function useLocalizer({ plural }?: {
+    plural?: boolean;
+}): (id: string | Plural, args_0?: string | number, ...args: string[]) => any;
+
+declare function useMarkActivityAsSpoken(): (activity: WebChatActivity) => void;
+
+declare function useMarkActivityKeyAsRead(): (activityKey: string) => void;
+
+declare function useMarkAllAsAcknowledged(): () => void;
+
+declare function useNotifications(): [Notification[]];
+
+declare function usePerformCardAction(): PerformCardAction;
+
+declare function usePonyfill(): readonly [GlobalScopePonyfill];
+
+declare function usePostActivity(): (activity: WebChatActivity) => Observable<string>;
+
+declare function useReferenceGrammarID(): [string];
+
+declare function useRelativeTimeFormatter(): (dateOrString: Date | string) => string;
+
+declare function useRenderAttachment(): RenderAttachment | undefined;
+
+declare function useRenderToast(): RenderToast;
+
+declare function useRenderTypingIndicator(): RenderTypingIndicator;
+
+declare function useSendBoxAttachments(): readonly [
+    readonly SendBoxAttachment[],
+    (attachments: readonly SendBoxAttachment[]) => void
+];
+
+declare function useSendBoxValue(): [string, (value: string) => void];
+
+declare function useSendEvent(): (name: string, value: any) => void;
+
+type PostActivityFile = {
+    name: string;
+    size: number;
+    thumbnail?: string;
+    url: string;
+};
+declare function useSendFiles(): (files: PostActivityFile[]) => void;
+
+declare function useSendMessage(): (text?: string, method?: string, init?: {
+    attachments?: readonly SendBoxAttachment[] | undefined;
+    channelData?: any;
+}) => void;
+
+declare function useSendMessageBack(): (value: any, text?: string, displayText?: string) => void;
+
+declare function useSendPostBack(): (value?: any) => void;
+
+/**
+ * Returns a key/value map which stores the outgoing activity send status by activity key:
+ *
+ * - `"sending"`, the activity is currently in transit;
+ * - `"sent"`, the activity is sent and acknowledged by the platform;
+ * - `"send failed"`, the activity failed to send.
+ *
+ * If the send status is `"send failed"`, it could be due to (non-exhaustive):
+ *
+ * - Immediate or almost immediate failures, such as network error;
+ * - It took longer than `styleOptions.sendTimeout` or `styleOptions.sendTimeoutForAttachments` to send.
+ *
+ * The send status of an activity could turn from `"send failed"` back to `"sending"` if (non-exhaustive):
+ *
+ * - The platform support resend and the activity is being resend;
+ * - The `styleOptions.sendTimeout` or `styleOptions.sendTimeoutForAttachments` has increased past the expiry, overthrown the previous decision for timeout.
+ *
+ * If the activity key does not exists in this map, the activity is not an outgoing activity.
+ */
+declare function useSendStatus(): readonly [ReadonlyMap<string, SendStatus>];
+
+/** @deprecated Please use "useGetSendTimeoutForActivity()" instead. */
+declare function useSendTimeoutForActivity(activity: WebChatActivity): number;
+
+declare function useSendTypingIndicator(): [boolean];
+
+declare function useSetNotification(): (notification: Notification) => void;
+
+declare function useShouldSpeakIncomingActivity(): [boolean, (value: boolean) => void];
+
+declare function useStartDictate(): () => void;
+
+declare function useStopDictate(): () => void;
+
+declare function useStyleOptions(): [StrictStyleOptions];
+
+declare function useSubmitSendBox(): (method?: string, { channelData }?: {
+    channelData: any;
+}) => void;
+
+declare function useSuggestedActions(): [
+    DirectLineCardAction[],
+    (suggestedActions: never[]) => void,
+    extras: {
+        activity: WebChatActivity;
+    }
+];
+
+declare function useTimeoutForSend(): [number | ((activity: WebChatActivity) => number)];
+
+declare function useTrackDimension(): (name: string, data: any) => void;
+
+type TrackEventFunction = {
+    (name: string, data: any): void;
+    debug: (name: string, data: any) => void;
+    error: (name: string, data: any) => void;
+    info: (name: string, data: any) => void;
+    warn: (name: string, data: any) => void;
+};
+declare function useTrackEvent(): TrackEventFunction;
+
+declare function useTrackException(): (error: Error, fatal: boolean) => void;
+
+declare function useTrackTiming<T>(): (name: string, functionOrPromise: (() => T) | Promise<T>) => Promise<T>;
+
+/**
+ * Gets the state of the UI.
+ *
+ * - `undefined` will render normally
+ * - `"blueprint"` will render as few UI elements as possible and should be non-functional
+ *   - Useful for loading scenarios
+ * - `"disabled"` will render most UI elements as non-functional
+ *   - Scrolling may continue to trigger read acknowledgements
+ */
+declare function useUIState(): readonly ['blueprint' | 'disabled' | undefined];
+
+declare function useUserID(): [string];
+
+declare function useUsername(): [string];
+
+declare function useVoiceSelector(activity: any): (voices: (typeof window.SpeechSynthesisVoice)[]) => typeof window.SpeechSynthesisVoice;
+
+declare const index_useActiveTyping: typeof useActiveTyping;
+declare const index_useActivities: typeof useActivities;
+declare const index_useActivityKeys: typeof useActivityKeys;
+declare const index_useActivityKeysByRead: typeof useActivityKeysByRead;
+declare const index_useAvatarForBot: typeof useAvatarForBot;
+declare const index_useAvatarForUser: typeof useAvatarForUser;
+declare const index_useByteFormatter: typeof useByteFormatter;
+declare const index_useConnectivityStatus: typeof useConnectivityStatus;
+declare const index_useCreateActivityRenderer: typeof useCreateActivityRenderer;
+declare const index_useCreateActivityStatusRenderer: typeof useCreateActivityStatusRenderer;
+declare const index_useCreateAttachmentForScreenReaderRenderer: typeof useCreateAttachmentForScreenReaderRenderer;
+declare const index_useCreateAvatarRenderer: typeof useCreateAvatarRenderer;
+declare const index_useCreateScrollToEndButtonRenderer: typeof useCreateScrollToEndButtonRenderer;
+declare const index_useDateFormatter: typeof useDateFormatter;
+declare const index_useDebouncedNotifications: typeof useDebouncedNotifications;
+declare const index_useDictateInterims: typeof useDictateInterims;
+declare const index_useDictateState: typeof useDictateState;
+declare const index_useDirection: typeof useDirection;
+declare const index_useDisabled: typeof useDisabled;
+declare const index_useDismissNotification: typeof useDismissNotification;
+declare const index_useEmitTypingIndicator: typeof useEmitTypingIndicator;
+declare const index_useGetActivitiesByKey: typeof useGetActivitiesByKey;
+declare const index_useGetActivityByKey: typeof useGetActivityByKey;
+declare const index_useGetKeyByActivity: typeof useGetKeyByActivity;
+declare const index_useGetKeyByActivityId: typeof useGetKeyByActivityId;
+declare const index_useGetSendTimeoutForActivity: typeof useGetSendTimeoutForActivity;
+declare const index_useGrammars: typeof useGrammars;
+declare const index_useGroupActivities: typeof useGroupActivities;
+declare const index_useGroupTimestamp: typeof useGroupTimestamp;
+declare const index_useLanguage: typeof useLanguage;
+declare const index_useLastAcknowledgedActivityKey: typeof useLastAcknowledgedActivityKey;
+declare const index_useLastReadActivityKey: typeof useLastReadActivityKey;
+declare const index_useLocalizer: typeof useLocalizer;
+declare const index_useMarkActivityAsSpoken: typeof useMarkActivityAsSpoken;
+declare const index_useMarkActivityKeyAsRead: typeof useMarkActivityKeyAsRead;
+declare const index_useMarkAllAsAcknowledged: typeof useMarkAllAsAcknowledged;
+declare const index_useNotifications: typeof useNotifications;
+declare const index_usePerformCardAction: typeof usePerformCardAction;
+declare const index_usePonyfill: typeof usePonyfill;
+declare const index_usePostActivity: typeof usePostActivity;
+declare const index_useReferenceGrammarID: typeof useReferenceGrammarID;
+declare const index_useRelativeTimeFormatter: typeof useRelativeTimeFormatter;
+declare const index_useRenderAttachment: typeof useRenderAttachment;
+declare const index_useRenderToast: typeof useRenderToast;
+declare const index_useRenderTypingIndicator: typeof useRenderTypingIndicator;
+declare const index_useSendBoxAttachments: typeof useSendBoxAttachments;
+declare const index_useSendBoxValue: typeof useSendBoxValue;
+declare const index_useSendEvent: typeof useSendEvent;
+declare const index_useSendFiles: typeof useSendFiles;
+declare const index_useSendMessage: typeof useSendMessage;
+declare const index_useSendMessageBack: typeof useSendMessageBack;
+declare const index_useSendPostBack: typeof useSendPostBack;
+declare const index_useSendTimeoutForActivity: typeof useSendTimeoutForActivity;
+declare const index_useSendTypingIndicator: typeof useSendTypingIndicator;
+declare const index_useSetNotification: typeof useSetNotification;
+declare const index_useShouldSpeakIncomingActivity: typeof useShouldSpeakIncomingActivity;
+declare const index_useStartDictate: typeof useStartDictate;
+declare const index_useStopDictate: typeof useStopDictate;
+declare const index_useStyleOptions: typeof useStyleOptions;
+declare const index_useSubmitSendBox: typeof useSubmitSendBox;
+declare const index_useSuggestedActions: typeof useSuggestedActions;
+declare const index_useTimeoutForSend: typeof useTimeoutForSend;
+declare const index_useTrackDimension: typeof useTrackDimension;
+declare const index_useTrackEvent: typeof useTrackEvent;
+declare const index_useTrackException: typeof useTrackException;
+declare const index_useTrackTiming: typeof useTrackTiming;
+declare const index_useUIState: typeof useUIState;
+declare const index_useUserID: typeof useUserID;
+declare const index_useUsername: typeof useUsername;
+declare const index_useVoiceSelector: typeof useVoiceSelector;
+declare namespace index {
+  export { index_useActiveTyping as useActiveTyping, index_useActivities as useActivities, index_useActivityKeys as useActivityKeys, index_useActivityKeysByRead as useActivityKeysByRead, index_useAvatarForBot as useAvatarForBot, index_useAvatarForUser as useAvatarForUser, index_useByteFormatter as useByteFormatter, index_useConnectivityStatus as useConnectivityStatus, index_useCreateActivityRenderer as useCreateActivityRenderer, index_useCreateActivityStatusRenderer as useCreateActivityStatusRenderer, index_useCreateAttachmentForScreenReaderRenderer as useCreateAttachmentForScreenReaderRenderer, index_useCreateAvatarRenderer as useCreateAvatarRenderer, index_useCreateScrollToEndButtonRenderer as useCreateScrollToEndButtonRenderer, index_useDateFormatter as useDateFormatter, index_useDebouncedNotifications as useDebouncedNotifications, index_useDictateInterims as useDictateInterims, index_useDictateState as useDictateState, index_useDirection as useDirection, index_useDisabled as useDisabled, index_useDismissNotification as useDismissNotification, index_useEmitTypingIndicator as useEmitTypingIndicator, index_useGetActivitiesByKey as useGetActivitiesByKey, index_useGetActivityByKey as useGetActivityByKey, useGetHasAcknoweledgedByActivityKey as useGetHasAcknowledgedByActivityKey, index_useGetKeyByActivity as useGetKeyByActivity, index_useGetKeyByActivityId as useGetKeyByActivityId, index_useGetSendTimeoutForActivity as useGetSendTimeoutForActivity, index_useGrammars as useGrammars, index_useGroupActivities as useGroupActivities, useGroupActivitiesBy as useGroupActivitiesByName, index_useGroupTimestamp as useGroupTimestamp, index_useLanguage as useLanguage, index_useLastAcknowledgedActivityKey as useLastAcknowledgedActivityKey, index_useLastReadActivityKey as useLastReadActivityKey, index_useLocalizer as useLocalizer, index_useMarkActivityAsSpoken as useMarkActivityAsSpoken, index_useMarkActivityKeyAsRead as useMarkActivityKeyAsRead, index_useMarkAllAsAcknowledged as useMarkAllAsAcknowledged, index_useNotifications as useNotifications, index_usePerformCardAction as usePerformCardAction, index_usePonyfill as usePonyfill, index_usePostActivity as usePostActivity, index_useReferenceGrammarID as useReferenceGrammarID, index_useRelativeTimeFormatter as useRelativeTimeFormatter, index_useRenderAttachment as useRenderAttachment, index_useRenderToast as useRenderToast, index_useRenderTypingIndicator as useRenderTypingIndicator, index_useSendBoxAttachments as useSendBoxAttachments, index_useSendBoxValue as useSendBoxValue, index_useSendEvent as useSendEvent, index_useSendFiles as useSendFiles, index_useSendMessage as useSendMessage, index_useSendMessageBack as useSendMessageBack, index_useSendPostBack as useSendPostBack, useSendStatus as useSendStatusByActivityKey, index_useSendTimeoutForActivity as useSendTimeoutForActivity, index_useSendTypingIndicator as useSendTypingIndicator, index_useSetNotification as useSetNotification, index_useShouldSpeakIncomingActivity as useShouldSpeakIncomingActivity, index_useStartDictate as useStartDictate, index_useStopDictate as useStopDictate, index_useStyleOptions as useStyleOptions, index_useSubmitSendBox as useSubmitSendBox, index_useSuggestedActions as useSuggestedActions, index_useTimeoutForSend as useTimeoutForSend, index_useTrackDimension as useTrackDimension, index_useTrackEvent as useTrackEvent, index_useTrackException as useTrackException, index_useTrackTiming as useTrackTiming, index_useUIState as useUIState, index_useUserID as useUserID, index_useUsername as useUsername, index_useVoiceSelector as useVoiceSelector };
+}
+
+type Work<T> = (...args: unknown[]) => T;
+type Enhancer<T> = (next: Work<T>) => Work<T>;
+type Middleware<Setup, Result> = (setup: Setup) => Enhancer<Result>;
+declare function concatMiddleware<Setup, Result>(...middleware: Middleware<Setup, Result>[]): Middleware<Setup, Result>;
+
+declare function localize(id: string, language: string, ...args: string[]): string | boolean;
+
+declare function normalizeStyleOptions({ hideScrollToEndButton, newMessagesButtonFontSize, ...options }?: StyleOptions): StrictStyleOptions;
+
+type WebSpeechPonyfill = {
+    /**
+     * Function to resume `AudioContext` object when called.
+     *
+     * Web Chat will call this function on user gestures to resume suspended `AudioContext`.
+     */
+    resumeAudioContext?: () => Promise<void>;
+    /** Polyfill for Web Speech API `SpeechGrammarList` class. */
+    SpeechGrammarList?: typeof SpeechGrammarList;
+    /** Polyfill for Web Speech API `SpeechRecognition` class. */
+    SpeechRecognition?: typeof SpeechRecognition;
+    /** Polyfill for Web Speech API `speechSynthesis` instance. */
+    speechSynthesis?: SpeechSynthesis;
+    /** Polyfill for Web Speech API `SpeechSynthesisUtterance` class. */
+    SpeechSynthesisUtterance?: typeof SpeechSynthesisUtterance;
+};
+
+type WebSpeechPonyfillFactory = ({ referenceGrammarID }: {
+    referenceGrammarID?: string;
+}) => WebSpeechPonyfill;
+
+declare const version: string;
+declare const buildInfo: {
+    buildTool: string;
+    moduleFormat: string;
+    version: string;
+};
+
+export { type ActivityComponentFactory, type ActivityMiddleware, type ActivityStatusMiddleware, type ActivityStatusRenderer, type AttachmentForScreenReaderComponentFactory, type AttachmentForScreenReaderMiddleware, type AttachmentMiddleware, type AvatarComponentFactory, type AvatarMiddleware, type CardActionMiddleware, Composer, type ComposerProps, type ContextOf, type DebouncedNotification, type DebouncedNotifications, type GroupActivities, type GroupActivitiesMiddleware, type Notification, type PerformCardAction, type PostActivityFile, type RenderActivityStatus, type RenderAttachment, type RenderToast, type RenderTypingIndicator, type ScrollToEndButtonComponentFactory, type ScrollToEndButtonMiddleware, type SendBoxMiddleware, type SendBoxMiddlewareProps, SendBoxMiddlewareProxy, type SendBoxMiddlewareRequest, type SendBoxToolbarMiddleware, type SendBoxToolbarMiddlewareProps, SendBoxToolbarMiddlewareProxy, type SendBoxToolbarMiddlewareRequest, type SendStatus, type StrictStyleOptions, type StyleOptions, type ToastMiddleware, type Typing, type TypingIndicatorMiddleware, type WebSpeechPonyfill, type WebSpeechPonyfillFactory, buildInfo, concatMiddleware, DEFAULT_OPTIONS as defaultStyleOptions, index as hooks, initSendBoxMiddleware, initSendBoxToolbarMiddleware, localize, normalizeStyleOptions, version };