@azure/communication-react 1.8.0-beta.1 → 1.8.1-alpha-202309200012

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 { CapabilitiesChangeInfo } from '@azure/communication-calling';
 import { CaptionsResultType } from '@azure/communication-calling';
 import { ChatClient } from '@azure/communication-chat';
 import { ChatClientOptions } from '@azure/communication-chat';
@@ -75,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';
@@ -91,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,7 +316,7 @@ export declare type AzureCommunicationCallAdapterArgs = {
 /**
  * Optional parameters to create {@link AzureCommunicationCallAdapter}
  *
- * @beta
+ * @public
  */
 export declare type AzureCommunicationCallAdapterOptions = CommonCallAdapterOptions;
 
@@ -876,13 +879,13 @@ export declare interface CallAdapterCallOperations {
     /**
      * Start the video background effect.
      *
-     * @beta
+     * @public
      */
     startVideoBackgroundEffect(videoBackgroundEffect: VideoBackgroundEffect): Promise<void>;
     /**
      * Stop the video background effect.
      *
-     * @beta
+     * @public
      */
     stopVideoBackgroundEffects(): Promise<void>;
     /**
@@ -890,13 +893,13 @@ export declare interface CallAdapterCallOperations {
      *
      * @param backgroundImages - Array of custom background images.
      *
-     * @beta
+     * @public
      */
     updateBackgroundPickerImages(backgroundImages: VideoBackgroundImage[]): void;
     /**
      * Update the selected video background effect.
      *
-     * @beta
+     * @public
      */
     updateSelectedVideoBackgroundEffect(selectedVideoBackground: VideoBackgroundEffect): void;
 }
@@ -1131,6 +1134,10 @@ export declare interface CallAdapterSubscribers {
      * Subscribe function for 'transferRequested' event.
      */
     on(event: 'transferRequested', listener: TransferRequestedListener): void;
+    /**
+     * Subscribe function for 'capabilitiesChanged' event.
+     */
+    on(event: 'capabilitiesChanged', listener: CapabilitiesChangedListener): void;
     /**
      * Unsubscribe function for 'participantsJoined' event.
      */
@@ -1199,6 +1206,10 @@ export declare interface CallAdapterSubscribers {
      * Unsubscribe function for 'transferRequested' event.
      */
     off(event: 'transferRequested', listener: TransferRequestedListener): void;
+    /**
+     * Unsubscribe function for 'capabilitiesChanged' event.
+     */
+    off(event: 'capabilitiesChanged', listener: CapabilitiesChangedListener): void;
 }
 
 /**
@@ -1379,6 +1390,8 @@ export declare type CallCompositeIcons = {
     ControlButtonParticipants?: JSX.Element;
     ControlButtonScreenShareStart?: JSX.Element;
     ControlButtonScreenShareStop?: JSX.Element;
+    ControlButtonCameraProhibited?: JSX.Element;
+    ControlButtonMicProhibited?: JSX.Element;
     ControlButtonRaiseHand?: JSX.Element;
     ControlButtonLowerHand?: JSX.Element;
     RaiseHandContextualMenuItem?: JSX.Element;
@@ -1424,6 +1437,12 @@ export declare type CallCompositeIcons = {
     NoticePageAccessDeniedRoomsCall?: JSX.Element;
     BlurVideoBackground?: JSX.Element;
     RemoveVideoBackgroundEffect?: JSX.Element;
+    GalleryOptions?: JSX.Element;
+    SpeakerGalleryLayout?: JSX.Element;
+    FloatingLocalVideoGalleryLayout?: JSX.Element;
+    DefaultGalleryLayout?: JSX.Element;
+    FocusedContentGalleryLayout?: JSX.Element;
+    OverflowGalleryTop?: JSX.Element;
 };
 
 /**
@@ -1497,13 +1516,22 @@ export declare type CallCompositeOptions = {
     /**
      * Remote participant video tile menu options
      */
-    remoteVideoTileMenu?: RemoteVideoTileMenuOptions;
+    remoteVideoTileMenuOptions?: RemoteVideoTileMenuOptions;
     /**
      * Options for controlling the local video tile.
      *
      * @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;
+    };
 };
 
 /**
@@ -2069,6 +2097,34 @@ 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;
+    /**
+     * Label for the selection of the focusedContentLayout (Focused content) layout
+     */
+    moreButtonGalleryFocusedContentLayoutLabel?: string;
+    /**
+     * All strings for capability changed notification
+     */
+    capabilityChangedNotification?: CapabilityChangedNotificationStrings;
 }
 
 /**
@@ -2083,7 +2139,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
@@ -2092,7 +2148,7 @@ export declare type CallControlOptions = (CommonCallControlOptions & {
         disabled: boolean;
     };
     legacyControlBarExperience?: boolean;
-});
+};
 
 /**
  * Callback for {@link CallAdapterSubscribers} 'callEnded' event.
@@ -2153,7 +2209,7 @@ export declare type CallErrors = {
  *
  * @public
  */
-export declare type CallErrorTarget = 'Call.addParticipant' | 'Call.dispose' | 'Call.feature' | 'Call.hangUp' | 'Call.hold' | 'Call.mute' | 'Call.muteIncomingAudio' | 'Call.off' | 'Call.on' | 'Call.removeParticipant' | 'Call.resume' | 'Call.sendDtmf' | 'Call.startAudio' | 'Call.startScreenSharing' | 'Call.startVideo' | 'Call.stopScreenSharing' | 'Call.stopAudio' | 'Call.stopVideo' | 'Call.unmute' | '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';
+export declare type CallErrorTarget = 'Call.addParticipant' | 'Call.dispose' | 'Call.feature' | 'Call.hangUp' | 'Call.hold' | 'Call.mute' | 'Call.muteIncomingAudio' | 'Call.off' | 'Call.on' | 'Call.removeParticipant' | 'Call.resume' | 'Call.sendDtmf' | 'Call.startAudio' | 'Call.startScreenSharing' | 'Call.startVideo' | 'Call.stopScreenSharing' | 'Call.stopAudio' | 'Call.stopVideo' | 'Call.unmute' | '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' | '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' | /* @conditional-compile-remove(calling-beta-sdk) */ 'Call.setConstraints';
 
 /**
  * Callback for {@link CallAdapterSubscribers} 'callIdChanged' event.
@@ -2187,7 +2243,7 @@ export declare interface CallingHandlers extends CommonCallingHandlers {
 
 /**
  * Configuration options to include video effect background dependency.
- * @beta
+ * @public
  */
 export declare type CallingHandlersOptions = {
     onResolveVideoBackgroundEffectsDependency?: () => Promise<VideoBackgroundEffectsDependency>;
@@ -2201,7 +2257,7 @@ export declare type CallingHandlersOptions = {
 export declare type CallingReturnProps<Component extends (props: any) => JSX.Element> = GetCallingSelector<Component> extends (state: CallClientState, props: any) => any ? ReturnType<GetCallingSelector<Component>> & Common<CallingHandlers, Parameters<Component>[0]> : never;
 
 /**
- * Custom Fluent theme pallete used by calling related components in this library.
+ * Custom Fluent theme palette used by calling related components in this library.
  *
  * @public
  */
@@ -2390,6 +2446,10 @@ export declare interface CallState {
      * Transfer state of call
      */
     transfer: TransferFeature;
+    /**
+     * Proxy of {@link @azure/communication-calling#CapabilitiesFeature}.
+     */
+    capabilitiesFeature?: CapabilitiesFeatureState;
 }
 
 /**
@@ -2747,13 +2807,13 @@ export declare interface CallWithChatAdapterManagement {
     /**
      * Start the video background effect.
      *
-     * @beta
+     * @public
      */
     startVideoBackgroundEffect(videoBackgroundEffect: VideoBackgroundEffect): Promise<void>;
     /**
      * Stop the video background effect.
      *
-     * @beta
+     * @public
      */
     stopVideoBackgroundEffects(): Promise<void>;
     /**
@@ -2761,13 +2821,13 @@ export declare interface CallWithChatAdapterManagement {
      *
      * @param backgroundImages - Array of custom background images.
      *
-     * @beta
+     * @public
      */
     updateBackgroundPickerImages(backgroundImages: VideoBackgroundImage[]): void;
     /**
      * Update the selected video background effect
      *
-     * @beta
+     * @public
      */
     updateSelectedVideoBackgroundEffect(selectedVideoBackground: VideoBackgroundEffect): void;
 }
@@ -2801,6 +2861,7 @@ export declare interface CallWithChatAdapterSubscriptions {
     on(event: 'isCaptionsActiveChanged', listener: IsCaptionsActiveChangedListener): void;
     on(event: 'isCaptionLanguageChanged', listener: IsCaptionLanguageChangedListener): void;
     on(event: 'isSpokenLanguageChanged', listener: IsSpokenLanguageChangedListener): void;
+    on(event: 'capabilitiesChanged', listener: CapabilitiesChangedListener): void;
     off(event: 'callEnded', listener: CallEndedListener): void;
     off(event: 'isMutedChanged', listener: IsMutedChangedListener): void;
     off(event: 'callIdChanged', listener: CallIdChangedListener): void;
@@ -2816,6 +2877,7 @@ export declare interface CallWithChatAdapterSubscriptions {
     off(event: 'isCaptionsActiveChanged', listener: IsCaptionsActiveChangedListener): void;
     off(event: 'isCaptionLanguageChanged', listener: IsCaptionLanguageChangedListener): void;
     off(event: 'isSpokenLanguageChanged', listener: IsSpokenLanguageChangedListener): void;
+    off(event: 'capabilitiesChanged', listener: CapabilitiesChangedListener): void;
     on(event: 'messageReceived', listener: MessageReceivedListener): void;
     on(event: 'messageSent', listener: MessageSentListener): void;
     on(event: 'messageRead', listener: MessageReadListener): void;
@@ -2933,6 +2995,8 @@ export declare type CallWithChatCompositeIcons = {
     ControlButtonOptions?: JSX.Element;
     ControlButtonScreenShareStart?: JSX.Element;
     ControlButtonScreenShareStop?: JSX.Element;
+    ControlButtonCameraProhibited?: JSX.Element;
+    ControlButtonMicProhibited?: JSX.Element;
     ErrorBarCallCameraAccessDenied?: JSX.Element;
     ErrorBarCallCameraAlreadyInUse?: JSX.Element;
     ErrorBarCallLocalVideoFreeze?: JSX.Element;
@@ -3051,6 +3115,25 @@ export declare type CallWithChatCompositeOptions = {
      * if this is not supplied, the composite will not show a unsupported browser page.
      */
     onEnvironmentInfoTroubleshootingClick?: () => void;
+    /**
+     * Remote participant video tile menu options
+     */
+    remoteVideoTileMenuOptions?: RemoteVideoTileMenuOptions;
+    /**
+     * Options for controlling the local video tile.
+     *
+     * @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;
+    };
 };
 
 /**
@@ -3268,7 +3351,7 @@ export declare interface CallWithChatControlOptions extends CommonCallControlOpt
  *
  * @public
  */
-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' | /* @conditional-compile-remove(close-captions) */ 'isCaptionLanguageChanged' | /* @conditional-compile-remove(close-captions) */ 'isSpokenLanguageChanged' | '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' | /* @conditional-compile-remove(close-captions) */ 'isCaptionLanguageChanged' | /* @conditional-compile-remove(close-captions) */ 'isSpokenLanguageChanged' | /* @conditional-compile-remove(capabilities) */ 'capabilitiesChanged' | 'messageReceived' | 'messageSent' | 'messageRead' | 'chatParticipantsAdded' | 'chatParticipantsRemoved';
 
 /**
  * @beta
@@ -3364,7 +3447,7 @@ export declare interface CameraButtonProps extends ControlBarButtonProps {
     /**
      * Callback when a effects is clicked
      */
-    onShowVideoEffectsPicker?: (showVideoEffectsOptions: boolean) => void;
+    onClickVideoEffects?: (showVideoEffects: boolean) => void;
 }
 
 /**
@@ -3487,7 +3570,76 @@ export declare type CameraSitePermissionsStrings = SitePermissionsStrings;
 export declare type CancelEditCallback = (messageId: string) => void;
 
 /**
- * @beta
+ * Callback for {@link CallAdapterSubscribers} 'capabilitiesChanged' event.
+ *
+ * @public
+ */
+export declare type CapabilitiesChangedListener = (data: CapabilitiesChangeInfo) => void;
+
+/**
+ * State only version of {@link @azure/communication-calling#CapabilitiesFeature}
+ *
+ * @public
+ */
+export declare interface CapabilitiesFeatureState {
+    /**
+     * Proxy of {@link @azure/communication-calling#CapabilitiesFeature.capabilities}.
+     */
+    capabilities: ParticipantCapabilities;
+    /**
+     * Proxy of the latest {@link @azure/communication-calling#CapabilitiesChangeInfo}
+     */
+    latestCapabilitiesChangeInfo: CapabilitiesChangeInfo;
+}
+
+/**
+ * Strings for capability changed notification
+ * @public
+ */
+export declare interface CapabilityChangedNotificationStrings {
+    /**
+     * Strings for 'turnVideoOn' capability
+     */
+    turnVideoOn?: {
+        /**
+         * Notification message shown to the user when capability to turn video on is lost due to a meeting option change
+         */
+        lostDueToMeetingOption?: string;
+        /**
+         * Notification message shown to the user when capability to turn video on is granted due to a meeting option change
+         */
+        grantedDueToMeetingOption?: string;
+    };
+    /**
+     * Strings for 'unmuteMic' capability
+     */
+    unmuteMic?: {
+        /**
+         * Notification message shown to the user when capability to unmute mic is lost due to a meeting option change
+         */
+        lostDueToMeetingOption?: string;
+        /**
+         * Notification message shown to the user when capability to unmute mic is granted due to a meeting option change
+         */
+        grantedDueToMeetingOption?: string;
+    };
+    /**
+     * Strings for 'shareScreen' capability
+     */
+    shareScreen?: {
+        /**
+         * Notification message shown to the user when capability to share screen is lost due to a role change to Attendeee
+         */
+        lostDueToRoleChangeToAttendee?: string;
+        /**
+         * Notification message shown to the user when capability to share screen is granted due to a role change to Presenter
+         */
+        grantedDueToRoleChangeToPresenter?: string;
+    };
+}
+
+/**
+ * @public
  * caption language strings for captions setting modal
  */
 export declare interface CaptionLanguageStrings {
@@ -3526,7 +3678,7 @@ export declare interface CaptionLanguageStrings {
 }
 
 /**
- * @beta
+ * @public
  */
 export declare interface CaptionsCallFeatureState {
     /**
@@ -3560,7 +3712,7 @@ export declare interface CaptionsCallFeatureState {
 }
 
 /**
- * @beta
+ * @public
  */
 export declare interface CaptionsInfo {
     /**
@@ -3596,7 +3748,7 @@ export declare interface CaptionsInfo {
 /**
  * options bag to start captions
  *
- * @beta
+ * @public
  */
 export declare type CaptionsOptions = {
     spokenLanguage: string;
@@ -3605,7 +3757,7 @@ export declare type CaptionsOptions = {
 /**
  * Callback for {@link CallAdapterSubscribers} 'captionsReceived' event.
  *
- * @beta
+ * @public
  */
 export declare type CaptionsReceivedListener = (event: {
     captionsInfo: CaptionsInfo;
@@ -3616,7 +3768,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.
@@ -3724,7 +3876,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>;
     /**
@@ -4014,7 +4166,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>;
@@ -4082,6 +4234,26 @@ export declare type ChatParticipantListSelector = (state: ChatClientState, props
  */
 export declare type ChatReturnProps<Component extends (props: any) => JSX.Element> = GetChatSelector<Component> extends (state: ChatClientState, props: any) => any ? ReturnType<GetChatSelector<Component>> & Common<ChatHandlers, Parameters<Component>[0]> : never;
 
+/**
+ * Custom Fluent theme palette used by chat related components in this library.
+ *
+ * @beta
+ */
+export declare interface ChatTheme {
+    /**
+     * Custom Fluent theme palette used by chat related components in this library.
+     *
+     * @beta
+     */
+    chatPalette: {
+        modalOverlayBlack: string;
+        modalTitleWhite: string;
+        modalButtonBackground: string;
+        modalButtonBackgroundHover: string;
+        modalButtonBackgroundActive: string;
+    };
+}
+
 /**
  * A {@link React.Context} that stores a {@link @azure/communication-chat#ChatThreadClient}.
  *
@@ -4218,7 +4390,7 @@ export declare interface CommonCallAdapter extends AdapterState<CallAdapterState
 /**
  * Common optional parameters to create {@link AzureCommunicationCallAdapter} or {@link TeamsCallAdapter}
  *
- * @beta
+ * @public
  */
 export declare type CommonCallAdapterOptions = {
     /**
@@ -4640,6 +4812,8 @@ export declare interface ComponentStrings {
     sendBox: SendBoxStrings;
     /** Strings for MentionPopover */
     mentionPopover: MentionPopoverStrings;
+    /** Strings for ImageGallery */
+    imageGallery: ImageGalleryStrings;
     /** Strings for MessageStatusIndicator */
     messageStatusIndicator: MessageStatusIndicatorStrings;
     /** Strings for ErroBar */
@@ -5058,7 +5232,7 @@ export declare const createAzureCommunicationCallAdapter: ({ userId, displayName
  *
  * @public
  */
-export declare const createAzureCommunicationCallAdapterFromClient: (callClient: StatefulCallClient, callAgent: CallAgent, locator: CallAdapterLocator, /* @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
@@ -5096,7 +5270,7 @@ 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>;
 
@@ -5105,7 +5279,7 @@ export declare function createAzureCommunicationChatAdapterFromClient(chatClient
  *
  * @public
  */
-export declare type CreateDefaultCallingHandlers = (callClient: StatefulCallClient, callAgent: CallAgent | undefined, deviceManager: StatefulDeviceManager | undefined, call: Call | undefined, /* @conditional-compile-remove(video-background-effects) */ options?: CallingHandlersOptions) => CallingHandlers;
+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.
@@ -5388,13 +5562,13 @@ export declare interface CustomMessage extends MessageCommon {
  *
  * @public
  */
-export declare const darkTheme: PartialTheme & CallingTheme;
+export declare const darkTheme: PartialTheme & CallingTheme & /* @conditional-compile-remove(image-gallery) */ ChatTheme;
 
 /**
  * @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
@@ -5527,6 +5701,8 @@ export declare const DEFAULT_COMPOSITE_ICONS: {
     ControlButtonParticipants: JSX.Element;
     ControlButtonScreenShareStart: JSX.Element;
     ControlButtonScreenShareStop: JSX.Element;
+    ControlButtonCameraProhibited?: JSX.Element | undefined;
+    ControlButtonMicProhibited?: JSX.Element | undefined;
     ControlButtonRaiseHand: JSX.Element;
     ControlButtonLowerHand: JSX.Element;
     RaiseHandContextualMenuItem: JSX.Element;
@@ -5570,6 +5746,12 @@ export declare const DEFAULT_COMPOSITE_ICONS: {
     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;
+    FocusedContentGalleryLayout?: JSX.Element | undefined;
+    OverflowGalleryTop?: JSX.Element | undefined;
     ChevronLeft?: JSX.Element | undefined;
     ControlBarChatButtonActive?: JSX.Element | undefined;
     ControlBarChatButtonInactive?: JSX.Element | undefined;
@@ -5615,6 +5797,13 @@ export declare const DEFAULT_COMPOSITE_ICONS: {
     CaptionsIcon: JSX.Element;
     CaptionsOffIcon: JSX.Element;
     CaptionsSettingsIcon: JSX.Element;
+    /**
+     * Icon wrapper to use when including customizable icons inside the CallWithChatComposite.
+     * This wrapper ensures the icon name is being type-checked helping ensure no typos
+     * and ensure that icon is customizable through the composite API.
+     *
+     * @private
+     */
     ChangeSpokenLanguageIcon: JSX.Element;
     ChangeCaptionLanguageIcon: JSX.Element;
     ContextMenuCameraIcon: JSX.Element;
@@ -6648,6 +6837,79 @@ 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. */
+    downloadFilename: 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 {
+    /**
+     * Boolean that controls whether the modal is displayed.
+     */
+    isOpen: boolean;
+    /**
+     * 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, downloadFilename: 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;
+}
+
+/**
+ * Strings of {@link ImageGallery} that can be overridden.
+ *
+ * @beta
+ */
+export declare interface ImageGalleryStrings {
+    /**
+     * Download button label for ImageGallery
+     */
+    downloadButtonLabel: string;
+    /**
+     * Dismiss button aria label for ImageGallery
+     */
+    dismissButtonAriaLabel: string;
+}
+
 /**
  * @beta
  * This contains a readonly array that returns all the active `incomingCalls`.
@@ -6697,7 +6959,7 @@ export declare interface IncomingCallState {
 /**
  * Callback for {@link CallAdapterSubscribers} 'isCaptionLanguageChanged' event.
  *
- * @beta
+ * @public
  */
 export declare type IsCaptionLanguageChangedListener = (event: {
     activeCaptionLanguage: string;
@@ -6706,7 +6968,7 @@ export declare type IsCaptionLanguageChangedListener = (event: {
 /**
  * Callback for {@link CallAdapterSubscribers} 'isCaptionsActiveChanged' event.
  *
- * @beta
+ * @public
  */
 export declare type IsCaptionsActiveChangedListener = (event: {
     isActive: boolean;
@@ -6744,7 +7006,7 @@ export declare type IsSpeakingChangedListener = (event: {
 /**
  * Callback for {@link CallAdapterSubscribers} 'isSpokenLanguageChanged' event.
  *
- * @beta
+ * @public
  */
 export declare type IsSpokenLanguageChangedListener = (event: {
     activeSpokenLanguage: string;
@@ -6792,7 +7054,7 @@ export declare interface JumpToNewMessageButtonProps {
  *
  * @public
  */
-export declare const lightTheme: PartialTheme & CallingTheme;
+export declare const lightTheme: PartialTheme & CallingTheme & /* @conditional-compile-remove(image-gallery) */ ChatTheme;
 
 /**
  * Whether the stream is loading or not.
@@ -6859,7 +7121,7 @@ export declare interface LocalVideoStreamState {
     view?: VideoStreamRendererViewState;
     /**
      * Stores the state of the video effects.
-     * @beta
+     * @public
      */
     videoEffects?: LocalVideoStreamVideoEffectsState;
 }
@@ -6867,7 +7129,7 @@ export declare interface LocalVideoStreamState {
 /**
  * State only version of a LocalVideoStream's {@link @azure/communication-calling#VideoEffectsFeature}.
  *
- * @beta
+ * @public
  */
 export declare interface LocalVideoStreamVideoEffectsState {
     /**
@@ -6889,7 +7151,6 @@ export declare interface LocalVideoTileOptions {
      * @remarks 'grid' - local video tile will be rendered in the grid view of the videoGallery.
      * 'floating' - local video tile will be rendered in the floating position and will observe overflow gallery
      * local video tile rules and be docked in the bottom corner.
-     * 'hidden' - local video tile will not be rendered.
      * This does not affect the Configuration screen or the side pane Picture in Picture in Picture view.
      */
     position?: 'grid' | 'floating';
@@ -7368,6 +7629,11 @@ export declare type MessageThreadProps = {
      * @beta
      */
     mentionOptions?: MentionOptions;
+    /**
+     * Optional callback called when an inline image is clicked.
+     * @beta
+     */
+    onInlineImageClicked?: (attachmentId: string, messageId: string) => Promise<void>;
 };
 
 /**
@@ -7712,21 +7978,21 @@ defaultOnRender?: (props: CustomAvatarOptions) => JSX.Element) => JSX.Element;
 /**
  * Dependency resolution for video background effects.
  *
- * @beta
+ * @public
  */
 export declare const onResolveVideoEffectDependency: () => Promise<VideoBackgroundEffectsDependency>;
 
 /**
  *
  * Dependency resolution for video background effects using lazy loading.
- * @beta
+ * @public
  */
 export declare const onResolveVideoEffectDependencyLazy: () => Promise<VideoBackgroundEffectsDependency>;
 
 /**
  * State only version of Optimal Video Count Feature {@link @azure/communication-calling#OptimalVideoCountCallFeature}.
  *
- * @beta
+ * @public
  */
 export declare interface OptimalVideoCountFeatureState {
     /**
@@ -7756,7 +8022,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.
@@ -8392,7 +8658,7 @@ export declare interface RemoteVideoStreamState {
 /**
  * Menu options for remote video tiles in {@link VideoGallery}.
  *
- * @beta
+ * @public
  */
 export declare interface RemoteVideoTileMenuOptions {
     /**
@@ -8672,7 +8938,7 @@ export declare interface SitePermissionsStyles extends BaseCustomStyles {
 }
 
 /**
- * @beta
+ * @public
  * spoken language strings for captions setting modal
  */
 export declare interface SpokenLanguageStrings {
@@ -8954,7 +9220,7 @@ export declare interface StatefulDeviceManager extends DeviceManager {
      * {@link @azure/communication-calling#Call}. This is useful for developers who want to interact with rendered
      * video streams before they have started a call. See also {@link @azure/communication-react#CallClient.createView}.
      *
-     * @beta
+     * @public
      */
     getUnparentedVideoStreams: () => LocalVideoStream[];
 }
@@ -9012,7 +9278,7 @@ export declare interface SystemMessageCommon extends MessageCommon {
 /**
  * Optional parameters to create {@link TeamsCallAdapter}
  *
- * @beta
+ * @public
  */
 export declare type TeamsAdapterOptions = CommonCallAdapterOptions;
 
@@ -9392,7 +9658,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>;
 
@@ -9634,7 +9900,7 @@ export declare interface VerticalGalleryStyles extends BaseCustomStyles {
 /**
  * Contains the attibutes of the blur video background effect
  *
- * @beta
+ * @public
  */
 export declare interface VideoBackgroundBlurEffect extends BackgroundBlurConfig {
     /**
@@ -9646,14 +9912,14 @@ export declare interface VideoBackgroundBlurEffect extends BackgroundBlurConfig
 /**
  * Contains the attibutes of a selected video background effect
  *
- * @beta
+ * @public
  */
 export declare type VideoBackgroundEffect = VideoBackgroundNoEffect | VideoBackgroundBlurEffect | VideoBackgroundReplacementEffect;
 
 /**
  * Dependency type to be injected for video background effects
  *
- * @beta
+ * @public
  */
 export declare type VideoBackgroundEffectsDependency = {
     createBackgroundBlurEffect: (config?: BackgroundBlurConfig) => BackgroundBlurEffect;
@@ -9663,7 +9929,7 @@ export declare type VideoBackgroundEffectsDependency = {
 /**
  * Contains the attibutes of a background image like url, name etc.
  *
- * @beta
+ * @public
  */
 export declare interface VideoBackgroundImage {
     /**
@@ -9683,7 +9949,7 @@ export declare interface VideoBackgroundImage {
 /**
  * Contains the attibutes to remove video background effect
  *
- * @beta
+ * @public
  */
 export declare interface VideoBackgroundNoEffect {
     /**
@@ -9695,7 +9961,7 @@ export declare interface VideoBackgroundNoEffect {
 /**
  * Contains the attibutes of a selected replacement video background effect
  *
- * @beta
+ * @public
  */
 export declare interface VideoBackgroundReplacementEffect extends BackgroundReplacementConfig {
     /**
@@ -9719,7 +9985,7 @@ 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' | /* @conditional-compile-remove(gallery-layouts) */ 'focusedContent';
 
 /**
  * The state of the local participant in the {@link VideoGallery}.
@@ -9835,7 +10101,7 @@ export declare interface VideoGalleryProps {
      *
      * @defaultValue \{ kind: 'contextual' \}
      */
-    remoteVideoTileMenuOptions?: false | VideoTileContextualMenuProps | VideoTileDrawerMenuProps;
+    remoteVideoTileMenu?: false | VideoTileContextualMenuProps | VideoTileDrawerMenuProps;
     /**
      * Determines the layout of the overflowGallery inside the VideoGallery.
      * @defaultValue 'HorizontalBottom'
@@ -10005,7 +10271,7 @@ export declare const VideoTile: (props: VideoTileProps) => JSX.Element;
 /**
  * Properties for showing contextual menu for remote {@link VideoTile} components in {@link VideoGallery}.
  *
- * @beta
+ * @public
  */
 export declare interface VideoTileContextualMenuProps {
     /**
@@ -10017,7 +10283,7 @@ export declare interface VideoTileContextualMenuProps {
 /**
  * Properties for showing drawer menu on remote {@link VideoTile} long touch in {@link VideoGallery}.
  *
- * @beta
+ * @public
  */
 export declare interface VideoTileDrawerMenuProps {
     /**