@azure/communication-react 1.5.1-alpha-202304140012 → 1.5.1-alpha-202304172318

package/dist/communication-react.d.ts

@@ -30,6 +30,7 @@ import { CallEndReason } from '@azure/communication-calling';
 import { CallerInfo } from '@azure/communication-calling';
 import { CallKind } from '@azure/communication-calling';
 import { CallState as CallState_2 } from '@azure/communication-calling';
+import { CaptionsResultType } from '@azure/communication-calling';
 import { ChatClient } from '@azure/communication-chat';
 import { ChatClientOptions } from '@azure/communication-chat';
 import { ChatMessage as ChatMessage_2 } from '@azure/communication-chat';
@@ -88,6 +89,7 @@ import { RoomCallLocator } from '@azure/communication-calling';
 import { ScalingMode } from '@azure/communication-calling';
 import { SendMessageOptions } from '@azure/communication-chat';
 import { StartCallOptions } from '@azure/communication-calling';
+import { StartCaptionsOptions } from '@azure/communication-calling';
 import { TeamsCall } from '@azure/communication-calling';
 import { TeamsCallAgent } from '@azure/communication-calling';
 import { TeamsMeetingLinkLocator } from '@azure/communication-calling';
@@ -217,6 +219,61 @@ export declare type AreParamEqual<A extends (props: any) => JSX.Element | undefi
  */
 export declare type AreTypeEqual<A, B> = A extends B ? (B extends A ? true : false) : false;
 
+/**
+ * Options to display suggestions in the at mention scenario.
+ *
+ * @beta
+ */
+export declare interface AtMentionDisplayOptions {
+    /**
+     * Optional callback to override render of an mention in a message thread.
+     */
+    onRenderAtMentionSuggestion?: (suggestion: AtMentionSuggestion) => JSX.Element;
+}
+
+/**
+ * Options to lookup suggestions in the at mention scenario.
+ *
+ * @beta
+ */
+export declare interface AtMentionLookupOptions {
+    /**
+     * Optional string to set trigger keyword for mention a specific participant.
+     *
+     * @defaultValue `@`
+     */
+    trigger?: string;
+    /**
+     * Optional callback to fetch a list of at mention suggestions base on the query.
+     */
+    onQueryUpdated?: (query: string) => Promise<AtMentionSuggestion[]>;
+    /**
+     * Optional callback to render an item of the atMention suggestions list.
+     */
+    onRenderSuggestionItem?: (suggestion: AtMentionSuggestion, onSuggestionSelected?: (suggestion: AtMentionSuggestion) => void) => JSX.Element;
+}
+
+/**
+ * Options to lookup suggestions and display mentions in the at mention scenario.
+ *
+ * @beta
+ */
+export declare type AtMentionOptions = AtMentionLookupOptions & AtMentionDisplayOptions;
+
+/**
+ * At mention suggestion's state, as reflected in the UI.
+ *
+ * @beta
+ */
+export declare interface AtMentionSuggestion {
+    /** User ID of a mentioned participant or 'everyone' for an @everyone suggestion */
+    userId: string;
+    /** Type of an at mention suggestion */
+    suggestionType: string;
+    /** Display name of a mentioned participant */
+    displayName: string;
+}
+
 /**
  * @beta
  */
