@azure/communication-react 1.7.0-beta.2 → 1.7.1-alpha-202308172328

package/dist/communication-react.d.ts

@@ -17,8 +17,10 @@
 
 import { AddPhoneNumberOptions } from '@azure/communication-calling';
 import { AudioDeviceInfo } from '@azure/communication-calling';
-import { BackgroundBlurConfig } from '@azure/communication-calling-effects';
-import { BackgroundReplacementConfig } from '@azure/communication-calling-effects';
+import { BackgroundBlurConfig } from '@azure/communication-calling';
+import { BackgroundBlurEffect } from '@azure/communication-calling';
+import { BackgroundReplacementConfig } from '@azure/communication-calling';
+import { BackgroundReplacementEffect } from '@azure/communication-calling';
 import { Call } from '@azure/communication-calling';
 import { CallAgent } from '@azure/communication-calling';
 import { CallClient } from '@azure/communication-calling';
@@ -56,6 +58,7 @@ import { IContextualMenuStyles } from '@fluentui/react';
 import { ILinkStyles } from '@fluentui/react';
 import { IMessageBarProps } from '@fluentui/react';
 import { IncomingCall } from '@azure/communication-calling';
+import { IPersonaProps } from '@fluentui/react';
 import { IPersonaStyleProps } from '@fluentui/react';
 import { IPersonaStyles } from '@fluentui/react';
 import { IRawStyle } from '@fluentui/react';
@@ -73,6 +76,7 @@ import { MicrosoftTeamsUserIdentifier } from '@azure/communication-common';
 import { MicrosoftTeamsUserKind } from '@azure/communication-common';
 import type { NetworkDiagnosticChangedEventArgs } from '@azure/communication-calling';
 import { PartialTheme } from '@fluentui/react';
+import { ParticipantCapabilities } from '@azure/communication-calling';
 import { ParticipantRole } from '@azure/communication-calling';
 import { PermissionConstraints } from '@azure/communication-calling';
 import { PersonaInitialsColor } from '@fluentui/react';
@@ -89,6 +93,7 @@ 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 { SyntheticEvent } from 'react';
 import { TeamsCall } from '@azure/communication-calling';
 import { TeamsCallAgent } from '@azure/communication-calling';
 import { TeamsMeetingLinkLocator } from '@azure/communication-calling';