@@ -744,6 +801,25 @@ export declare interface CallAdapterCallOperations {
      * Continues into a call when the browser version is not supported.
      */
     allowUnsupportedBrowserVersion(): void;
+    /**
+     * Function to Start captions
+     * @param options - options for start captions
+     */
+    startCaptions(options?: StartCaptionsOptions): Promise<void>;
+    /**
+     * Function to set caption language
+     * @param language - language set for caption
+     */
+    setCaptionLanguage(language: string): Promise<void>;
+    /**
+     * Function to set spoken language
+     * @param language - spoken language
+     */
+    setSpokenLanguage(language: string): Promise<void>;
+    /**
+     * Funtion to stop captions
+     */
+    stopCaptions(): Promise<void>;
     /**
      * Start the blur video background effect.
      *
@@ -982,6 +1058,14 @@ export declare interface CallAdapterSubscribers {
      * Subscribe function for 'error' event.
      */
     on(event: 'error', listener: (e: AdapterError) => void): void;
+    /**
+     * Subscribe function for 'captionsReceived' event.
+     */
+    on(event: 'captionsReceived', listener: CaptionsReceivedListener): void;
+    /**
+     * Subscribe function for 'isCaptionsActiveChanged' event.
+     */
+    on(event: 'isCaptionsActiveChanged', listener: IsCaptionsActiveChangedListener): void;
     /**
      * Unsubscribe function for 'participantsJoined' event.
      */
@@ -1030,6 +1114,14 @@ export declare interface CallAdapterSubscribers {
      * Unsubscribe function for 'error' event.
      */
     off(event: 'error', listener: (e: AdapterError) => void): void;
+    /**
+     * Unsubscribe function for 'captionsReceived' event.
+     */
+    off(event: 'captionsReceived', listener: CaptionsReceivedListener): void;
+    /**
+     * Unsubscribe function for 'isCaptionsActiveChanged' event.
+     */
+    off(event: 'isCaptionsActiveChanged', listener: IsCaptionsActiveChangedListener): void;
 }
 
 /**
@@ -1734,6 +1826,70 @@ export declare interface CallCompositeStrings {
      * string to be used to announce when multiple unnamed participants have left at the same time.
      */
     manyUnnamedParticipantsLeft: string;
+    /**
+     * string to be used to open live captions contextual menu
+     */
+    liveCaptionsLabel?: string;
+    /**
+     * label for opening captions setting modal
+     */
+    captionsSettingsLabel?: string;
+    /**
+     * string to be used to start captions
+     */
+    startCaptionsButtonOnLabel?: string;
+    /**
+     * string to be used to stop captions
+     */
+    startCaptionsButtonOffLabel?: string;
+    /**
+     * tooltip string to be used to show captions is on
+     */
+    startCaptionsButtonTooltipOnContent?: string;
+    /**
+     *tooltip string to be used to show captions is off
+     */
+    startCaptionsButtonTooltipOffContent?: string;
+    /**
+     * captions setting modal title
+     */
+    captionsSettingsModalTitle?: string;
+    /**
+     * label for dropdown inside captions setting modal
+     */
+    captionsSettingsDropdownLabel?: string;
+    /**
+     * text under captions setting dropdown indicating what the dropdown is for
+     */
+    captionsSettingsDropdownInfoText?: string;
+    /**
+     * confirm button label in captions setting modal
+     */
+    captionsSettingsConfirmButtonLabel?: string;
+    /**
+     * cancel button label in captions setting modal
+     */
+    captionsSettingsCancelButtonLabel?: string;
+    /**
+     * arial label for captions setting modal
+     */
+    captionsSettingsModalAriaLabel?: string;
+    /**
+     * arial label for captions setting modal close button
+     */
+    captionsSettingsCloseModalButtonAriaLabel?: string;
+    /**
+     * label for more button inside captions banner
+     */
+    captionsBannerMoreButtonCallingLabel?: string;
+    /**
+     * arial label for more button inside captions banner
+     */
+    captionsBannerMoreButtonTooltip?: string;
+    /**
+     * list of key value pairs that pairs language code to language names
+     */
+    captionsAvailableLanguageStrings?: CaptionsAvailableLanguageStrings;
 }
 
 /**
@@ -1818,7 +1974,7 @@ export declare type CallErrors = {
  *
  * @public
  */
-export declare type CallErrorTarget = 'Call.addParticipant' | 'Call.dispose' | 'Call.feature' | 'Call.hangUp' | 'Call.hold' | 'Call.mute' | /* @conditional-compile-remove(calling-beta-sdk) */ 'Call.muteIncomingAudio' | 'Call.off' | 'Call.on' | 'Call.removeParticipant' | 'Call.resume' | 'Call.sendDtmf' | /* @conditional-compile-remove(calling-beta-sdk) */ 'Call.startAudio' | 'Call.startScreenSharing' | 'Call.startVideo' | 'Call.stopScreenSharing' | /* @conditional-compile-remove(calling-beta-sdk) */ 'Call.stopAudio' | 'Call.stopVideo' | 'Call.unmute' | /* @conditional-compile-remove(calling-beta-sdk) */ 'Call.unmuteIncomingAudio' | 'CallAgent.dispose' | 'CallAgent.feature' | 'CallAgent.join' | 'CallAgent.off' | 'CallAgent.on' | 'CallAgent.startCall' | 'CallClient.createCallAgent' | 'CallClient.createTeamsCallAgent' | 'CallClient.feature' | 'CallClient.getDeviceManager' | /* @conditional-compile-remove(calling-beta-sdk) */ 'CallClient.getEnvironmentInfo' | 'DeviceManager.askDevicePermission' | 'DeviceManager.getCameras' | 'DeviceManager.getMicrophones' | 'DeviceManager.getSpeakers' | 'DeviceManager.off' | 'DeviceManager.on' | 'DeviceManager.selectMicrophone' | 'DeviceManager.selectSpeaker' | 'IncomingCall.accept' | 'IncomingCall.reject' | /* @conditional-compile-remove(calling-beta-sdk) */ /* @conditional-compile-remove(teams-identity-support) */ 'TeamsCall.addParticipant' | /* @conditional-compile-remove(video-background-effects) */ 'VideoEffectsFeature.startEffects' | /* @conditional-compile-remove(calling-beta-sdk) */ 'CallAgent.handlePushNotification';
+export declare type CallErrorTarget = 'Call.addParticipant' | 'Call.dispose' | 'Call.feature' | 'Call.hangUp' | 'Call.hold' | 'Call.mute' | /* @conditional-compile-remove(calling-beta-sdk) */ 'Call.muteIncomingAudio' | 'Call.off' | 'Call.on' | 'Call.removeParticipant' | 'Call.resume' | 'Call.sendDtmf' | /* @conditional-compile-remove(calling-beta-sdk) */ 'Call.startAudio' | 'Call.startScreenSharing' | 'Call.startVideo' | 'Call.stopScreenSharing' | /* @conditional-compile-remove(calling-beta-sdk) */ 'Call.stopAudio' | 'Call.stopVideo' | 'Call.unmute' | /* @conditional-compile-remove(calling-beta-sdk) */ 'Call.unmuteIncomingAudio' | 'CallAgent.dispose' | 'CallAgent.feature' | 'CallAgent.join' | 'CallAgent.off' | 'CallAgent.on' | 'CallAgent.startCall' | 'CallClient.createCallAgent' | 'CallClient.createTeamsCallAgent' | 'CallClient.feature' | 'CallClient.getDeviceManager' | /* @conditional-compile-remove(calling-beta-sdk) */ 'CallClient.getEnvironmentInfo' | 'DeviceManager.askDevicePermission' | 'DeviceManager.getCameras' | 'DeviceManager.getMicrophones' | 'DeviceManager.getSpeakers' | 'DeviceManager.off' | 'DeviceManager.on' | 'DeviceManager.selectMicrophone' | 'DeviceManager.selectSpeaker' | 'IncomingCall.accept' | 'IncomingCall.reject' | /* @conditional-compile-remove(calling-beta-sdk) */ /* @conditional-compile-remove(teams-identity-support) */ 'TeamsCall.addParticipant' | /* @conditional-compile-remove(video-background-effects) */ 'VideoEffectsFeature.startEffects' | /* @conditional-compile-remove(calling-beta-sdk) */ 'CallAgent.handlePushNotification' | /* @conditional-compile-remove(calling-beta-sdk) */ 'Call.admit' | /* @conditional-compile-remove(calling-beta-sdk) */ 'Call.rejectParticipant' | /* @conditional-compile-remove(calling-beta-sdk) */ 'Call.admitAll';
 
 /**
  * Callback for {@link CallAdapterSubscribers} 'callIdChanged' event.
@@ -1994,6 +2150,10 @@ export declare interface CallState {
      * Proxy of {@link @azure/communication-calling#TranscriptionCallFeature}.
      */
     transcription: TranscriptionCallFeature;