@@ -313,14 +318,7 @@ export declare type AzureCommunicationCallAdapterArgs = {
  *
  * @beta
  */
-export declare type AzureCommunicationCallAdapterOptions = {
-    /**
-     * Use this to hint the role of the user when the role is not available before a Rooms call is started. This value
-     * should be obtained using the Rooms API. This role will determine permissions in the configuration page of the
-     * {@link CallComposite}. The true role of the user will be synced with ACS services when a Rooms call starts.
-     */
-    roleHint?: Role;
-} & CommonCallAdapterOptions;
+export declare type AzureCommunicationCallAdapterOptions = CommonCallAdapterOptions;
 
 /**
  * Arguments for {@link createAzureCommunicationCallWithChatAdapter}
@@ -615,12 +613,23 @@ export declare interface BrowserPermissionDeniedStyles extends BaseCustomStyles
 export declare interface CallAdapter extends CommonCallAdapter {
     /**
      * Join the call with microphone initially on/off.
-     *
+     * @deprecated Use joinCall(options?:JoinCallOptions) instead.
      * @param microphoneOn - Whether microphone is initially enabled
      *
      * @public
      */
     joinCall(microphoneOn?: boolean): Call | undefined;
+    /**
+     * Join the call with options bag to set microphone/camera initial state when joining call
+     * true = turn on the device when joining call
+     * false = turn off the device when joining call
+     * 'keep'/undefined = retain devices' precall state
+     *
+     * @param options - param to set microphone/camera initially on/off/use precall state.
+     *
+     * @public
+     */
+    joinCall(options?: JoinCallOptions): Call | undefined;
     /**
      * Start the call.
      *
@@ -654,12 +663,23 @@ export declare type CallAdapterCallEndedEvent = {
 export declare interface CallAdapterCallManagement extends CallAdapterCallOperations {
     /**
      * Join the call with microphone initially on/off.
-     *
+     * @deprecated Use joinCall(options?:JoinCallOptions) instead.
      * @param microphoneOn - Whether microphone is initially enabled
      *
      * @public
      */
     joinCall(microphoneOn?: boolean): Call | undefined;
+    /**
+     * Join the call with options bag to set microphone/camera initial state when joining call
+     * true = turn on the device when joining call
+     * false = turn off the device when joining call
+     * 'keep'/undefined = retain devices' precall state
+     *
+     * @param options - param to set microphone/camera initially on/off/use precall state.
+     *
+     * @public
+     */
+    joinCall(options?: JoinCallOptions): Call | undefined;
     /**
      * Start the call.
      *
@@ -724,6 +744,18 @@ export declare interface CallAdapterCallOperations {
      * @public
      */
     startScreenShare(): Promise<void>;
+    /**
+     * Raise hand for current user
+     *
+     * @public
+     */
+    raiseHand(): Promise<void>;
+    /**
+     * lower hand for current user
+     *
+     * @public
+     */
+    lowerHand(): Promise<void>;
     /**
      * Stop sharing the screen
      *
@@ -883,6 +915,10 @@ export declare type CallAdapterClientState = {
     devices: DeviceManagerState;
     endedCall?: CallState;
     isTeamsCall: boolean;
+    /**
+     * State to track whether the call is a rooms call.
+     */
+    isRoomsCall: boolean;
     /**
      * Latest error encountered for each operation performed via the adapter.
      */
@@ -895,12 +931,6 @@ export declare type CallAdapterClientState = {
      * Environment information about system the adapter is made on
      */
     environmentInfo?: EnvironmentInfo;
-    /**
-     * Use this to hint the role of the user when the role is not available before a Rooms call is started. This value
-     * should be obtained using the Rooms API. This role will determine permissions in the configuration page of the
-     * {@link CallComposite}. The true role of the user will be synced with ACS services when a Rooms call starts.
-     */
-    roleHint?: Role;
     /**
      * State to track whether the local participant's camera is on. To be used when creating a custom
      * control bar with the CallComposite.
@@ -910,6 +940,10 @@ export declare type CallAdapterClientState = {
      * Default set of background images for background replacement effect.
      */
     videoBackgroundImages?: VideoBackgroundImage[];
+    /**
+     * Dependency to be injected for video background effect.
+     */
+    onResolveVideoEffectDependency?: () => Promise<VideoBackgroundEffectsDependency>;
     /**
      * State to track the selected video background effect.
      */
@@ -1331,6 +1365,10 @@ export declare type CallCompositeIcons = {
     ControlButtonParticipants?: JSX.Element;
     ControlButtonScreenShareStart?: JSX.Element;
     ControlButtonScreenShareStop?: JSX.Element;
+    ControlButtonRaiseHand?: JSX.Element;
+    ControlButtonLowerHand?: JSX.Element;
+    RaiseHandContextualMenuItem?: JSX.Element;
+    LowerHandContextualMenuItem?: JSX.Element;
     ErrorBarCallCameraAccessDenied?: JSX.Element;
     ErrorBarCallCameraAlreadyInUse?: JSX.Element;
     ErrorBarCallLocalVideoFreeze?: JSX.Element;
@@ -1369,9 +1407,14 @@ export declare type CallCompositeIcons = {
     PeoplePaneAddPerson?: JSX.Element;
     PeoplePaneOpenDialpad?: JSX.Element;
     DialpadStartCall?: JSX.Element;
-    NoticePageInvalidRoom?: JSX.Element;
+    NoticePageAccessDeniedRoomsCall?: JSX.Element;
     BlurVideoBackground?: JSX.Element;
     RemoveVideoBackgroundEffect?: JSX.Element;
+    GalleryOptions?: JSX.Element;
+    SpeakerGalleryLayout?: JSX.Element;
+    FloatingLocalVideoGalleryLayout?: JSX.Element;
+    DefaultGalleryLayout?: JSX.Element;
+    OverflowGalleryTop?: JSX.Element;
 };
 
 /**
@@ -1452,6 +1495,15 @@ export declare type CallCompositeOptions = {
      * @remarks if 'false' the local video tile will not be rendered.
      */
     localVideoTile?: boolean | LocalVideoTileOptions;
+    /**
+     * Options for controlling the starting layout of the composite's video gallery
+     */
+    galleryOptions?: {
+        /**
+         * Layout for the gallery when the call starts
+         */
+        layout?: VideoGalleryLayout;
+    };
 };
 
 /**
@@ -2001,6 +2053,26 @@ export declare interface CallCompositeStrings {
      * More details text of the page shown to the user when target participant id is malformed
      */
     participantIdIsMalformedMoreDetails?: string;
+    /**
+     * Controls label to move the overflow gallery around
+     */
+    moreButtonGalleryControlLabel?: string;
+    /**
+     * Label for the toggle to move the overflow gallery to the top
+     */
+    moreButtonGalleryPositionToggleLabel?: string;
+    /**
+     * Label for the selection of the speaker layout
+     */
+    moreButtonGallerySpeakerLayoutLabel?: string;
+    /**
+     * Label for the selection of the default (Gallery) layout
+     */
+    moreButtonGalleryDefaultLayoutLabel?: string;
+    /**
+     * Label for the selection of the floatingLocalVideo (Dynamic) layout
+     */
+    moreButtonGalleryFloatingLocalLayoutLabel?: string;
 }
 
 /**
@@ -2015,7 +2087,7 @@ export declare type CallControlDisplayType = 'default' | 'compact';
  *
  * @public
  */
-export declare type CallControlOptions = (CommonCallControlOptions & {
+export declare type CallControlOptions = CommonCallControlOptions & {
     /**
      * Show, Hide or Disable participants button during a call. This is the option only work for legacyControl bar.
      * @defaultValue true
@@ -2024,7 +2096,7 @@ export declare type CallControlOptions = (CommonCallControlOptions & {
         disabled: boolean;
     };
     legacyControlBarExperience?: boolean;
-});
+};
 
 /**
  * Callback for {@link CallAdapterSubscribers} 'callEnded' event.
@@ -2117,6 +2189,14 @@ export declare interface CallingHandlers extends CommonCallingHandlers {
     onStartCall: (participants: CommunicationIdentifier[], options?: StartCallOptions) => Call | undefined;
 }
 
+/**
+ * Configuration options to include video effect background dependency.
+ * @beta
+ */
+export declare type CallingHandlersOptions = {
+    onResolveVideoBackgroundEffectsDependency?: () => Promise<VideoBackgroundEffectsDependency>;
+};
+
 /**
  * Helper type for {@link usePropsFor}.
  *
@@ -2135,6 +2215,7 @@ export declare interface CallingTheme {
         callRedDark: string;
         callRedDarker: string;
         iconWhite: string;
+        raiseHandGold: string;
     };
 }
 
@@ -2152,8 +2233,8 @@ export declare type CallParticipantListParticipant = ParticipantListParticipant
     isMuted?: boolean;
     /** Whether calling participant is speaking */
     isSpeaking?: boolean;
-    /** Role of participant in Rooms call */
-    role?: Role;
+    /** Whether calling participant is raised hand */
+    raisedHand?: RaisedHand;
 };
 
 /**
@@ -2273,6 +2354,10 @@ export declare interface CallState {
      * Proxy of {@link @azure/communication-calling#RecordingCallFeature}.
      */
     recording: RecordingCallFeature;
+    /**
+     * Proxy of {@link @azure/communication-calling#RaiseHandCallFeature}.
+     */
+    raiseHand: RaiseHandCallFeature;
     /**
      * Stores the currently active screenshare participant's key. If there is no screenshare active, then this will be
      * undefined. You can use this key to access the remoteParticipant data in {@link CallState.remoteParticipants} object.
@@ -2309,6 +2394,10 @@ export declare interface CallState {
      * Transfer state of call
      */
     transfer: TransferFeature;
+    /**
+     * Proxy of {@link @azure/communication-calling#CapabilitiesFeature}.
+     */
+    capabilities?: CapabilitiesCallFeature;
 }
 
 /**
@@ -2340,12 +2429,23 @@ export declare interface CallWithChatAdapterManagement {
     removeParticipant(participant: CommunicationIdentifier): Promise<void>;
     /**
      * Join the call with microphone initially on/off.
-     *
+     * @deprecated Use joinCall(options?:JoinCallOptions) instead.
      * @param microphoneOn - Whether microphone is initially enabled
      *
      * @public
      */
     joinCall(microphoneOn?: boolean): Call | undefined;
+    /**
+     * Join the call with options bag to set microphone/camera initial state when joining call
+     * true = turn on the device when joining call
+     * false = turn off the device when joining call
+     * 'keep'/undefined = retain devices' precall state
+     *
+     * @param options - param to set microphone/camera initially on/off/use precall state.
+     *
+     * @public
+     */
+    joinCall(options?: JoinCallOptions): Call | undefined;
     /**
      * Leave the call.
      *
@@ -2410,6 +2510,18 @@ export declare interface CallWithChatAdapterManagement {
      * @public
      */
     stopScreenShare(): Promise<void>;
+    /**
+     * Raise hand for local user.
+     *
+     * @public
+     */
+    raiseHand(): Promise<void>;
+    /**
+     * Lower hand for local user.
+     *
+     * @public
+     */
+    lowerHand(): Promise<void>;
     /**
      * Create the html view for a stream.
      *
@@ -2780,12 +2892,16 @@ export declare interface CallWithChatClientState {
     devices: DeviceManagerState;
     /** State of whether the active call is a Teams interop call */
     isTeamsCall: boolean;
+    /** State of whether the active call is a rooms call */
+    isRoomsCall: boolean;
     /** alternateCallerId for PSTN call */
     alternateCallerId?: string | undefined;
     /** Environment information for system adapter is made on */
     environmentInfo?: EnvironmentInfo;
     /** Default set of background images for background replacement effect */
     videoBackgroundImages?: VideoBackgroundImage[];
+    /** Dependency to be injected for video background effects */
+    onResolveVideoEffectDependency?: () => Promise<VideoBackgroundEffectsDependency>;
     /** State to track the selected video background effect */
     selectedVideoBackgroundEffect?: VideoBackgroundEffect;
 }
@@ -2939,6 +3055,15 @@ export declare type CallWithChatCompositeOptions = {
      * if this is not supplied, the composite will not show a unsupported browser page.
      */
     onEnvironmentInfoTroubleshootingClick?: () => void;
+    /**
+     * Options for controlling the starting layout of the composite's video gallery
+     */
+    galleryOptions?: {
+        /**
+         * Layout for the gallery when the call starts
+         */
+        layout?: VideoGalleryLayout;
+    };
 };
 
 /**
@@ -3364,6 +3489,18 @@ export declare type CameraSitePermissionsStrings = SitePermissionsStrings;
  */
 export declare type CancelEditCallback = (messageId: string) => void;
 
+/**
+ * State only version of {@link @azure/communication-calling#CapabilitiesFeature}
+ *
+ * @beta
+ */
+export declare interface CapabilitiesCallFeature {
+    /**
+     * Proxy of {@link @azure/communication-calling#CapabilitiesFeature.capabilities}.
+     */
+    capabilities: ParticipantCapabilities;
+}
+
 /**
  * @beta
  * strings for captions setting modal
@@ -3503,7 +3640,7 @@ export declare type CaptionsReceivedListener = (event: {
  *
  * @public
  */
-export declare type ChatAdapter = ChatAdapterThreadManagement & AdapterState<ChatAdapterState> & Disposable & ChatAdapterSubscribers & /* @conditional-compile-remove(file-sharing) */ FileUploadAdapter;
+export declare type ChatAdapter = ChatAdapterThreadManagement & AdapterState<ChatAdapterState> & Disposable & ChatAdapterSubscribers & FileUploadAdapter;
 
 /**
  * {@link ChatAdapter} state.
@@ -3611,7 +3748,7 @@ export declare interface ChatAdapterThreadManagement {
     /**
      * Update a message content.
      */
-    updateMessage(messageId: string, content: string, metadata?: Record<string, string>, /* @conditional-compile-remove(file-sharing) */ options?: {
+    updateMessage(messageId: string, content: string, metadata?: Record<string, string>, options?: {
         attachedFilesMetadata?: FileMetadata[];
     }): Promise<void>;
     /**
@@ -3901,7 +4038,7 @@ export declare type ChatHandlers = {
     onRemoveParticipant: (userId: string) => Promise<void>;
     updateThreadTopicName: (topicName: string) => Promise<void>;
     onLoadPreviousChatMessages: (messagesToLoad: number) => Promise<boolean>;
-    onUpdateMessage: (messageId: string, content: string, /* @conditional-compile-remove(file-sharing) */ metadata?: Record<string, string>, /* @conditional-compile-remove(file-sharing) */ options?: {
+    onUpdateMessage: (messageId: string, content: string, metadata?: Record<string, string>, options?: {
         attachedFilesMetadata?: FileMetadata[];
     }) => Promise<void>;
     onDeleteMessage: (messageId: string) => Promise<void>;
@@ -4069,12 +4206,23 @@ export declare type Common<A, B> = Pick<A, CommonProperties<A, B>>;
 export declare interface CommonCallAdapter extends AdapterState<CallAdapterState>, Disposable, CallAdapterCallOperations, CallAdapterDeviceManagement, CallAdapterSubscribers {
     /**
      * Join the call with microphone initially on/off.
-     *
+     * @deprecated Use joinCall(options?:JoinCallOptions) instead.
      * @param microphoneOn - Whether microphone is initially enabled
      *
      * @public
      */
     joinCall(microphoneOn?: boolean): void;
+    /**
+     * Join the call with options bag to set microphone/camera initial state when joining call
+     * true = turn on the device when joining call
+     * false = turn off the device when joining call
+     * 'keep'/undefined = retain devices' precall state
+     *
+     * @param options - param to set microphone/camera initially on/off/use precall state.
+     *
+     * @public
+     */
+    joinCall(options?: JoinCallOptions): void;
     /**
      * Start the call.
      *
@@ -4100,7 +4248,10 @@ export declare type CommonCallAdapterOptions = {
     /**
      * Default set of background images for background image picker.
      */
-    videoBackgroundImages?: VideoBackgroundImage[];
+    videoBackgroundOptions?: {
+        videoBackgroundImages?: VideoBackgroundImage[];
+        onResolveDependency?: () => Promise<VideoBackgroundEffectsDependency>;
+    };
     /**
      * Use this to fetch profile information which will override data in {@link CallAdapterState} like display name
      * The onFetchProfile is fetch-and-forget one time action for each user, once a user profile is updated, the value will be cached
@@ -4170,6 +4321,13 @@ export declare type CommonCallControlOptions = {
      * @defaultValue true
      */
     moreButton?: boolean;
+    /**
+     * Show, Hide or Disable the screen share button during a call.
+     * @defaultValue true
+     */
+    raiseHandButton?: boolean | {
+        disabled: boolean;
+    };
     /**
      * Inject custom buttons in the call controls.
      *
@@ -4207,6 +4365,9 @@ export declare interface CommonCallingHandlers {
     onStopScreenShare: () => Promise<void>;
     onToggleScreenShare: () => Promise<void>;
     onHangUp: (forEveryone?: boolean) => Promise<void>;
+    onRaiseHand: () => Promise<void>;
+    onLowerHand: () => Promise<void>;
+    onToggleRaiseHand: () => Promise<void>;
     onToggleHold: () => Promise<void>;
     onAddParticipant(participant: CommunicationUserIdentifier): Promise<void>;
     onAddParticipant(participant: PhoneNumberIdentifier, options: AddPhoneNumberOptions): Promise<void>;
@@ -4495,6 +4656,8 @@ export declare interface ComponentStrings {
     participantsButton: ParticipantsButtonStrings;
     /** Strings for ScreenShareButton */
     screenShareButton: ScreenShareButtonStrings;
+    /** Strings for RaiseHandButton */
+    raiseHandButton: RaiseHandButtonStrings;
     /** Strings for TypingIndicator */
     typingIndicator: TypingIndicatorStrings;
     /** Strings for SendBox */
@@ -4551,6 +4714,8 @@ export declare interface ComponentStrings {
      * Strings for the VerticalGallery.
      */
     VerticalGallery: VerticalGalleryStrings;
+    /** Strings for the participant list component */
+    ParticipantList: ParticipantListStrings;
 }
 
 /**
@@ -4917,7 +5082,7 @@ export declare const createAzureCommunicationCallAdapter: ({ userId, displayName
  *
  * @public
  */
-export declare const createAzureCommunicationCallAdapterFromClient: (callClient: StatefulCallClient, callAgent: CallAgent, locator: CallAdapterLocator, /* @conditional-compile-remove(rooms) */ /* @conditional-compile-remove(video-background-effects) */ options?: AzureCommunicationCallAdapterOptions) => Promise<CallAdapter>;
+export declare const createAzureCommunicationCallAdapterFromClient: (callClient: StatefulCallClient, callAgent: CallAgent, locator: CallAdapterLocator, options?: AzureCommunicationCallAdapterOptions) => Promise<CallAdapter>;
 
 /**
  * Create a CallWithChatAdapter backed by Azure Communication services
@@ -4931,6 +5096,7 @@ export declare const createAzureCommunicationCallWithChatAdapter: ({ userId, dis
  * Create a {@link CallWithChatAdapter} using the provided {@link StatefulChatClient} and {@link StatefulCallClient}.
  *
  * Useful if you want to keep a reference to {@link StatefulChatClient} and {@link StatefulCallClient}.
+ * Please note that chatThreadClient has to be created by StatefulChatClient via chatClient.getChatThreadClient(chatThreadId) API.
  * Consider using {@link createAzureCommunicationCallWithChatAdapter} for a simpler API.
  *
  * @public
@@ -4954,10 +5120,17 @@ export declare const createAzureCommunicationChatAdapter: ({ endpoint: endpointU
  *
  * @public
  */
-export declare function createAzureCommunicationChatAdapterFromClient(chatClient: StatefulChatClient, chatThreadClient: ChatThreadClient, /* @conditional-compile-remove(teams-inline-images-and-file-sharing) */ options?: {
+export declare function createAzureCommunicationChatAdapterFromClient(chatClient: StatefulChatClient, chatThreadClient: ChatThreadClient, options?: {
     credential?: CommunicationTokenCredential;
 }): Promise<ChatAdapter>;
 
+/**
+ * Type of {@link createDefaultCallingHandlers}.
+ *
+ * @public
+ */
+export declare type CreateDefaultCallingHandlers = (callClient: StatefulCallClient, callAgent: CallAgent | undefined, deviceManager: StatefulDeviceManager | undefined, call: Call | undefined, options?: CallingHandlersOptions) => CallingHandlers;
+
 /**
  * Create the default implementation of {@link CallingHandlers} for teams call.
  *
@@ -4966,7 +5139,7 @@ export declare function createAzureCommunicationChatAdapterFromClient(chatClient
  *
  * @public
  */
-export declare const createDefaultCallingHandlers: (callClient: StatefulCallClient, callAgent: CallAgent | undefined, deviceManager: StatefulDeviceManager | undefined, call: Call | undefined) => CallingHandlers;
+export declare const createDefaultCallingHandlers: CreateDefaultCallingHandlers;
 
 /**
  * Create the default implementation of {@link ChatHandlers}.
@@ -4988,7 +5161,9 @@ export declare const createDefaultChatHandlers: (chatClient: StatefulChatClient,
  *
  * @beta
  */
-export declare const createDefaultTeamsCallingHandlers: (callClient: StatefulCallClient, callAgent: undefined | /* @conditional-compile-remove(teams-identity-support) */ TeamsCallAgent, deviceManager: StatefulDeviceManager | undefined, call: undefined | /* @conditional-compile-remove(teams-identity-support) */ TeamsCall) => never | TeamsCallingHandlers;
+export declare const createDefaultTeamsCallingHandlers: (callClient: StatefulCallClient, callAgent: undefined | /* @conditional-compile-remove(teams-identity-support) */ TeamsCallAgent, deviceManager: StatefulDeviceManager | undefined, call: undefined | /* @conditional-compile-remove(teams-identity-support) */ TeamsCall, options?: {
+    onResolveVideoBackgroundEffectsDependency?: (() => Promise<VideoBackgroundEffectsDependency>) | undefined;
+} | undefined) => never | TeamsCallingHandlers;
 
 /**
  * Creates a StatefulCallClient {@link StatefulCallClient} by proxying CallClient
@@ -5243,7 +5418,7 @@ export declare const darkTheme: PartialTheme & CallingTheme;
  * @beta
  * `DeclarativeCallAgent` extends and proxies the {@link @azure/communication-calling#CallAgent}
  */
-export declare type DeclarativeCallAgent = CallAgent & /* @conditional-compile-remove(one-to-n-calling) */ IncomingCallManagement;
+export declare type DeclarativeCallAgent = CallAgent & IncomingCallManagement;
 
 /**
  * @beta
@@ -5270,6 +5445,10 @@ export declare const DEFAULT_COMPONENT_ICONS: {
     ControlButtonParticipantsContextualMenuItem: JSX.Element;
     ControlButtonScreenShareStart: JSX.Element;
     ControlButtonScreenShareStop: JSX.Element;
+    ControlButtonRaiseHand: JSX.Element;
+    ControlButtonLowerHand: JSX.Element;
+    RaiseHandContextualMenuItem: JSX.Element;
+    LowerHandContextualMenuItem: JSX.Element;
     CancelFileUpload: JSX.Element;
     DownloadFile: JSX.Element;
     DataLossPreventionProhibited: JSX.Element;
@@ -5371,6 +5550,10 @@ export declare const DEFAULT_COMPOSITE_ICONS: {
     ControlButtonParticipants: JSX.Element;
     ControlButtonScreenShareStart: JSX.Element;
     ControlButtonScreenShareStop: JSX.Element;
+    ControlButtonRaiseHand: JSX.Element;
+    ControlButtonLowerHand: JSX.Element;
+    RaiseHandContextualMenuItem: JSX.Element;
+    LowerHandContextualMenuItem: JSX.Element;
     ErrorBarCallCameraAccessDenied: JSX.Element;
     ErrorBarCallCameraAlreadyInUse: JSX.Element;
     ErrorBarCallLocalVideoFreeze: JSX.Element;
@@ -5407,9 +5590,14 @@ export declare const DEFAULT_COMPOSITE_ICONS: {
     PeoplePaneAddPerson?: JSX.Element | undefined;
     PeoplePaneOpenDialpad?: JSX.Element | undefined;
     DialpadStartCall?: JSX.Element | undefined;
-    NoticePageInvalidRoom?: JSX.Element | undefined;
+    NoticePageAccessDeniedRoomsCall?: JSX.Element | undefined;
     BlurVideoBackground?: JSX.Element | undefined;
     RemoveVideoBackgroundEffect?: JSX.Element | undefined;
+    GalleryOptions?: JSX.Element | undefined;
+    SpeakerGalleryLayout?: JSX.Element | undefined;
+    FloatingLocalVideoGalleryLayout?: JSX.Element | undefined;
+    DefaultGalleryLayout?: JSX.Element | undefined;
+    OverflowGalleryTop?: JSX.Element | undefined;
     ChevronLeft?: JSX.Element | undefined;
     ControlBarChatButtonActive?: JSX.Element | undefined;
     ControlBarChatButtonInactive?: JSX.Element | undefined;
@@ -6487,6 +6675,59 @@ export declare interface ImageFileMetadata extends BaseFileMetadata {
     previewUrl?: string;
 }
 
+/**
+ * Component to render a fullscreen modal for a selected image.
+ *
+ * @beta
+ */
+export declare const ImageGallery: (props: ImageGalleryProps) => JSX.Element;
+
+/**
+ * Props for {@link ImageGallery}.
+ *
+ * @beta
+ */
+export declare interface ImageGalleryImageProps {
+    /** Image Url used to display the image in a large scale. */
+    imageUrl: string;
+    /** String used as a file name when downloading this image to user's local device. */
+    saveAsName: string;
+    /** Optional string used as a alt text for the image. @default 'image' */
+    altText?: string;
+    /** Optional string used as the title of the image and displayed on the top left corner of the ImageGallery. */
+    title?: string;
+    /** Optional JSX element used as a title icon and displayed to the left of the title element. */
+    titleIcon?: JSX.Element;
+}
+
+/**
+ * Props for {@link ImageGallery}.
+ *
+ * @beta
+ */
+export declare interface ImageGalleryProps {
+    /**
+     * Array of images used to populate the ImageGallery
+     */
+    images: Array<ImageGalleryImageProps>;
+    /**
+     * Callback to invoke when the ImageGallery modal is dismissed
+     */
+    onDismiss: () => void;
+    /**
+     * Callback called when the download button is clicked.
+     */
+    onImageDownloadButtonClicked: (imageUrl: string, saveAsName: string) => void;
+    /**
+     * Callback called when there's an error loading the image.
+     */
+    onError?: (event: SyntheticEvent<HTMLImageElement, Event>) => void;
+    /**
+     * Indicating which index of the images array to start with.
+     */
+    startIndex?: number;
+}
+
 /**
  * @beta
  * This contains a readonly array that returns all the active `incomingCalls`.
@@ -6571,6 +6812,31 @@ export declare type IsSpeakingChangedListener = (event: {
     isSpeaking: boolean;
 }) => void;
 
+/**
+ * Options for setting microphone and camera state when joining a call
+ * true = turn on the device when joining call
+ * false = turn off the device when joining call
+ * 'keep'/undefined = retain devices' precall state
+ *
+ * @public
+ */
+export declare interface JoinCallOptions {
+    /**
+     * microphone state when joining call
+     * true: turn on
+     * false: turn off
+     * 'keep': maintain precall state
+     */
+    microphoneOn?: boolean | 'keep';
+    /**
+     * camera state when joining call
+     * true: turn on
+     * false: turn off
+     * 'keep': maintain precall state
+     */
+    cameraOn?: boolean | 'keep';
+}
+
 /**
  * Arguments for {@link MessageThreadProps.onRenderJumpToNewMessageButton}.
  *
@@ -7164,6 +7430,11 @@ export declare type MessageThreadProps = {
      * @beta
      */
     mentionOptions?: MentionOptions;
+    /**
+     * Optional callback called when an inline image is clicked.
+     * @beta
+     */
+    onInlineImageClicked?: (attachment: FileMetadata, onRenderTitleIcon?: (personaProps?: IPersonaProps) => JSX.Element) => Promise<void>;
 };
 
 /**
@@ -7505,6 +7776,20 @@ userId?: string, options?: CustomAvatarOptions,
  */
 defaultOnRender?: (props: CustomAvatarOptions) => JSX.Element) => JSX.Element;
 
+/**
+ * Dependency resolution for video background effects.
+ *
+ * @beta
+ */
+export declare const onResolveVideoEffectDependency: () => Promise<VideoBackgroundEffectsDependency>;
+
+/**
+ *
+ * Dependency resolution for video background effects using lazy loading.
+ * @beta
+ */
+export declare const onResolveVideoEffectDependencyLazy: () => Promise<VideoBackgroundEffectsDependency>;
+
 /**
  * State only version of Optimal Video Count Feature {@link @azure/communication-calling#OptimalVideoCountCallFeature}.
  *
@@ -7538,7 +7823,7 @@ export declare interface OptionsDevice {
  *
  * @beta
  */
-export declare type OverflowGalleryPosition = 'HorizontalBottom' | 'VerticalRight';
+export declare type OverflowGalleryPosition = 'HorizontalBottom' | 'VerticalRight' | /* @conditional-compile-remove(gallery-layouts) */ 'HorizontalTop';
 
 /**
  * A system message notifying that a participant was added to the chat thread.
@@ -7713,6 +7998,10 @@ export declare type ParticipantListProps = {
     styles?: ParticipantListStyles;
     /** Optional value to determine if the tooltip should be shown for participants or not */
     showParticipantOverflowTooltip?: boolean;
+    /** Total number of people in the call. This number can be larger than the remote participant count. */
+    totalParticipantCount?: number;
+    /** Strings for the participant list */
+    strings?: ParticipantListStrings;
     /** Optional aria-lablledby prop that prefixes each ParticipantItem aria-label */
     participantAriaLabelledBy?: string;
 };
@@ -7725,8 +8014,21 @@ export declare type ParticipantListProps = {
 export declare type ParticipantListSelector = (state: CallClientState, props: CallingBaseSelectorProps) => {
     participants: CallParticipantListParticipant[];
     myUserId: string;
+    totalParticipantCount?: number;
 };
 
+/**
+ * Strings for the {@link ParticipantList}.
+ *
+ * @beta
+ */
+export declare interface ParticipantListStrings {
+    /**
+     * String for rendering the count of participants not contained in the displayed participant list
+     */
+    overflowParticipantCount?: string;
+}
+
 /**
  * Styles for the {@link ParticipantList}.
  *
@@ -7955,6 +8257,95 @@ export declare type Profile = {
     displayName?: string;
 };
 
+/**
+ * Raised hand state with order
+ *
+ * @public
+ */
+export declare type RaisedHand = {
+    raisedHandOrderPosition: number;
+};
+
+/**
+ * Raised hand state with order
+ *
+ * @public
+ */
+export declare type RaisedHandState = {
+    raisedHandOrderPosition: number;
+};
+
+/**
+ * A button to start / stop screen sharing.
+ *
+ * Can be used with {@link ControlBar}.
+ *
+ * @public
+ */
+export declare const RaiseHandButton: (props: RaiseHandButtonProps) => JSX.Element;
+
+/**
+ * Props for {@link RaiseHandButton}.
+ *
+ * @public
+ */
+export declare interface RaiseHandButtonProps extends ControlBarButtonProps {
+    /**
+     * Utility property for using this component with `communication react eventHandlers`.
+     * Maps directly to the `onClick` property.
+     */
+    onToggleRaiseHand?: () => Promise<void>;
+    /**
+     * Optional strings to override in component
+     */
+    strings?: Partial<RaiseHandButtonStrings>;
+}
+
+/**
+ * Selector type for {@link RaiseHandButton} component.
+ *
+ * @public
+ */
+export declare type RaiseHandButtonSelector = (state: CallClientState, props: CallingBaseSelectorProps) => {
+    checked?: boolean;
+    disabled?: boolean;
+};
+
+/**
+ * Strings of {@link RaiseHandButton} that can be overridden.
+ *
+ * @public
+ */
+export declare interface RaiseHandButtonStrings {
+    /** Label when button is on. */
+    onLabel: string;
+    /** Label when button is off. */
+    offLabel: string;
+    /** * Tooltip content when the button is disabled. */
+    tooltipDisabledContent?: string;
+    /** Tooltip content when the button is on. */
+    tooltipOnContent?: string;
+    /** Tooltip content when the button is off. */
+    tooltipOffContent?: string;
+}
+
+/**
+ * State only version of {@link @azure/communication-calling#RaiseHandCallFeature}. {@link StatefulCallClient} will
+ * automatically listen for raised hands on the call and update the state exposed by {@link StatefulCallClient} accordingly.
+ *
+ * @public
+ */
+export declare interface RaiseHandCallFeature {
+    /**
+     * Proxy of {@link @azure/communication-calling#RaiseHandCallFeature.raisedHands}.
+     */
+    raisedHands: RaisedHandState[];
+    /**
+     * Contains information for local participant from list {@link @azure/communication-calling#RaiseHandCallFeature.raisedHands}.
+     */
+    localParticipantRaisedHand?: RaisedHandState;
+}
+
 /**
  * An array of key value pairs that stores each sender's display name and last read message
  *
@@ -8022,6 +8413,10 @@ export declare interface RemoteParticipantState {
      * Proxy of {@link @azure/communication-calling#RemoteParticipant.role}.
      */
     role?: ParticipantRole;
+    /**
+     * Proxy of {@link @azure/communication-calling#Call.RaisedHand.raisedHands}.
+     */
+    raisedHand?: RaisedHandState;
 }
 
 /**
@@ -8068,12 +8463,6 @@ export declare interface RemoteVideoTileMenuOptions {
     isHidden?: boolean;
 }
 
-/**
- * @beta
- * The role of a call participant.
- */
-export declare type Role = 'Presenter' | 'Attendee' | 'Consumer' | 'Organizer' | 'Co-organizer';
-
 /**
  * A button to start / stop screen sharing.
  *
@@ -8174,7 +8563,7 @@ export declare interface SendBoxProps {
      */
     systemMessage?: string;
     /**
-     * Optional callback called when message is sent
+     * Optional override behavior on send button click
      */
     onSendMessage?: (content: string) => Promise<void>;
     /**
@@ -8372,6 +8761,8 @@ export declare interface SitePermissionsStyles extends BaseCustomStyles {
  *   - RemoteVideoStream 'isAvailableChanged'
  *   - TranscriptionCallFeature 'isTranscriptionActiveChanged'
  *   - RecordingCallFeature 'isRecordingActiveChanged'
+ *   - RaiseHandCallFeature 'raisedHandEvent'
+ *   - RaiseHandCallFeature 'loweredHandEvent'
  *
  * @public
  */
@@ -8645,12 +9036,23 @@ export declare type TeamsAdapterOptions = CommonCallAdapterOptions;
 export declare interface TeamsCallAdapter extends CommonCallAdapter {
     /**
      * Join the call with microphone initially on/off.
-     *
+     * @deprecated Use joinCall(options?:JoinCallOptions) instead.
      * @param microphoneOn - Whether microphone is initially enabled
      *
      * @beta
      */
     joinCall(microphoneOn?: boolean): TeamsCall | undefined;
+    /**
+     * Join the call with options bag to set microphone/camera initial state when joining call
+     * true = turn on the device when joining call
+     * false = turn off the device when joining call
+     * 'keep'/undefined = retain devices' precall state
+     *
+     * @param options - param to set microphone/camera initially on/off.
+     *
+     * @public
+     */
+    joinCall(options?: JoinCallOptions): TeamsCall | undefined;
     /**
      * Start the call.
      *
@@ -9002,7 +9404,7 @@ export declare interface UnsupportedOperatingSystemStrings {
  * @public
  * Callback function run when a message is updated.
  */
-export declare type UpdateMessageCallback = (messageId: string, content: string, /* @conditional-compile-remove(file-sharing) */ metadata?: Record<string, string>, /* @conditional-compile-remove(file-sharing) */ options?: {
+export declare type UpdateMessageCallback = (messageId: string, content: string, metadata?: Record<string, string>, options?: {
     attachedFilesMetadata?: FileMetadata[];
 }) => Promise<void>;
 
@@ -9260,6 +9662,16 @@ export declare interface VideoBackgroundBlurEffect extends BackgroundBlurConfig
  */
 export declare type VideoBackgroundEffect = VideoBackgroundNoEffect | VideoBackgroundBlurEffect | VideoBackgroundReplacementEffect;
 
+/**
+ * Dependency type to be injected for video background effects
+ *
+ * @beta
+ */
+export declare type VideoBackgroundEffectsDependency = {
+    createBackgroundBlurEffect: (config?: BackgroundBlurConfig) => BackgroundBlurEffect;
+    createBackgroundReplacementEffect: (config: BackgroundReplacementConfig) => BackgroundReplacementEffect;
+};
+
 /**
  * Contains the attibutes of a background image like url, name etc.
  *
@@ -9319,14 +9731,17 @@ export declare const VideoGallery: (props: VideoGalleryProps) => JSX.Element;
 /**
  * @public
  */
-export declare type VideoGalleryLayout = 'default' | 'floatingLocalVideo';
+export declare type VideoGalleryLayout = 'default' | 'floatingLocalVideo' | /* @conditional-compile-remove(gallery-layouts) */ 'speaker';
 
 /**
  * The state of the local participant in the {@link VideoGallery}.
  *
  * @public
  */
-export declare type VideoGalleryLocalParticipant = VideoGalleryParticipant;
+export declare interface VideoGalleryLocalParticipant extends VideoGalleryParticipant {
+    /** Whether local participant is raised a hand */
+    raisedHand?: RaisedHand;
+}
 
 /**
  * The state of a participant in the {@link VideoGallery}.
@@ -9462,6 +9877,8 @@ export declare interface VideoGalleryRemoteParticipant extends VideoGalleryParti
      * The connection state of the participant. For example, 'Hold', 'Connecting' etc.
      */
     state?: ParticipantState;
+    /** Whether participant is raised a hand */
+    raisedHand?: RaisedHand;
 }
 
 /**
@@ -9692,6 +10109,8 @@ export declare interface VideoTileProps {
     noVideoAvailableAriaLabel?: string;
     /** Whether the participant in the videoTile is speaking. Shows a speaking indicator (border). */
     isSpeaking?: boolean;
+    /** Whether the participant is raised hand. Show a indicator (border) and order icon */
+    raisedHand?: RaisedHand;
     /**
      * The call connection state of the participant.
      * For example, `Hold` means the participant is on hold.