+    /**
+     * Proxy of {@link @azure/communication-calling#TranscriptionCallFeature}.
+     */
+    captionsFeature: CaptionsCallFeatureState;
     /**
      * Proxy of {@link @azure/communication-calling#RecordingCallFeature}.
      */
@@ -2315,6 +2475,25 @@ export declare interface CallWithChatAdapterManagement {
      * Continues into a call when the browser version is not supported.
      */
     allowUnsupportedBrowserVersion(): void;
+    /**
+     * Function to Start captions
+     * @param options - options for start captions
+     */
+    startCaptions(options?: StartCaptionsOptions): Promise<void>;
+    /**
+     * Function to set caption language
+     * @param language - language set for caption
+     */
+    setCaptionLanguage(language: string): Promise<void>;
+    /**
+     * Function to set spoken language
+     * @param language - spoken language
+     */
+    setSpokenLanguage(language: string): Promise<void>;
+    /**
+     * Funtion to stop captions
+     */
+    stopCaptions(): Promise<void>;
     /**
      * Start the blur video background effect.
      *
@@ -2374,6 +2553,8 @@ export declare interface CallWithChatAdapterSubscriptions {
     on(event: 'selectedMicrophoneChanged', listener: PropertyChangedEvent): void;
     on(event: 'selectedSpeakerChanged', listener: PropertyChangedEvent): void;
     on(event: 'callError', listener: (e: AdapterError) => void): void;
+    on(event: 'captionsReceived', listener: CaptionsReceivedListener): void;
+    on(event: 'isCaptionsActiveChanged', listener: IsCaptionsActiveChangedListener): void;
     off(event: 'callEnded', listener: CallEndedListener): void;
     off(event: 'isMutedChanged', listener: IsMutedChangedListener): void;
     off(event: 'callIdChanged', listener: CallIdChangedListener): void;
@@ -2385,6 +2566,8 @@ export declare interface CallWithChatAdapterSubscriptions {
     off(event: 'selectedMicrophoneChanged', listener: PropertyChangedEvent): void;
     off(event: 'selectedSpeakerChanged', listener: PropertyChangedEvent): void;
     off(event: 'callError', listener: (e: AdapterError) => void): void;
+    off(event: 'captionsReceived', listener: CaptionsReceivedListener): void;
+    off(event: 'isCaptionsActiveChanged', listener: IsCaptionsActiveChangedListener): void;
     on(event: 'messageReceived', listener: MessageReceivedListener): void;
     on(event: 'messageSent', listener: MessageSentListener): void;
     on(event: 'messageRead', listener: MessageReadListener): void;
@@ -2699,6 +2882,18 @@ export declare interface CallWithChatCompositeStrings {
      * Only used with `mobileView` set to `true`.
      */
     moreDrawerSpeakerMenuTitle: string;
+    /**
+     * Title for the captions sub-menu in more button drawer.
+     *
+     * Only used with `mobileView` set to `true`.
+     */
+    moreDrawerCaptionsMenuTitle: string;
+    /**
+     * Title for the spoken language sub-menu in more button drawer.
+     *
+     * Only used with `mobileView` set to `true`.
+     */
+    moreDrawerSpokenLanguageMenuTitle: string;
     /**
      * {@Link CallWithChatComposite} control bar More button label
      */
@@ -2809,7 +3004,7 @@ export declare interface CallWithChatControlOptions extends CommonCallControlOpt
  *
  * @public
  */
-export declare type CallWithChatEvent = 'callError' | 'chatError' | 'callEnded' | 'isMutedChanged' | 'callIdChanged' | 'isLocalScreenSharingActiveChanged' | 'displayNameChanged' | 'isSpeakingChanged' | 'callParticipantsJoined' | 'callParticipantsLeft' | 'selectedMicrophoneChanged' | 'selectedSpeakerChanged' | 'messageReceived' | 'messageSent' | 'messageRead' | 'chatParticipantsAdded' | 'chatParticipantsRemoved';
+export declare type CallWithChatEvent = 'callError' | 'chatError' | 'callEnded' | 'isMutedChanged' | 'callIdChanged' | 'isLocalScreenSharingActiveChanged' | 'displayNameChanged' | 'isSpeakingChanged' | 'callParticipantsJoined' | 'callParticipantsLeft' | 'selectedMicrophoneChanged' | 'selectedSpeakerChanged' | /* @conditional-compile-remove(close-captions) */ 'isCaptionsActiveChanged' | /* @conditional-compile-remove(close-captions) */ 'captionsReceived' | 'messageReceived' | 'messageSent' | 'messageRead' | 'chatParticipantsAdded' | 'chatParticipantsRemoved';
 
 /**
  * @beta
@@ -3025,6 +3220,136 @@ export declare type CancelEditCallback = (messageId: string, metadata?: Record<s
     attachedFilesMetadata?: FileMetadata[];
 }) => void;
 
+/**
+ * @beta
+ * strings for captions setting modal
+ */
+export declare interface CaptionsAvailableLanguageStrings {
+    'ar-ae': string;
+    'ar-sa': string;
+    'da-dk': string;
+    'de-de': string;
+    'en-au': string;
+    'en-ca': string;
+    'en-gb': string;
+    'en-in': string;
+    'en-nz': string;
+    'en-us': string;
+    'es-es': string;
+    'es-mx': string;
+    'fi-fi': string;
+    'fr-ca': string;
+    'fr-fr': string;
+    'hi-in': string;
+    'it-it': string;
+    'ja-jp': string;
+    'ko-kr': string;
+    'nb-no': string;
+    'nl-be': string;
+    'nl-nl': string;
+    'pl-pl': string;
+    'pt-br': string;
+    'ru-ru': string;
+    'sv-se': string;
+    'zh-cn': string;
+    'zh-hk': string;
+    'cs-cz': string;
+    'pt-pt': string;
+    'tr-tr': string;
+    'vi-vn': string;
+    'th-th': string;
+    'he-il': string;
+    'cy-gb': string;
+    'uk-ua': string;
+    'el-gr': string;
+    'hu-hu': string;
+    'ro-ro': string;
+    'sk-sk': string;
+    'zh-tw': string;
+}
+
+/**
+ * @beta
+ */
+export declare interface CaptionsCallFeatureState {
+    /**
+     * supported spoken languages
+     */
+    supportedSpokenLanguages: string[];
+    /**
+     * array of received captions
+     */
+    captions: CaptionsInfo[];
+    /**
+     * whether captions is on/off
+     */
+    isCaptionsFeatureActive: boolean;
+    /**
+     * supported caption languages
+     */
+    supportedCaptionLanguages: string[];
+    /**
+     * current spoken language
+     */
+    currentSpokenLanguage: string;
+    /**
+     * current caption language
+     */
+    currentCaptionLanguage: string;
+}
+
+/**
+ * @beta
+ */
+export declare interface CaptionsInfo {
+    /**
+     * The state in which this caption data can be classified.
+     */
+    resultType: CaptionsResultType;
+    /**
+     * The information of the call participant who spoke the captioned text.
+     */
+    speaker: CallerInfo;
+    /**
+     * The language that the spoken words were interpretted as. Corresponds to the language specified in startCaptions / setSpokenLanguage.
+     */
+    spokenLanguage: string;
+    /**
+     * The caption text.
+     */
+    captionText: string;
+    /**
+     * Timestamp of when the captioned words were initially spoken.
+     */
+    timestamp: Date;
+    /**
+     * The language that the captions are presented in. Corresponds to the captionLanguage specified in startCaptions / setCaptionLanguage.
+     */
+    captionLanguage?: string;
+    /**
+     * The original spoken caption text prior to translating to subtitle language
+     */
+    spokenText?: string;
+}
+
+/**
+ * options bag to start captions
+ *
+ * @beta
+ */
+export declare type CaptionsOptions = {
+    spokenLanguage: string;
+};
+
+/**
+ * Callback for {@link CallAdapterSubscribers} 'captionsReceived' event.
+ *
+ * @beta
+ */
+export declare type CaptionsReceivedListener = (event: {
+    captionsInfo: CaptionsInfo;
+}) => void;
+
 /**
  * {@link ChatComposite} Adapter interface.
  *
@@ -3737,6 +4062,10 @@ export declare interface CommonCallingHandlers {
     onRemoveVideoBackgroundEffects: () => Promise<void>;
     onBlurVideoBackground: (backgroundBlurConfig?: BackgroundBlurConfig) => Promise<void>;
     onReplaceVideoBackground: (backgroundReplacementConfig: BackgroundReplacementConfig) => Promise<void>;
+    onStartCaptions: (options?: CaptionsOptions) => Promise<void>;
+    onStopCaptions: () => Promise<void>;
+    onSetSpokenLanguage: (language: string) => Promise<void>;
+    onSetCaptionLanguage: (language: string) => Promise<void>;
 }
 
 /**
@@ -4730,6 +5059,10 @@ export declare const DEFAULT_COMPONENT_ICONS: {
     VerticalGalleryLeftButton: JSX.Element;
     VerticalGalleryRightButton: JSX.Element;
     OptionsVideoBackgroundEffect: JSX.Element;
+    CaptionsIcon: JSX.Element;
+    CaptionsOffIcon: JSX.Element;
+    CaptionsSettingsIcon: JSX.Element;
+    ChangeSpokenLanguageIcon: JSX.Element;
 };
 
 /**
@@ -4841,6 +5174,10 @@ export declare const DEFAULT_COMPOSITE_ICONS: {
     VerticalGalleryLeftButton: JSX.Element;
     VerticalGalleryRightButton: JSX.Element;
     OptionsVideoBackgroundEffect: JSX.Element;
+    CaptionsIcon: JSX.Element;
+    CaptionsOffIcon: JSX.Element;
+    CaptionsSettingsIcon: JSX.Element;
+    ChangeSpokenLanguageIcon: JSX.Element;
 };
 
 /**
@@ -5857,6 +6194,10 @@ export declare interface _Identifiers {
     verticalGalleryVideoTile: string;
     /** `data-ui-id` value for `VerticalGallery` Component's page counter */
     verticalGalleryPageCounter: string;
+    /** `data-ui-id` value for `AtMentionFlyout` Component's suggestion list */
+    atMentionSuggestionList: string;
+    /** `data-ui-id` value for `AtMentionFlyout` Component's suggestion list item */
+    atMentionSuggestionItem: string;
 }
 
 /**
@@ -5905,6 +6246,15 @@ export declare interface IncomingCallState {
     endTime?: Date;
 }
 
+/**
+ * Callback for {@link CallAdapterSubscribers} 'isCaptionsActiveChanged' event.
+ *
+ * @beta
+ */
+export declare type IsCaptionsActiveChangedListener = (event: {
+    isActive: boolean;
+}) => void;
+
 /**
  * Callback for {@link CallAdapterSubscribers} 'isLocalScreenSharingActiveChanged' event.
  *
@@ -6430,6 +6780,11 @@ export declare type MessageThreadProps = {
      * @beta
      */
     onDisplayDateTimeString?: (messageDate: Date) => string;
+    /**
+     * Optional props needed to lookup suggestions and display mentions in the at mention scenario.
+     * @beta
+     */
+    atMentionOptions?: AtMentionOptions;
 };
 
 /**
@@ -7317,7 +7672,7 @@ export declare interface RemoteVideoTileMenuOptions {
  * @beta
  * The role of a call participant.
  */
-export declare type Role = 'Presenter' | 'Attendee' | 'Consumer' | 'Organizer';
+export declare type Role = 'Presenter' | 'Attendee' | 'Consumer' | 'Organizer' | 'Co-organizer';
 
 /**
  * A button to start / stop screen sharing.
@@ -7429,6 +7784,11 @@ export declare interface SendBoxProps {
      * Optional callback called when message is sent
      */
     onSendMessage?: (content: string) => Promise<void>;
+    /**
+     * Optional props needed to lookup suggestions in the at mention scenario.
+     * @beta
+     */
+    atMentionLookupOptions?: AtMentionLookupOptions;
     /**
      * Optional callback called when user is typing
      */