@azure/communication-react 1.5.0 → 1.5.2-alpha-202301190014.0

package/dist/communication-react.d.ts

@@ -17,6 +17,7 @@
 
 /// <reference types="react" />
 
+import { AddPhoneNumberOptions } from '@azure/communication-calling';
 import { AudioDeviceInfo } from '@azure/communication-calling';
 import { Call } from '@azure/communication-calling';
 import { CallAgent } from '@azure/communication-calling';
@@ -25,6 +26,7 @@ import { CallClientOptions } from '@azure/communication-calling';
 import { CallDirection } from '@azure/communication-calling';
 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 { ChatClient } from '@azure/communication-chat';
 import { ChatClientOptions } from '@azure/communication-chat';
@@ -42,25 +44,33 @@ import { CreateViewOptions } from '@azure/communication-calling';
 import { DeviceAccess } from '@azure/communication-calling';
 import { DeviceManager } from '@azure/communication-calling';
 import { DominantSpeakersInfo } from '@azure/communication-calling';
+import { DtmfTone as DtmfTone_2 } from '@azure/communication-calling';
+import { EnvironmentInfo } from '@azure/communication-calling';
 import { GroupCallLocator } from '@azure/communication-calling';
 import { IButtonProps } from '@fluentui/react';
 import { IButtonStyles } from '@fluentui/react';
 import { IContextualMenuItem } from '@fluentui/react';
 import { IContextualMenuItemStyles } from '@fluentui/react';
+import { IContextualMenuProps } from '@fluentui/react';
 import { IContextualMenuStyles } from '@fluentui/react';
+import { ILinkStyles } from '@fluentui/react';
 import { IMessageBarProps } from '@fluentui/react';
+import { IncomingCall } from '@azure/communication-calling';
 import { IPersonaStyleProps } from '@fluentui/react';
 import { IPersonaStyles } from '@fluentui/react';
 import { IRenderFunction } from '@fluentui/react';
 import { IStyle } from '@fluentui/react';
 import { IStyleFunctionOrObject } from '@fluentui/react';
+import { ITextFieldStyles } from '@fluentui/react';
 import { LatestMediaDiagnostics } from '@azure/communication-calling';
 import { LatestNetworkDiagnostics } from '@azure/communication-calling';
 import type { MediaDiagnosticChangedEventArgs } from '@azure/communication-calling';
 import { MediaStreamType } from '@azure/communication-calling';
+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 { ParticipantRole } from '@azure/communication-calling';
 import { PermissionConstraints } from '@azure/communication-calling';
 import { PersonaInitialsColor } from '@fluentui/react';
 import { PersonaPresence } from '@fluentui/react';
@@ -71,9 +81,12 @@ import { PropertyChangedEvent } from '@azure/communication-calling';
 import { default as React_2 } from 'react';
 import type { RemoteParticipant } from '@azure/communication-calling';
 import { RemoteParticipantState as RemoteParticipantState_2 } from '@azure/communication-calling';
+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 { TeamsCall } from '@azure/communication-calling';
+import { TeamsCallAgent } from '@azure/communication-calling';
 import { TeamsMeetingLinkLocator } from '@azure/communication-calling';
 import { Theme } from '@fluentui/react';
 import { TypingIndicatorReceivedEvent } from '@azure/communication-chat';
@@ -102,6 +115,38 @@ export declare interface ActiveErrorMessage {
     timestamp?: Date;
 }
 
+/**
+ * Attributes required for SendBox to show file uploads like name, progress etc.
+ * @beta
+ */
+export declare interface ActiveFileUpload {
+    /**
+     * Unique identifier for the file upload.
+     */
+    id: string;
+    /**
+     * File name to be rendered for uploaded file.
+     */
+    filename: string;
+    /**
+     * A number between 0 and 1 indicating the progress of the upload.
+     * This is unrelated to the `uploadComplete` property.
+     * It is only used to show the progress of the upload.
+     * Progress of 1 doesn't mark the upload as complete, set the `uploadComplete`
+     * property to true to mark the upload as complete.
+     */
+    progress: number;
+    /**
+     * Error to be displayed to the user if the upload fails.
+     */
+    error?: SendBoxErrorBarError;
+    /**
+     * `true` means that the upload is completed.
+     * This is independent of the upload `progress`.
+     */
+    uploadComplete?: boolean;
+}
+
 /**
  * Error reported via error events and stored in adapter state.
  *
@@ -197,6 +242,11 @@ export declare type AvatarPersonaData = {
      * @defaultvalue `white`
      */
     initialsTextColor?: string;
+    /**
+     * If true, show the special coin for unknown persona.
+     * It has '?' in place of initials, with static font and background colors
+     */
+    showUnknownPersonaCoin?: boolean;
 };
 
 /**
@@ -218,6 +268,29 @@ export declare type AzureCommunicationCallAdapterArgs = {
     displayName: string;
     credential: CommunicationTokenCredential;
     locator: CallAdapterLocator;
+    /**
+     * A phone number in E.164 format procured using Azure Communication Services that will be used to represent callers identity.
+     * E.164 numbers are formatted as [+] [country code] [phone number including area code]. For example, +14255550123 for a US phone number.
+     */
+    alternateCallerId?: string;
+    /**
+     * Optional parameters for the {@link AzureCommunicationCallAdapter} created
+     */
+    options?: AzureCommunicationCallAdapterOptions;
+};
+
+/**
+ * Optional parameters to create {@link AzureCommunicationCallAdapter}
+ *
+ * @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;
 };
 
 /**
@@ -231,6 +304,8 @@ export declare type AzureCommunicationCallWithChatAdapterArgs = {
     displayName: string;
     credential: CommunicationTokenCredential;
     locator: CallAndChatLocator | TeamsMeetingLinkLocator;
+    alternateCallerId?: string;
+    callAdapterOptions?: AzureCommunicationCallAdapterOptions;
 };
 
 /**
@@ -314,6 +389,136 @@ export declare interface BaseCustomStyles {
     root?: IStyle;
 }
 
+/**
+ * @beta
+ * Props for BrowserPermissionDeniedIOS component.
+ */
+export declare interface BrowserPermissionDeniedIOSProps extends BrowserPermissionDeniedProps {
+    /**
+     * Localization strings for BrowserPermissionDeniedIOS component.
+     */
+    strings?: BrowserPermissionDeniedIOSStrings;
+    /**
+     * Link to image source.
+     *
+     * Image is inserted into the top of the component.
+     */
+    imageSource?: string;
+}
+
+/**
+ * @beta
+ * Strings for BrowserPermissionDeniedIOS component
+ */
+export declare interface BrowserPermissionDeniedIOSStrings extends BrowserPermissionDeniedStrings {
+    /**
+     * Image alt text
+     */
+    imageAltText: string;
+    /**
+     * Main text string.
+     */
+    primaryText: string;
+    /**
+     * Subtext string.
+     */
+    secondaryText: string;
+    /**
+     * Step 1 string
+     */
+    step1Text: string;
+    /**
+     * Step 1 digit string
+     */
+    step1DigitText: string;
+    /**
+     * Step 2 string
+     */
+    step2Text: string;
+    /**
+     * Step 2 digit string
+     */
+    step2DigitText: string;
+    /**
+     * Step 3 string
+     */
+    step3Text: string;
+    /**
+     * Step 3 digit string
+     */
+    step3DigitText: string;
+    /**
+     * Step 4 string
+     */
+    step4Text: string;
+    /**
+     * Step 4 digit string
+     */
+    step4DigitText: string;
+}
+
+/**
+ * @beta
+ * Props for BrowserPermissionDenied component.
+ */
+export declare interface BrowserPermissionDeniedProps {
+    /**
+     * Action to be taken by the more help link. Possible to send to external page or show other modal.
+     */
+    onTroubleshootingClick?: () => void;
+    /**
+     * Action to be taken by the try again primary button.
+     */
+    onTryAgainClick?: () => void;
+    /**
+     * Localization strings for BrowserPermissionDenied component.
+     */
+    strings?: BrowserPermissionDeniedStrings;
+    /**
+     * Allows users to pass in an object contains custom CSS styles.
+     * @Example
+     * ```
+     * <BrowserPermissionDenied styles={{ primaryButton: { root: {backgroundColor: 'blue' }}}} />
+     * ```
+     */
+    styles?: BrowserPermissionDeniedStyles;
+}
+
+/**
+ * @beta
+ * Strings for BrowserPermissionDenied component
+ */
+export declare interface BrowserPermissionDeniedStrings {
+    /**
+     * Main button text string.
+     */
+    primaryButtonText: string;
+    /**
+     * Main text string.
+     */
+    primaryText: string;
+    /**
+     * Subtext string.
+     */
+    secondaryText: string;
+    /**
+     * More help link string.
+     */
+    linkText: string;
+}
+
+/**
+ * Fluent styles for {@link BrowserPermissionDenied}.
+ *
+ * @beta
+ */
+export declare interface BrowserPermissionDeniedStyles extends BaseCustomStyles {
+    /** Styles for the primary button. */
+    primaryButton?: IButtonStyles;
+    /** Styles for the help troubleshooting link text. */
+    troubleshootingLink?: ILinkStyles;
+}
+
 /**
  *  An Adapter interface specific for Azure Communication identity which extends {@link CommonCallAdapter}.
  *
@@ -336,6 +541,12 @@ export declare interface CallAdapter extends CommonCallAdapter {
      * @public
      */
     startCall(participants: string[], options?: StartCallOptions): Call | undefined;
+    /**
+     * Start the call.
+     * @param participants - An array of {@link @azure/communication-common#CommunicationIdentifier} to be called
+     * @beta
+     */
+    startCall(participants: CommunicationIdentifier[], options?: StartCallOptions): Call | undefined;
 }
 
 /**
@@ -369,6 +580,12 @@ export declare interface CallAdapterCallManagement extends CallAdapterCallOperat
      * @public
      */
     startCall(participants: string[], options?: StartCallOptions): Call | undefined;
+    /**
+     * Start the call.
+     * @param participants - An array of {@link @azure/communication-common#CommunicationIdentifier} to be called
+     * @beta
+     */
+    startCall(participants: CommunicationIdentifier[], options?: StartCallOptions): Call | undefined;
 }
 
 /**
@@ -433,6 +650,12 @@ export declare interface CallAdapterCallOperations {
      * @public
      */
     removeParticipant(userId: string): Promise<void>;
+    /**
+     * Remove a participant from the call.
+     * @param participant - {@link @azure/communication-common#CommunicationIdentifier} of the participant to be removed
+     * @beta
+     */
+    removeParticipant(participant: CommunicationIdentifier): Promise<void>;
     /**
      * Create the html view for a stream.
      *
@@ -457,6 +680,35 @@ export declare interface CallAdapterCallOperations {
      * @public
      */
     disposeStreamView(remoteUserId?: string, options?: VideoStreamOptions): Promise<void>;
+    /**
+     * Holds the call.
+     *
+     * @beta
+     */
+    holdCall(): Promise<void>;
+    /**
+     * Resumes the call from a `LocalHold` state.
+     *
+     * @beta
+     */
+    resumeCall(): Promise<void>;
+    /**
+     * Add a participant to the call.
+     *
+     * @beta
+     */
+    addParticipant(participant: PhoneNumberIdentifier, options?: AddPhoneNumberOptions): Promise<void>;
+    addParticipant(participant: CommunicationUserIdentifier): Promise<void>;
+    /**
+     * send dtmf tone to another participant in a 1:1 PSTN call
+     *
+     * @beta
+     */
+    sendDtmfTone(dtmfTone: DtmfTone_2): Promise<void>;
+    /**
+     * Continues into a call when the browser version is not supported.
+     */
+    allowUnsupportedBrowserVersion(): void;
 }
 
 /**
@@ -475,6 +727,25 @@ export declare type CallAdapterClientState = {
      * Latest error encountered for each operation performed via the adapter.
      */
     latestErrors: AdapterErrors;
+    /**
+     * Azure communications Phone number to make PSTN calls with.
+     */
+    alternateCallerId?: string;
+    /**
+     * 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.
+     */
+    cameraStatus?: 'On' | 'Off';
 };
 
 /**
@@ -559,7 +830,7 @@ export declare interface CallAdapterDeviceManagement {
  *
  * @public
  */
-export declare type CallAdapterLocator = TeamsMeetingLinkLocator | GroupCallLocator;
+export declare type CallAdapterLocator = TeamsMeetingLinkLocator | GroupCallLocator | /* @conditional-compile-remove(rooms) */ RoomCallLocator | /* @conditional-compile-remove(teams-adhoc-call) */ /* @conditional-compile-remove(PSTN-calls) */ CallParticipantsLocator;
 
 /**
  * {@link CommonCallAdapter} state.
@@ -694,6 +965,7 @@ export declare interface CallAdapterSubscribers {
 export declare type CallAdapterUiState = {
     isLocalPreviewMicrophoneEnabled: boolean;
     page: CallCompositePage;
+    unsupportedBrowserVersionsAllowed?: boolean;
 };
 
 /**
@@ -712,7 +984,7 @@ export declare const CallAgentProvider: (props: CallAgentProviderProps) => JSX.E
  */
 export declare interface CallAgentProviderProps {
     children: React_2.ReactNode;
-    callAgent?: CallAgent;
+    callAgent?: CallAgent | /* @conditional-compile-remove(teams-identity-support) */ TeamsCallAgent;
 }
 
 /**
@@ -737,7 +1009,7 @@ export declare interface CallAgentState {
  */
 export declare interface CallAndChatLocator {
     /** Locator used by {@link createAzureCommunicationCallWithChatAdapter} to locate the call to join */
-    callLocator: GroupCallLocator;
+    callLocator: GroupCallLocator | /* @conditional-compile-remove(teams-adhoc-call) */ CallParticipantsLocator;
     /** Chat thread ID used by {@link createAzureCommunicationCallWithChatAdapter} to locate the chat thread to join */
     chatThreadId: string;
 }
@@ -824,6 +1096,16 @@ export declare interface CallClientState {
      * See documentation of {@Link CallErrors} for details.
      */
     latestErrors: CallErrors;
+    /**
+     * A phone number in E.164 format that will be used to represent callers identity.
+     * For example, using the alternateCallerId to add a participant using PSTN, this number will
+     * be used as the caller id in the PSTN call.
+     */
+    alternateCallerId?: string;
+    /**
+     * state to track the environment that the stateful client was made in is supported
+     */
+    environmentInfo?: EnvironmentInfo;
 }
 
 /**
@@ -887,6 +1169,10 @@ export declare type CallCompositeIcons = {
     ParticipantItemScreenShareStart?: JSX.Element;
     VideoTileMicOff?: JSX.Element;
     LocalCameraSwitch?: JSX.Element;
+    PeoplePaneAddPerson?: JSX.Element;
+    PeoplePaneOpenDialpad?: JSX.Element;
+    DialpadStartCall?: JSX.Element;
+    NoticePageInvalidRoom?: JSX.Element;
 };
 
 /**
@@ -907,6 +1193,60 @@ export declare type CallCompositeOptions = {
      * @defaultValue true
      */
     callControls?: boolean | CallControlOptions;
+    /**
+     * Device permissions check options for your call.
+     * Here you can choose what device permissions you prompt the user for,
+     * as well as what device permissions must be accepted before starting a call.
+     */
+    deviceChecks?: DeviceCheckOptions;
+    /**
+     * Callback you may provide to supply users with further steps to troubleshoot why they have been
+     * unable to grant your site the required permissions for the call.
+     *
+     * @example
+     * ```ts
+     * onPermissionsTroubleshootingClick: () =>
+     *  window.open('https://contoso.com/permissions-troubleshooting', '_blank');
+     * ```
+     *
+     * @remarks
+     * if this is not supplied, the composite will not show a 'further troubleshooting' link.
+     */
+    onPermissionsTroubleshootingClick?: (permissionsState: {
+        camera: PermissionState;
+        microphone: PermissionState;
+    }) => void;
+    /**
+     * Callback you may provide to supply users with further steps to troubleshoot why they have been
+     * having network issues when connecting to the call.
+     *
+     * @example
+     * ```ts
+     * onNetworkingTroubleShootingClick?: () =>
+     *  window.open('https://contoso.com/network-troubleshooting', '_blank');
+     * ```
+     *
+     * @remarks
+     * if this is not supplied, the composite will not show a 'network troubleshooting' link.
+     */
+    onNetworkingTroubleShootingClick?: () => void;
+    /**
+     * Callback you may provide to supply users with a provided page to showcase supported browsers by ACS.
+     *
+     * @example
+     * ```ts
+     * onBrowserTroubleShootingClick?: () =>
+     *  window.open('https://contoso.com/browser-troubleshooting', '_blank');
+     * ```
+     *
+     * @remarks
+     * if this is not supplied, the composite will not show a unsupported browser page.
+     */
+    onEnvironmentInfoTroubleshootingClick?: () => void;
+    /**
+     * Remote participant video tile menu options
+     */
+    remoteVideoTileMenu?: RemoteVideoTileMenuOptions;
 };
 
 /**
@@ -914,7 +1254,7 @@ export declare type CallCompositeOptions = {
  *
  * @public
  */
-export declare type CallCompositePage = 'accessDeniedTeamsMeeting' | 'call' | 'configuration' | 'joinCallFailedDueToNoNetwork' | 'leftCall' | 'lobby' | 'removedFromCall';
+export declare type CallCompositePage = 'accessDeniedTeamsMeeting' | 'call' | 'configuration' | /* @conditional-compile-remove(PSTN-calls) */ 'hold' | 'joinCallFailedDueToNoNetwork' | 'leftCall' | 'lobby' | /* @conditional-compile-remove(rooms) */ 'deniedPermissionToRoom' | 'removedFromCall' | /* @conditional-compile-remove(rooms) */ 'roomNotFound' | /* @conditional-compile-remove(unsupported-browser) */ 'unsupportedEnvironment';
 
 /**
  * Props for {@link CallComposite}.
@@ -1128,10 +1468,130 @@ export declare interface CallCompositeStrings {
      * Tooltip text used to inform a user that toggling microphone in lobby is not supported.
      */
     microphoneToggleInLobbyNotAllowed: string;
+    /**
+     * Side pane People section Title.
+     */
+    peoplePaneTitle: string;
+    /**
+     * Aria label string for return to call back button
+     */
+    returnToCallButtonAriaLabel?: string;
+    /**
+     * Aria Description string for return to call button
+     */
+    returnToCallButtonAriaDescription?: string;
+    /**
+     * control bar People button label
+     */
+    peopleButtonLabel: string;
+    /**
+     * control bar Chat button label.
+     */
+    chatButtonLabel: string;
+    /**
+     * Label for SidePaneHeader dismiss button
+     */
+    dismissSidePaneButtonLabel?: string;
+    /**
+     * Side pane People section subheader.
+     */
+    peoplePaneSubTitle: string;
+    /**
+     * Label for button to copy invite link
+     */
+    copyInviteLinkButtonLabel: string;
+    /**
+     * Label for button to open dialpad
+     */
+    openDialpadButtonLabel: string;
+    /**
+     * Label for menu item to remove participant
+     */
+    removeMenuLabel: string;
+    /**
+     * Label for add people dropdown
+     */
+    peoplePaneAddPeopleButtonLabel: string;
+    /**
+     * Label for button to start a call
+     */
+    dialpadStartCallButtonLabel: string;
+    /**
+     * Title for dialpad Modal
+     */
+    dialpadModalTitle: string;
+    /**
+     * Aria Label for dialpad Modal
+     */
+    dialpadModalAriaLabel: string;
+    /**
+     * Aria Label for dialpad Modal close button
+     */
+    dialpadCloseModalButtonAriaLabel: string;
+    /**
+     * label for more button in the Calling composite
+     */
+    moreButtonCallingLabel: string;
+    /**
+     * Label for the resume call button on the hold pane
+     */
+    resumeCallButtonLabel: string;
+    /**
+     * Label for the resume call button on the hold pane when call is resuming
+     */
+    resumingCallButtonLabel: string;
+    /**
+     * Aria label for the resume call button on the hold pane
+     */
+    resumeCallButtonAriaLabel: string;
+    /**
+     * Aria label for the resume call button on the hold pane when call is resuming
+     */
+    resumingCallButtonAriaLabel: string;
+    /**
+     * Label for the hold pane
+     */
+    holdScreenLabel: string;
+    /**
+     * Placeholder text for dtmf dialpad
+     */
+    dtmfDialpadPlaceholderText: string;
+    /**
+     * Label for the button to open dtmf dialpad
+     */
+    openDtmfDialpadLabel: string;
     /**
      * aria label for when the invite link has been actioned
      */
     copyInviteLinkActionedAriaLabel: string;
+    /**
+     * Title text of the page shown to the user when the user attempts to join a room that cannot be found.
+     */
+    roomNotFoundTitle: string;
+    /**
+     * More details text of the page shown to the user when the user attempts to join a room that cannot be found.
+     */
+    roomNotFoundDetails?: string;
+    /**
+     * Title text of the page shown to the user when the user attempts to join a room to which they are not invited.
+     */
+    deniedPermissionToRoomTitle: string;
+    /**
+     * More details text of the page shown to the user when the user attempts to join a room to which they are not invited.
+     */
+    deniedPermissionToRoomDetails?: string;
+    /**
+     * Control bar People button ToolTipContent
+     */
+    peopleButtonTooltipOpen: string;
+    /**
+     * Control bar People button ToolTipContent
+     */
+    peopleButtonTooltipClose: string;
+    /**
+     * Label disaplayed on the lobby screen during a 1:1 outbound call.
+     */
+    outboundCallingNoticeString: string;
     /**
      * Notice to be announced by narrator when a participant joins a call
      */
@@ -1205,7 +1665,9 @@ export declare type CallControlOptions = {
      * Show or Hide Camera Button during a call
      * @defaultValue true
      */
-    cameraButton?: boolean;
+    cameraButton?: boolean | /* @conditional-compile-remove(PSTN-calls) */ {
+        disabled: boolean;
+    };
     /**
      * Show or Hide EndCall button during a call.
      * @defaultValue true
@@ -1215,12 +1677,16 @@ export declare type CallControlOptions = {
      * Show or Hide Microphone button during a call.
      * @defaultValue true
      */
-    microphoneButton?: boolean;
+    microphoneButton?: boolean | /* @conditional-compile-remove(PSTN-calls) */ {
+        disabled: boolean;
+    };
     /**
      * Show or Hide Devices button during a call.
      * @defaultValue true
      */
-    devicesButton?: boolean;
+    devicesButton?: boolean | /* @conditional-compile-remove(PSTN-calls) */ {
+        disabled: boolean;
+    };
     /**
      * Show, Hide or Disable participants button during a call.
      * @defaultValue true
@@ -1235,6 +1701,20 @@ export declare type CallControlOptions = {
     screenShareButton?: boolean | {
         disabled: boolean;
     };
+    /**
+     * Show, Hide or disable the more button during a call.
+     * @defaultValue true
+     */
+    moreButton?: boolean;
+    /**
+     * Inject custom buttons in the call controls.
+     *
+     * @beta
+     */
+    onFetchCustomButtonProps?: CustomCallControlButtonCallback[];
+    holdButton?: boolean | {
+        disabled: boolean;
+    };
 };
 
 /**
@@ -1296,7 +1776,7 @@ export declare type CallErrors = {
  *
  * @public
  */
-export declare type CallErrorTarget = 'Call.addParticipant' | 'Call.feature' | 'Call.hangUp' | 'Call.hold' | 'Call.mute' | 'Call.off' | 'Call.on' | 'Call.removeParticipant' | 'Call.resume' | 'Call.sendDtmf' | 'Call.startScreenSharing' | 'Call.startVideo' | 'Call.stopScreenSharing' | 'Call.stopVideo' | 'Call.unmute' | 'CallAgent.dispose' | 'CallAgent.feature' | 'CallAgent.join' | 'CallAgent.off' | 'CallAgent.on' | 'CallAgent.startCall' | 'CallClient.createCallAgent' | 'CallClient.feature' | 'CallClient.getDeviceManager' | 'DeviceManager.askDevicePermission' | 'DeviceManager.getCameras' | 'DeviceManager.getMicrophones' | 'DeviceManager.getSpeakers' | 'DeviceManager.off' | 'DeviceManager.on' | 'DeviceManager.selectMicrophone' | 'DeviceManager.selectSpeaker' | 'IncomingCall.accept' | 'IncomingCall.reject';
+export declare type CallErrorTarget = 'Call.addParticipant' | /* @conditional-compile-remove(calling-beta-sdk) */ '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' | /* @conditional-compile-remove(calling-beta-sdk) */ /* @conditional-compile-remove(teams-identity-support) */ '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';
 
 /**
  * Callback for {@link CallAdapterSubscribers} 'callIdChanged' event.
@@ -1363,6 +1843,25 @@ export declare type CallParticipantListParticipant = ParticipantListParticipant
     isMuted?: boolean;
     /** Whether calling participant is speaking */
     isSpeaking?: boolean;
+    /** Role of participant in Rooms call */
+    role?: Role;
+};
+
+/**
+ * Locator used by {@link createAzureCommunicationCallAdapter} to call one or more participants
+ *
+ * @remarks
+ * This is currently in beta and only supports calling one Teams User.
+ *
+ * @example
+ * ```
+ * ['8:orgid:ab220efe-5725-4742-9792-9fba7c9ac458']
+ * ```
+ *
+ * @beta
+ */
+export declare type CallParticipantsLocator = {
+    participantIds: string[];
 };
 
 /**
@@ -1381,7 +1880,7 @@ export declare const CallProvider: (props: CallProviderProps) => JSX.Element;
  */
 export declare interface CallProviderProps {
     children: React_2.ReactNode;
-    call?: Call;
+    call?: Call | /* @conditional-compile-remove(teams-identity-support) */ TeamsCall;
 }
 
 /**
@@ -1395,6 +1894,10 @@ export declare interface CallState {
      * Proxy of {@link @azure/communication-calling#Call.id}.
      */
     id: string;
+    /**
+     * Type of the call.
+     */
+    kind: CallKind;
     /**
      * Proxy of {@link @azure/communication-calling#Call.callerInfo}.
      */
@@ -1477,6 +1980,10 @@ export declare interface CallState {
      * Stores the latest call diagnostics.
      */
     diagnostics: DiagnosticsCallFeatureState;
+    /**
+     * Proxy of {@link @azure/communication-calling#Call.role}.
+     */
+    role?: ParticipantRole;
 }
 
 /**
@@ -1500,6 +2007,12 @@ export declare interface CallWithChatAdapterManagement {
      * @public
      */
     removeParticipant(userId: string): Promise<void>;
+    /**
+     * Remove a participant from the call.
+     * @param participant - {@link @azure/communication-common#CommunicationIdentifier} of the participant to be removed
+     * @beta
+     */
+    removeParticipant(participant: CommunicationIdentifier): Promise<void>;
     /**
      * Join the call with microphone initially on/off.
      *
@@ -1554,6 +2067,12 @@ export declare interface CallWithChatAdapterManagement {
      * @public
      */
     startCall(participants: string[], options?: StartCallOptions): Call | undefined;
+    /**
+     * Start the call.
+     * @param participants - An array of {@link @azure/communication-common#CommunicationIdentifier} to be called
+     * @beta
+     */
+    startCall(participants: CommunicationIdentifier[], options?: StartCallOptions): Call | undefined;
     /**
      * Start sharing the screen during a call.
      *
@@ -1706,6 +2225,49 @@ export declare interface CallWithChatAdapterManagement {
      * @public
      */
     loadPreviousChatMessages(messagesToLoad: number): Promise<boolean>;
+    /** @beta */
+    registerActiveFileUploads: (files: File[]) => FileUploadManager[];
+    /** @beta */
+    registerCompletedFileUploads: (metadata: FileMetadata[]) => FileUploadManager[];
+    /** @beta */
+    clearFileUploads: () => void;
+    /** @beta */
+    cancelFileUpload: (id: string) => void;
+    /** @beta */
+    updateFileUploadProgress: (id: string, progress: number) => void;
+    /** @beta */
+    updateFileUploadErrorMessage: (id: string, errorMessage: string) => void;
+    /** @beta */
+    updateFileUploadMetadata: (id: string, metadata: FileMetadata) => void;
+    /**
+     * Puts the Call in a Localhold.
+     *
+     * @beta
+     */
+    holdCall: () => Promise<void>;
+    /**
+     * Resumes the call from a LocalHold state.
+     *
+     * @beta
+     */
+    resumeCall: () => Promise<void>;
+    /**
+     * Adds a new Participant to the call.
+     *
+     * @beta
+     */
+    addParticipant(participant: PhoneNumberIdentifier, options?: AddPhoneNumberOptions): Promise<void>;
+    addParticipant(participant: CommunicationUserIdentifier): Promise<void>;
+    /**
+     * send dtmf tone to another participant in the call in 1:1 calls
+     *
+     * @beta
+     */
+    sendDtmfTone: (dtmfTone: DtmfTone_2) => Promise<void>;
+    /**
+     * Continues into a call when the browser version is not supported.
+     */
+    allowUnsupportedBrowserVersion(): void;
 }
 
 /**
@@ -1776,6 +2338,22 @@ export declare interface CallWithChatAdapterUiState {
      * @public
      */
     page: CallCompositePage;
+    /**
+     * Files being uploaded by a user in the current thread.
+     * Should be set to null once the upload is complete.
+     * Array of type {@link FileUploadsUiState}
+     *
+     * @beta
+     */
+    fileUploads?: FileUploadsUiState;
+    /**
+     * State to track whether the end user has opted in to using a
+     * out of date version of a supported browser. Allows the user
+     * to start a call in this state.
+     *
+     * @beta
+     */
+    unsupportedBrowserVersionsAllowed?: boolean;
 }
 
 /**
@@ -1800,6 +2378,10 @@ export declare interface CallWithChatClientState {
     devices: DeviceManagerState;
     /** State of whether the active call is a Teams interop call */
     isTeamsCall: boolean;
+    /** alternateCallerId for PSTN call */
+    alternateCallerId?: string | undefined;
+    /** Environment information for system adapter is made on */
+    environmentInfo?: EnvironmentInfo;
 }
 
 /**
@@ -1866,6 +2448,9 @@ export declare type CallWithChatCompositeIcons = {
     ParticipantItemScreenShareStart?: JSX.Element;
     VideoTileMicOff?: JSX.Element;
     LocalCameraSwitch?: JSX.Element;
+    PeoplePaneAddPerson?: JSX.Element;
+    PeoplePaneOpenDialpad?: JSX.Element;
+    DialpadStartCall?: JSX.Element;
     EditBoxCancel?: JSX.Element;
     EditBoxSubmit?: JSX.Element;
     MessageDelivered?: JSX.Element;
@@ -1892,6 +2477,62 @@ export declare type CallWithChatCompositeOptions = {
      * If using the boolean values, true will cause default behavior across the whole control bar. False hides the whole control bar.
      */
     callControls?: boolean | CallWithChatControlOptions;
+    /**
+     * Properties for configuring the File Sharing feature.
+     * If undefined, file sharing feature will be disabled.
+     * @beta
+     */
+    fileSharing?: FileSharingOptions;
+    /**
+     * Device permissions check options for your call.
+     * Here you can choose what device permissions you prompt the user for,
+     * as well as what device permissions must be accepted before starting a call.
+     */
+    deviceChecks?: DeviceCheckOptions;
+    /**
+     * Callback you may provide to supply users with further steps to troubleshoot why they have been
+     * unable to grant your site the required permissions for the call.
+     *
+     * @example
+     * ```ts
+     * onPermissionsTroubleshootingClick: () =>
+     *  window.open('https://contoso.com/permissions-troubleshooting', '_blank');
+     * ```
+     *
+     * @remarks
+     * if this is not supplied, the composite will not show a 'further troubleshooting' link.
+     */
+    onPermissionsTroubleshootingClick?: (permissionsState: {
+        camera: PermissionState;
+        microphone: PermissionState;
+    }) => void;
+    /**
+     * Optional callback to supply users with further troubleshooting steps for network issues
+     * experienced when connecting to a call.
+     *
+     * @example
+     * ```ts
+     * onNetworkingTroubleShootingClick?: () =>
+     *  window.open('https://contoso.com/network-troubleshooting', '_blank');
+     * ```
+     *
+     * @remarks
+     * if this is not supplied, the composite will not show a 'network troubleshooting' link.
+     */
+    onNetworkingTroubleShootingClick?: () => void;
+    /**
+     * Callback you may provide to supply users with a provided page to showcase supported browsers by ACS.
+     *
+     * @example
+     * ```ts
+     * onBrowserTroubleShootingClick?: () =>
+     *  window.open('https://contoso.com/browser-troubleshooting', '_blank');
+     * ```
+     *
+     * @remarks
+     * if this is not supplied, the composite will not show a unsupported browser page.
+     */
+    onEnvironmentInfoTroubleshootingClick?: () => void;
 };
 
 /**
@@ -2017,6 +2658,10 @@ export declare interface CallWithChatCompositeStrings {
      * Label for button to copy invite link
      */
     copyInviteLinkButtonLabel: string;
+    /**
+     * Label for button to open dialpad
+     */
+    openDialpadButtonLabel: string;
     /**
      * Label for SidePaneHeader dismiss button
      */
@@ -2029,6 +2674,34 @@ export declare interface CallWithChatCompositeStrings {
      * Aria label string for return to call back button
      */
     returnToCallButtonAriaLabel?: string;
+    /**
+     * Label for add people dropdown
+     */
+    peoplePaneAddPeopleButtonLabel: string;
+    /**
+     * Label for button to start a call
+     */
+    dialpadStartCallButtonLabel: string;
+    /**
+     * Title for dialpad Modal
+     */
+    dialpadModalTitle: string;
+    /**
+     * Aria Label for dialpad Modal
+     */
+    dialpadModalAriaLabel: string;
+    /**
+     * Aria Label for dialpad Modal close button
+     */
+    dialpadCloseModalButtonAriaLabel: string;
+    /**
+     * Placeholder text for dtmf dialpad
+     */
+    dtmfDialpadPlaceholderText: string;
+    /**
+     * Label for the button to open dtmf dialpad
+     */
+    openDtmfDialpadLabel: string;
     /**
      * aria label for when the invite link has been actioned
      */
@@ -2055,12 +2728,16 @@ export declare interface CallWithChatControlOptions {
      * Show or Hide Microphone button during a call.
      * @defaultValue true
      */
-    microphoneButton?: boolean;
+    microphoneButton?: boolean | /* @conditional-compile-remove(PSTN-calls) */ {
+        disabled: boolean;
+    };
     /**
      * Show or Hide Camera Button during a call
      * @defaultValue true
      */
-    cameraButton?: boolean;
+    cameraButton?: boolean | /* @conditional-compile-remove(PSTN-calls) */ {
+        disabled: boolean;
+    };
     /**
      * Show, Hide or Disable the screen share button during a call.
      * @defaultValue true
@@ -2077,12 +2754,32 @@ export declare interface CallWithChatControlOptions {
      * Show or hide the chat button in the call-with-chat composite control bar.
      * @defaultValue true
      */
-    chatButton?: boolean;
+    chatButton?: boolean | /* @conditional-compile-remove(PSTN-calls) */ {
+        disabled: boolean;
+    };
     /**
      * Show or hide the people button in the call-with-chat composite control bar.
      * @defaultValue true
      */
-    peopleButton?: boolean;
+    peopleButton?: boolean | /* @conditional-compile-remove(PSTN-calls) */ {
+        disabled: boolean;
+    };
+    /**
+     * Inject custom buttons in the call controls.
+     *
+     * @beta
+     */
+    onFetchCustomButtonProps?: CustomCallWithChatControlButtonCallback[];
+    /**
+     * Show or hide the more button in the call-with-chat control bar.
+     */
+    moreButton?: boolean;
+    /**
+     * Show or hide the hold button in the bottom sheet drawer
+     */
+    holdButton?: boolean | {
+        disabled: boolean;
+    };
 }
 
 /**
@@ -2092,6 +2789,35 @@ export declare interface CallWithChatControlOptions {
  */
 export declare type CallWithChatEvent = 'callError' | 'chatError' | 'callEnded' | 'isMutedChanged' | 'callIdChanged' | 'isLocalScreenSharingActiveChanged' | 'displayNameChanged' | 'isSpeakingChanged' | 'callParticipantsJoined' | 'callParticipantsLeft' | 'selectedMicrophoneChanged' | 'selectedSpeakerChanged' | 'messageReceived' | 'messageSent' | 'messageRead' | 'chatParticipantsAdded' | 'chatParticipantsRemoved';
 
+/**
+ * @beta
+ *
+ * Component to allow Contoso to help their end user with their devices should their permissions be blocked
+ * by their browsers settings.
+ */
+export declare const CameraAndMicrophoneSitePermissions: (props: CameraAndMicrophoneSitePermissionsProps) => JSX.Element;
+
+/**
+ * @beta
+ * Props for CameraAndMicrophoneSitePermissions component.
+ */
+export declare interface CameraAndMicrophoneSitePermissionsProps extends CommonSitePermissionsProps {
+    /** Icon name for the camera icon */
+    cameraIconName?: string;
+    /** Icon name for the microphone icon */
+    microphoneIconName?: string;
+    /** Icon name for the central icon between the camera and microphone icons */
+    connectorIconName?: string;
+    /** Strings for use with the {@link CameraAndMicrophoneSitePermissions} */
+    strings?: CameraAndMicrophoneSitePermissionsStrings;
+}
+
+/**
+ * @beta
+ * Strings for CameraAndMicrophoneSitePermissions component.
+ */
+export declare type CameraAndMicrophoneSitePermissionsStrings = SitePermissionsStrings;
+
 /**
  * A button to turn camera on / off.
  *
@@ -2228,12 +2954,37 @@ export declare interface CameraButtonStyles extends ControlBarButtonStyles {
     menuStyles?: Partial<CameraButtonContextualMenuStyles>;
 }
 
+/**
+ * Component to allow Contoso to help their end user with their devices should their permissions be blocked
+ * by their browsers settings.
+ *
+ * @beta
+ */
+export declare const CameraSitePermissions: (props: CameraSitePermissionsProps) => JSX.Element;
+
+/**
+ * @beta
+ * Props for CameraSitePermissions component.
+ */
+export declare interface CameraSitePermissionsProps extends CommonSitePermissionsProps {
+    /** Icon name for the camera icon */
+    cameraIconName?: string;
+    /** Strings for use with the {@link CameraSitePermissions} */
+    strings?: CameraSitePermissionsStrings;
+}
+
+/**
+ * @beta
+ * Strings for CameraSitePermissions component.
+ */
+export declare type CameraSitePermissionsStrings = SitePermissionsStrings;
+
 /**
  * {@link ChatComposite} Adapter interface.
  *
  * @public
  */
-export declare type ChatAdapter = ChatAdapterThreadManagement & AdapterState<ChatAdapterState> & Disposable & ChatAdapterSubscribers;
+export declare type ChatAdapter = ChatAdapterThreadManagement & AdapterState<ChatAdapterState> & Disposable & ChatAdapterSubscribers & FileUploadAdapter;
 
 /**
  * {@link ChatAdapter} state.
@@ -2341,7 +3092,9 @@ export declare interface ChatAdapterThreadManagement {
     /**
      * Update a message content.
      */
-    updateMessage(messageId: string, content: string, metadata?: Record<string, string>): Promise<void>;
+    updateMessage(messageId: string, content: string, metadata?: Record<string, string>, options?: {
+        attachedFilesMetadata?: FileMetadata[];
+    }): Promise<void>;
     /**
      * Delete a message in the thread.
      */
@@ -2363,6 +3116,13 @@ export declare interface ChatAdapterThreadManagement {
  */
 export declare type ChatAdapterUiState = {
     error?: Error;
+    /**
+     * Files being uploaded by a user in the current thread.
+     * Should be set to null once the upload is complete.
+     * Array of type {@link FileUploadsUiState}
+     * @beta
+     */
+    fileUploads?: FileUploadsUiState;
 };
 
 /**
@@ -2465,6 +3225,7 @@ export declare type ChatCompositeIcons = {
     ParticipantItemOptionsHovered?: JSX.Element;
     SendBoxSend?: JSX.Element;
     SendBoxSendHovered?: JSX.Element;
+    SendBoxAttachFile?: JSX.Element;
 };
 
 /**
@@ -2479,6 +3240,13 @@ export declare type ChatCompositeOptions = {
      * @defaultValue true
      */
     errorBar?: boolean;
+    /**
+     * Show or hide the participant pane. This feature is in beta and not supported on mobile or narrow screen views.
+     * @defaultValue false
+     *
+     * @beta
+     */
+    participantPane?: boolean;
     /**
      * Show or hide the topic at the top of the chat. Hidden if set to `false`
      * @defaultValue true
@@ -2489,6 +3257,12 @@ export declare type ChatCompositeOptions = {
      * When undefined nothing has focus on render
      */
     autoFocus?: 'sendBoxTextField';
+    /**
+     * Properties for configuring the File Sharing feature.
+     * If undefined, file sharing feature will be disabled.
+     * @beta
+     */
+    fileSharing?: FileSharingOptions;
 };
 
 /**
@@ -2516,6 +3290,12 @@ export declare interface ChatCompositeProps extends BaseCompositeProps<ChatCompo
      * Flags to enable/disable visual elements of the {@link ChatComposite}.
      */
     options?: ChatCompositeOptions;
+    /**
+     * Optimizes the composite form factor for either desktop or mobile.
+     * @remarks `mobile` is currently only optimized for Portrait mode on mobile devices and does not support landscape.
+     * @defaultValue 'desktop'
+     */
+    formFactor?: 'desktop' | 'mobile';
 }
 
 /**
@@ -2530,6 +3310,10 @@ export declare interface ChatCompositeStrings {
      * Chat list header text
      */
     chatListHeader: string;
+    /**
+     * Upload File Button text
+     */
+    uploadFile: string;
 }
 
 /**
@@ -2595,7 +3379,9 @@ export declare type ChatHandlers = {
     onRemoveParticipant: (userId: string) => Promise<void>;
     updateThreadTopicName: (topicName: string) => Promise<void>;
     onLoadPreviousChatMessages: (messagesToLoad: number) => Promise<boolean>;
-    onUpdateMessage: (messageId: string, content: string) => Promise<void>;
+    onUpdateMessage: (messageId: string, content: string, metadata?: Record<string, string>, options?: {
+        attachedFilesMetadata?: FileMetadata[];
+    }) => Promise<void>;
     onDeleteMessage: (messageId: string) => Promise<void>;
 };
 
@@ -2621,6 +3407,12 @@ export declare interface ChatMessage extends MessageCommon {
      * {@link @azure/communication-chat#ChatMessage.metadata}
      */
     metadata?: Record<string, string>;
+    /**
+     * @beta
+     * A list of files attached to the message.
+     * {@link FileMetadata}
+     */
+    attachedFilesMetadata?: FileMetadata[];
 }
 
 /**
@@ -2767,6 +3559,12 @@ export declare interface CommonCallAdapter extends AdapterState<CallAdapterState
      * @public
      */
     startCall(participants: string[], options?: StartCallOptions): void;
+    /**
+     * Start the call.
+     * @param participants - An array of {@link @azure/communication-common#CommunicationIdentifier} to be called
+     * @beta
+     */
+    startCall(participants: CommunicationIdentifier[], options?: StartCallOptions): void;
 }
 
 /**
@@ -2788,11 +3586,17 @@ export declare interface CommonCallingHandlers {
     onStopScreenShare: () => Promise<void>;
     onToggleScreenShare: () => Promise<void>;
     onHangUp: (forEveryone?: boolean) => Promise<void>;
+    onToggleHold: () => Promise<void>;
+    onAddParticipant(participant: CommunicationUserIdentifier): Promise<void>;
+    onAddParticipant(participant: PhoneNumberIdentifier, options: AddPhoneNumberOptions): Promise<void>;
     onCreateLocalStreamView: (options?: VideoStreamOptions) => Promise<void | CreateVideoStreamViewResult>;
     onCreateRemoteStreamView: (userId: string, options?: VideoStreamOptions) => Promise<void | CreateVideoStreamViewResult>;
     onDisposeRemoteStreamView: (userId: string) => Promise<void>;
     onDisposeLocalStreamView: () => Promise<void>;
+    onSendDtmfTone: (dtmfTone: DtmfTone_2) => Promise<void>;
     onRemoveParticipant(userId: string): Promise<void>;
+    onRemoveParticipant(participant: CommunicationIdentifier): Promise<void>;
+    askDevicePermission: (constrain: PermissionConstraints) => Promise<void>;
     onStartCall: (participants: (CommunicationUserIdentifier | PhoneNumberIdentifier | UnknownIdentifier)[], options?: StartCallOptions) => void;
 }
 
@@ -2805,6 +3609,39 @@ export declare type CommonProperties<A, B> = {
     [P in keyof A & keyof B]: A[P] extends B[P] ? P : never;
 }[keyof A & keyof B];
 
+/**
+ * @beta
+ * Props for SitePermissions components.
+ */
+export declare interface CommonSitePermissionsProps {
+    /**
+     * Name of application calling experience is in.
+     */
+    appName: string;
+    /**
+     * Type of the Site Permissions component.
+     */
+    type: 'request' | 'denied' | 'check';
+    /**
+     * Type of the browser used, the Site permission component will show different guidance text based on the browser type
+     */
+    browserHint?: 'safari' | 'unset';
+    /**
+     * Action to be taken by the more help link. Possible to send to external page or show other modal.
+     * If this is not provided the button will not be shown.
+     */
+    onTroubleshootingClick?: () => void;
+    /**
+     * Action that is taken when the user clicks the continue anyway button.
+     * If this is not provided the button will not be shown.
+     */
+    onContinueAnywayClick?: () => void;
+    /**
+     * Styles for SitePermissions component.
+     */
+    styles?: SitePermissionsStyles;
+}
+
 /**
  * A Chat or Calling participant's state, as reflected in the UI.
  *
@@ -2932,6 +3769,11 @@ export declare type ComponentIcons = Record<keyof typeof DEFAULT_COMPONENT_ICONS
 export declare interface ComponentLocale {
     /** Strings for components */
     strings: ComponentStrings;
+    /**
+     * Optional function to provide customized date format.
+     * @beta
+     */
+    onDisplayDateTimeString?: (messageDate: Date) => string;
 }
 
 /**
@@ -2973,6 +3815,46 @@ export declare interface ComponentStrings {
     errorBar: ErrorBarStrings;
     /** Strings for VideoGallery */
     videoGallery: VideoGalleryStrings;
+    /** Strings for Dialpad */
+    dialpad: DialpadStrings;
+    /** Strings for VideoTile */
+    videoTile: VideoTileStrings;
+    /** Strings for HoldButton */
+    holdButton: HoldButtonStrings;
+    /** Strings for a site's permission request prompt */
+    CameraAndMicrophoneSitePermissionsRequest: SitePermissionsStrings;
+    /** Strings for a site's permission request prompt */
+    CameraSitePermissionsRequest: SitePermissionsStrings;
+    /** Strings for a site's permission request prompt */
+    MicrophoneSitePermissionsRequest: SitePermissionsStrings;
+    /** Strings for a site's permission generic checking prompt */
+    CameraAndMicrophoneSitePermissionsCheck: SitePermissionsStrings;
+    /** Strings for a site's permission generic checking prompt */
+    CameraSitePermissionsCheck: SitePermissionsStrings;
+    /** Strings for a site's permission generic checking prompt */
+    MicrophoneSitePermissionsCheck: SitePermissionsStrings;
+    /** Strings for a site's permission denied prompt */
+    CameraAndMicrophoneSitePermissionsDenied: SitePermissionsStrings;
+    /** Strings for a site's permission denied prompt for safari browsers*/
+    CameraAndMicrophoneSitePermissionsDeniedSafari: SitePermissionsStrings;
+    /** Strings for a site's permission denied prompt */
+    CameraSitePermissionsDenied: SitePermissionsStrings;
+    /** Strings for a site's permission denied prompt */
+    MicrophoneSitePermissionsDenied: SitePermissionsStrings;
+    /** Strings for a site's permission denied prompt for safari browsers*/
+    CameraSitePermissionsDeniedSafari: SitePermissionsStrings;
+    /** Strings for a site's permission denied prompt for safari browsers*/
+    MicrophoneSitePermissionsDeniedSafari: SitePermissionsStrings;
+    /** Strings for unsupported browser UI */
+    UnsupportedBrowser: UnsupportedBrowserStrings;
+    /** Strings for unsupported browser version UI */
+    UnsupportedBrowserVersion: UnsupportedBrowserVersionStrings;
+    /** Strings for unsupported browser version UI */
+    UnsupportedOperatingSystem: UnsupportedOperatingSystemStrings;
+    /** Strings for BrowserPemissionDenied */
+    BrowserPermissionDenied: BrowserPermissionDeniedStrings;
+    /** Strings for BrowserPemissionDeniedIOS */
+    BrowserPermissionDeniedIOS: BrowserPermissionDeniedIOSStrings;
 }
 
 /**
@@ -3280,7 +4162,7 @@ export declare interface ControlBarProps {
  *
  * @public
  */
-export declare const createAzureCommunicationCallAdapter: ({ userId, displayName, credential, locator }: AzureCommunicationCallAdapterArgs) => Promise<CallAdapter>;
+export declare const createAzureCommunicationCallAdapter: ({ userId, displayName, credential, locator, alternateCallerId }: AzureCommunicationCallAdapterArgs) => Promise<CallAdapter>;
 
 /**
  * Create a {@link CallAdapter} using the provided {@link StatefulCallClient}.
@@ -3290,7 +4172,7 @@ export declare const createAzureCommunicationCallAdapter: ({ userId, displayName
  *
  * @public
  */
-export declare const createAzureCommunicationCallAdapterFromClient: (callClient: StatefulCallClient, callAgent: CallAgent, locator: CallAdapterLocator) => Promise<CallAdapter>;
+export declare const createAzureCommunicationCallAdapterFromClient: (callClient: StatefulCallClient, callAgent: CallAgent, locator: CallAdapterLocator, options?: AzureCommunicationCallAdapterOptions) => Promise<CallAdapter>;
 
 /**
  * Create a CallWithChatAdapter backed by Azure Communication services
@@ -3298,7 +4180,7 @@ export declare const createAzureCommunicationCallAdapterFromClient: (callClient:
  *
  * @public
  */
-export declare const createAzureCommunicationCallWithChatAdapter: ({ userId, displayName, credential, endpoint, locator }: AzureCommunicationCallWithChatAdapterArgs) => Promise<CallWithChatAdapter>;
+export declare const createAzureCommunicationCallWithChatAdapter: ({ userId, displayName, credential, endpoint, locator, alternateCallerId, callAdapterOptions }: AzureCommunicationCallWithChatAdapterArgs) => Promise<CallWithChatAdapter>;
 
 /**
  * Create a {@link CallWithChatAdapter} using the provided {@link StatefulChatClient} and {@link StatefulCallClient}.
@@ -3351,6 +4233,16 @@ export declare const createDefaultCallingHandlers: (callClient: StatefulCallClie
  */
 export declare const createDefaultChatHandlers: (chatClient: StatefulChatClient, chatThreadClient: ChatThreadClient) => ChatHandlers;
 
+/**
+ * Create the default implementation of {@link TeamsCallingHandlers} for teams call.
+ *
+ * Useful when implementing a custom component that utilizes the providers
+ * exported from this library.
+ *
+ * @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;
+
 /**
  * Creates a StatefulCallClient {@link StatefulCallClient} by proxying CallClient
  * {@link @azure/communication-calling#CallClient} with ProxyCallClient {@link ProxyCallClient} which then allows access
@@ -3376,6 +4268,21 @@ export declare const createStatefulCallClient: (args: StatefulCallClientArgs, op
  */
 export declare const createStatefulChatClient: (args: StatefulChatClientArgs, options?: StatefulChatClientOptions | undefined) => StatefulChatClient;
 
+/**
+ * @beta
+ */
+export declare const createTeamsCallAdapter: ({ userId, credential, locator }: TeamsCallAdapterArgs) => Promise<TeamsCallAdapter>;
+
+/**
+ * Create a {@link TeamsCallAdapter} using the provided {@link StatefulCallClient}.
+ *
+ * Useful if you want to keep a reference to {@link StatefulCallClient}.
+ * Consider using {@link createAzureCommunicationCallAdapter} for a simpler API.
+ *
+ * @beta
+ */
+export declare const createTeamsCallAdapterFromClient: (callClient: StatefulCallClient, callAgent: TeamsCallAgent, locator: CallAdapterLocator) => Promise<TeamsCallAdapter>;
+
 /**
  * Object returned after creating a local or remote VideoStream.
  * This contains helper functions to manipulate the render of the stream.
@@ -3426,8 +4333,164 @@ export declare type CustomAvatarOptions = {
     styles?: IStyleFunctionOrObject<IPersonaStyleProps, IPersonaStyles>;
     /** Display name to be used in Persona  */
     text?: string;
+    /** State for the participant to be displayed in the defaultPlaceHolder */
+    participantState?: ParticipantState;
+    /**
+     * If true, show the special coin for unknown persona.
+     * It has '?' in place of initials, with static font and background colors
+     */
+    showUnknownPersonaCoin?: boolean;
 };
 
+/**
+ * A callback that returns the props to render a custom {@link ControlBarButton}.
+ *
+ * The response indicates where the custom button should be placed.
+ *
+ * Performance tip: This callback is only called when either the callback or its arguments change.
+ *
+ * @beta
+ */
+export declare type CustomCallControlButtonCallback = (args: CustomCallControlButtonCallbackArgs) => CustomCallControlButtonProps;
+
+/**
+ * Arguments for {@link CustomCallControlButtonCallback}.
+ *
+ * @beta
+ */
+export declare interface CustomCallControlButtonCallbackArgs {
+    /**
+     * Buttons should reduce the size to fit a smaller viewport when `displayType` is `'compact'`.
+     *
+     * @defaultValue `'default'`
+     */
+    displayType?: CallControlDisplayType;
+}
+
+/**
+ * Placement for a custom button injected in the {@link CallControls}.
+ *
+ * 'primary': Place the button(s) on the right end of the center control bar but before the EndCallButton (left end in rtl mode).
+ *
+ * Multiple buttons assigned the same placement are appended in order.
+ * E.g., if two buttons are placed in 'primary', they'll both appear on the right end (left end in rtl mode)
+ * before the EndCallButton in the order provided.
+ *
+ * @beta
+ */
+export declare type CustomCallControlButtonPlacement = 'primary';
+
+/**
+ * Response from {@link CustomCallControlButtonCallback}.
+ *
+ * Includes the placement prop necessary to indicate where to place the
+ * {@link ControlBarButton} and a {@link DrawerMenuItem}
+ *
+ * @beta
+ */
+export declare interface CustomCallControlButtonProps extends CustomControlButtonProps {
+    /**
+     * Where to place the custom button relative to other buttons.
+     */
+    placement: CustomCallControlButtonPlacement;
+    /**
+     * Icon to render. Icon is a non-default icon name that needs to be registered as a
+     * custom icon using registerIcons through fluentui. Examples include icons from the fluentui library
+     */
+    iconName?: string;
+}
+
+/**
+ * A callback that returns the props to render a custom {@link ControlBarButton} and {@link DrawerMenuItem}.
+ *
+ * The response indicates where the custom button should be placed.
+ *
+ * Performance tip: This callback is only called when either the callback or its arguments change.
+ * @beta
+ */
+export declare type CustomCallWithChatControlButtonCallback = (args: CustomCallControlButtonCallbackArgs) => CustomCallWithChatControlButtonProps;
+
+/**
+ * Placement for a custom button injected in the {@link CallWithChatControlBar}.
+ *
+ * 'primary': Place the button(s) on the right end of the center control bar but before the EndCallButton (left end in rtl mode).
+ * 'overflow': Place the buttons(s) on the end of the overflow Menu.
+ * 'secondary': Place the button(s) on the left end of the side control bar (right in rtl mode).
+ *
+ * Multiple buttons assigned the same placement are appended in order.
+ * E.g., if two buttons are placed in 'secondary', they'll both appear on the left end (right end in rtl mode)
+ * in the order provided.
+ *
+ * @beta
+ */
+export declare type CustomCallWithChatControlButtonPlacement = 'primary' | 'overflow' | 'secondary';
+
+/**
+ * Response from {@link CustomCallWithChatControlButtonCallback}.
+ *
+ * Includes the icon and placement prop necessary to indicate where to place the
+ * {@link ControlBarButton} and a {@link DrawerMenuItem}
+ *
+ * @beta
+ */
+export declare interface CustomCallWithChatControlButtonProps extends CustomControlButtonProps {
+    /**
+     * Where to place the custom button relative to other buttons.
+     */
+    placement: CustomCallWithChatControlButtonPlacement;
+    /**
+     * Icon to render. Icon is a non-default icon name that needs to be registered as a
+     * custom icon using registerIcons through fluentui. Examples include icons from the fluentui library
+     */
+    iconName?: string;
+}
+
+/**
+ * Includes the base props necessary to render a {@link ControlBarButton} or {@link DrawerMenuItem}.
+ *
+ * @beta
+ */
+export declare interface CustomControlButtonProps {
+    /**
+     * Calback for when button is clicked
+     */
+    onItemClick?: () => void;
+    /**
+     * Whether the buttons is disabled
+     */
+    disabled?: boolean;
+    /**
+     * Whether the label is displayed or not.
+     *
+     * @defaultValue `false`
+     */
+    showLabel?: boolean;
+    /**
+     * Fluent styles, common to all {@link ControlBarButton}s or {@link DrawerMenuItem}s.
+     */
+    styles?: ControlBarButtonStyles | BaseCustomStyles;
+    /**
+     * Optional label for the button
+     */
+    text?: string;
+    /**
+     * A unique key for the button
+     */
+    key?: string | number;
+    /**
+     * The aria label of the button for the benefit of screen readers.
+     */
+    ariaLabel?: string;
+    /**
+     * Detailed description of the button for the benefit of screen readers.
+     */
+    ariaDescription?: string;
+    /**
+     * A unique id set for the standard HTML id attibute
+     */
+    id?: string;
+}
+
 /**
  * A custom message type.
  *
@@ -3447,6 +4510,18 @@ export declare interface CustomMessage extends MessageCommon {
  */
 export declare const darkTheme: PartialTheme & CallingTheme;
 
+/**
+ * @beta
+ * `DeclarativeCallAgent` extends and proxies the {@link @azure/communication-calling#CallAgent}
+ */
+export declare type DeclarativeCallAgent = CallAgent & IncomingCallManagement;
+
+/**
+ * @beta
+ * Proxies the {@link @azure/communication-calling#IncomingCall} interface.
+ */
+export declare type DeclarativeIncomingCall = IncomingCall;
+
 /**
  * The default set of icons that are available to use in the UI components.
  *
@@ -3463,8 +4538,11 @@ export declare const DEFAULT_COMPONENT_ICONS: {
     ControlButtonMicOn: JSX.Element;
     ControlButtonOptions: JSX.Element;
     ControlButtonParticipants: JSX.Element;
+    ControlButtonParticipantsContextualMenuItem: JSX.Element;
     ControlButtonScreenShareStart: JSX.Element;
     ControlButtonScreenShareStop: JSX.Element;
+    CancelFileUpload: JSX.Element;
+    DownloadFile: JSX.Element;
     EditBoxCancel: JSX.Element;
     EditBoxSubmit: JSX.Element;
     ErrorBarCallCameraAccessDenied: JSX.Element;
@@ -3497,9 +4575,26 @@ export declare const DEFAULT_COMPONENT_ICONS: {
     ParticipantItemOptions: JSX.Element;
     ParticipantItemOptionsHovered: JSX.Element;
     ParticipantItemScreenShareStart: JSX.Element;
+    HoldCallContextualMenuItem: JSX.Element;
+    HoldCallButton: JSX.Element;
+    ResumeCall: JSX.Element;
     SendBoxSend: JSX.Element;
     SendBoxSendHovered: JSX.Element;
     VideoTileMicOff: JSX.Element;
+    DialpadBackspace: JSX.Element;
+    SitePermissionsSparkle: JSX.Element;
+    SitePermissionCamera: JSX.Element;
+    SitePermissionMic: JSX.Element;
+    SitePermissionCameraDenied: JSX.Element;
+    SitePermissionMicDenied: JSX.Element;
+    UnsupportedEnvironmentWarning: JSX.Element;
+    BrowserPermissionDeniedError: JSX.Element;
+    VideoTilePinned: JSX.Element;
+    VideoTileMoreOptions: JSX.Element;
+    VideoTileScaleFit: JSX.Element;
+    VideoTileScaleFill: JSX.Element;
+    PinParticipant: JSX.Element;
+    UnpinParticipant: JSX.Element;
 };
 
 /**
@@ -3520,6 +4615,7 @@ export declare const DEFAULT_COMPOSITE_ICONS: {
     ParticipantItemOptionsHovered: JSX.Element;
     SendBoxSend: JSX.Element;
     SendBoxSendHovered: JSX.Element;
+    SendBoxAttachFile?: JSX.Element | undefined;
     ControlButtonCameraOff: JSX.Element;
     ControlButtonCameraOn: JSX.Element;
     ControlButtonEndCall: JSX.Element;
@@ -3562,6 +4658,10 @@ export declare const DEFAULT_COMPOSITE_ICONS: {
     ParticipantItemScreenShareStart: JSX.Element;
     VideoTileMicOff: JSX.Element;
     LocalCameraSwitch?: JSX.Element | undefined;
+    PeoplePaneAddPerson?: JSX.Element | undefined;
+    PeoplePaneOpenDialpad?: JSX.Element | undefined;
+    DialpadStartCall?: JSX.Element | undefined;
+    NoticePageInvalidRoom?: JSX.Element | undefined;
     ChevronLeft?: JSX.Element | undefined;
     ControlBarChatButtonActive?: JSX.Element | undefined;
     ControlBarChatButtonInactive?: JSX.Element | undefined;
@@ -3572,13 +4672,55 @@ export declare const DEFAULT_COMPOSITE_ICONS: {
     MoreDrawerSelectedMicrophone?: JSX.Element | undefined;
     MoreDrawerSelectedSpeaker?: JSX.Element | undefined;
     MoreDrawerSpeakers?: JSX.Element | undefined;
-    SendBoxAttachFile?: JSX.Element | undefined;
     ChatMessageOptions: JSX.Element;
+    ControlButtonParticipantsContextualMenuItem: JSX.Element;
+    CancelFileUpload: JSX.Element;
+    DownloadFile: JSX.Element;
     ErrorBarCallVideoRecoveredBySystem: JSX.Element;
     ErrorBarCallVideoStoppedBySystem: JSX.Element;
     MessageResend: JSX.Element;
+    HoldCallContextualMenuItem: JSX.Element;
+    HoldCallButton: JSX.Element;
+    ResumeCall: JSX.Element;
+    DialpadBackspace: JSX.Element;
+    SitePermissionsSparkle: JSX.Element;
+    SitePermissionCamera: JSX.Element;
+    SitePermissionMic: JSX.Element;
+    SitePermissionCameraDenied: JSX.Element;
+    SitePermissionMicDenied: JSX.Element;
+    UnsupportedEnvironmentWarning: JSX.Element;
+    BrowserPermissionDeniedError: JSX.Element;
+    VideoTilePinned: JSX.Element;
+    VideoTileMoreOptions: JSX.Element;
+    VideoTileScaleFit: JSX.Element;
+    VideoTileScaleFill: JSX.Element;
+    PinParticipant: JSX.Element;
+    UnpinParticipant: JSX.Element;
 };
 
+/**
+ * Device Checks.
+ * Choose whether or not to block starting a call depending on camera and microphone permission options.
+ *
+ * @beta
+ */
+export declare interface DeviceCheckOptions {
+    /**
+     * Camera Permission prompts for your call.
+     * 'required' - requires the permission to be allowed before permitting the user join the call.
+     * 'optional' - permission can be disallowed and the user is still permitted to join the call.
+     * 'doNotPrompt' - permission is not required and the user is not prompted to allow the permission.
+     */
+    camera: 'required' | 'optional' | 'doNotPrompt';
+    /**
+     * Microphone permission prompts for your call.
+     * 'required' - requires the permission to be allowed before permitting the user join the call.
+     * 'optional' - permission can be disallowed and the user is still permitted to join the call.
+     * 'doNotPrompt' - permission is not required and the user is not prompted to allow the permission.
+     */
+    microphone: 'required' | 'optional' | 'doNotPrompt';
+}
+
 /**
  * This type is meant to encapsulate all the state inside {@link @azure/communication-calling#DeviceManager}. For
  * optional parameters they may not be available until permission is granted by the user. The cameras, microphones,
@@ -3797,6 +4939,60 @@ export declare interface DiagnosticsCallFeatureState {
     media: MediaDiagnosticsState;
 }
 
+/**
+ * A component to allow users to enter phone number through clicking on dialpad/using keyboard
+ * It will return empty component for stable builds
+ *
+ * @beta
+ */
+export declare const Dialpad: (props: DialpadProps) => JSX.Element;
+
+/**
+ * Props for {@link Dialpad} component.
+ *
+ * @beta
+ */
+export declare interface DialpadProps {
+    strings?: DialpadStrings;
+    /**  function to send dtmf tones on button click */
+    onSendDtmfTone?: (dtmfTone: DtmfTone) => Promise<void>;
+    /**  Callback for dialpad button behavior*/
+    onClickDialpadButton?: (buttonValue: string, buttonIndex: number) => void;
+    /** set dialpad textfield content */
+    textFieldValue?: string;
+    /**  on change function for text field, provides an unformatted plain text*/
+    onChange?: (input: string) => void;
+    /**  boolean input to determine when to show/hide delete button, default true */
+    showDeleteButton?: boolean;
+    /**  boolean input to determine if dialpad is in mobile view, default false */
+    isMobile?: boolean;
+    styles?: DialpadStyles;
+}
+
+/**
+ * Strings of {@link Dialpad} that can be overridden.
+ *
+ * @beta
+ */
+export declare interface DialpadStrings {
+    placeholderText: string;
+    deleteButtonAriaLabel?: string;
+}
+
+/**
+ * Styles for {@link Dialpad} component.
+ *
+ * @beta
+ */
+export declare interface DialpadStyles {
+    root?: IStyle;
+    button?: IButtonStyles;
+    textField?: Partial<ITextFieldStyles>;
+    digit?: IStyle;
+    letter?: IStyle;
+    deleteIcon?: IButtonStyles;
+}
+
 /**
  * Callback for {@link CallAdapterSubscribers} 'displayNameChanged' event.
  *
@@ -3817,6 +5013,13 @@ export declare interface Disposable {
     dispose(): void;
 }
 
+/**
+ * DTMF tone for PSTN calls.
+ *
+ * @beta
+ */
+export declare type DtmfTone = 'A' | 'B' | 'C' | 'D' | 'Flash' | 'Num0' | 'Num1' | 'Num2' | 'Num3' | 'Num4' | 'Num5' | 'Num6' | 'Num7' | 'Num8' | 'Num9' | 'Pound' | 'Star';
+
 /**
  * A type for trivial selectors that return no data.
  *
@@ -4057,6 +5260,199 @@ export declare interface ErrorBarStrings {
  */
 export declare type ErrorType = keyof ErrorBarStrings;
 
+/**
+ * @beta
+ * A file download error returned via a {@link FileDownloadHandler}.
+ * This error message is used to render an error message in the UI.
+ */
+export declare interface FileDownloadError {
+    /** The error message to display in the UI */
+    errorMessage: string;
+}
+
+/**
+ * @beta
+ *
+ * A callback function for handling file downloads.
+ * The function needs to return a promise that resolves to a file download URL.
+ * If the promise is rejected, the {@link Error.message} will be used to display an error message to the user.
+ *
+ * @example
+ * ```ts
+ * const fileDownloadHandler: FileDownloadHandler = async (userId, fileData) => {
+ *   if (isUnauthorizedUser(userId)) {
+ *     return { errorMessage: 'You don’t have permission to download this file.' };
+ *   } else {
+ *     return new URL(fileData.url);
+ *   }
+ * }
+ *
+ * const App = () => (
+ *   <ChatComposite
+ *     ...
+ *     fileSharing={{
+ *       fileDownloadHandler: fileDownloadHandler
+ *     }}
+ *   />
+ * )
+ *
+ * ```
+ * @param userId - The user ID of the user downloading the file.
+ * @param fileMetadata - The {@link FileMetadata} containing file `url`, `extension` and `name`.
+ */
+export declare type FileDownloadHandler = (userId: string, fileMetadata: FileMetadata) => Promise<URL | FileDownloadError>;
+
+/**
+ * Meta Data containing information about the uploaded file.
+ * @beta
+ */
+export declare interface FileMetadata {
+    /**
+     * File name to be displayed.
+     */
+    name: string;
+    /**
+     * Extension is used for rendering the file icon.
+     * An unknown extension will be rendered as a generic icon.
+     * Example: `jpeg`
+     */
+    extension: string;
+    /**
+     * Download URL for the file.
+     */
+    url: string;
+}
+
+/**
+ * Properties for configuring the File Sharing feature.
+ * @beta
+ */
+export declare interface FileSharingOptions {
+    /**
+     * A string containing the comma separated list of accepted file types.
+     * Similar to the `accept` attribute of the `<input type="file" />` element.
+     * Accepts any type of file if not specified.
+     * @beta
+     */
+    accept?: string;
+    /**
+     * Allows multiple files to be selected if set to `true`.
+     * Similar to the `multiple` attribute of the `<input type="file" />` element.
+     * @defaultValue false
+     * @beta
+     */
+    multiple?: boolean;
+    /**
+     * A function of type {@link FileUploadHandler} for handling file uploads.
+     * @beta
+     */
+    uploadHandler: FileUploadHandler;
+    /**
+     * A function of type {@link FileDownloadHandler} for handling file downloads.
+     * If the function is not specified, the file's `url` will be opened in a new tab to
+     * initiate the download.
+     */
+    downloadHandler?: FileDownloadHandler;
+}
+
+/**
+ * @beta
+ */
+export declare interface FileUploadAdapter {
+    registerActiveFileUploads: (files: File[]) => FileUploadManager[];
+    registerCompletedFileUploads: (metadata: FileMetadata[]) => FileUploadManager[];
+    clearFileUploads: () => void;
+    cancelFileUpload: (id: string) => void;
+    updateFileUploadProgress: (id: string, progress: number) => void;
+    updateFileUploadErrorMessage: (id: string, errorMessage: string) => void;
+    updateFileUploadMetadata: (id: string, metadata: FileMetadata) => void;
+}
+
+/**
+ * @beta
+ * Error message to be displayed to the user if the upload fails.
+ */
+export declare type FileUploadError = {
+    message: string;
+    timestamp: number;
+};
+
+/**
+ * @beta
+ * A callback function for handling file uploads.
+ *
+ * @param userId - The user ID of the user uploading the file.
+ * @param fileUploads - The list of uploaded files. Each file is represented by an {@link FileUpload} object.
+ */
+export declare type FileUploadHandler = (userId: string, fileUploads: FileUploadManager[]) => void;
+
+/**
+ * A wrapper object for a file that is being uploaded.
+ * Allows mmanaging file uploads by providing common functions for updating the
+ * upload progress, canceling an upload, completing an upload etc.
+ * @beta
+ */
+export declare interface FileUploadManager {
+    /**
+     * Unique identifier for the file upload.
+     */
+    id: string;
+    /**
+     * HTML {@link File} object for the uploaded file.
+     */
+    file?: File;
+    /**
+     * Update the progress of the upload.
+     * @param value - number between 0 and 1
+     */
+    notifyUploadProgressChanged: (value: number) => void;
+    /**
+     * Mark the upload as complete.
+     * Requires the `metadata` param containing uploaded file information.
+     * @param metadata - {@link FileMetadata}
+     */
+    notifyUploadCompleted: (metadata: FileMetadata) => void;
+    /**
+     * Mark the upload as failed.
+     * @param message - An error message that can be displayed to the user.
+     */
+    notifyUploadFailed: (message: string) => void;
+}
+
+/**
+ * Contains the state attibutes of a file upload like name, progress etc.
+ * @beta
+ */
+export declare interface FileUploadState {
+    /**
+     * Unique identifier for the file upload.
+     */
+    id: string;
+    /**
+     * Filename extracted from the {@link File} object.
+     * This attribute is used to render the filename if `metadata.name` is not available.
+     */
+    filename: string;
+    /**
+     * A number between 0 and 1 indicating the progress of the upload.
+     */
+    progress: number;
+    /**
+     * Meta Data {@link FileMetadata} containing information about the uploaded file.
+     */
+    metadata?: FileMetadata;
+    /**
+     * Error message to be displayed to the user if the upload fails.
+     */
+    error?: FileUploadError;
+}
+
+/**
+ * A record containing {@link FileUploadState} mapped to unique ids.
+ * @beta
+ */
+export declare type FileUploadsUiState = Record<string, FileUploadState>;
+
 /**
  * Provider to apply a Fluent theme across this library's react components.
  *
@@ -4097,7 +5493,7 @@ export declare const fromFlatCommunicationIdentifier: (id: string) => Communicat
  *
  * @public
  */
-export declare type GetCallingSelector<Component extends (props: any) => JSX.Element | undefined> = AreEqual<Component, typeof VideoGallery> extends true ? VideoGallerySelector : AreEqual<Component, typeof DevicesButton> extends true ? DevicesButtonSelector : AreEqual<Component, typeof MicrophoneButton> extends true ? MicrophoneButtonSelector : AreEqual<Component, typeof CameraButton> extends true ? CameraButtonSelector : AreEqual<Component, typeof ScreenShareButton> extends true ? ScreenShareButtonSelector : AreEqual<Component, typeof ParticipantList> extends true ? ParticipantListSelector : AreEqual<Component, typeof ParticipantsButton> extends true ? ParticipantsButtonSelector : AreEqual<Component, typeof EndCallButton> extends true ? EmptySelector : AreEqual<Component, typeof ErrorBar> extends true ? CallErrorBarSelector : undefined;
+export declare type GetCallingSelector<Component extends (props: any) => JSX.Element | undefined> = AreEqual<Component, typeof VideoGallery> extends true ? VideoGallerySelector : AreEqual<Component, typeof DevicesButton> extends true ? DevicesButtonSelector : AreEqual<Component, typeof MicrophoneButton> extends true ? MicrophoneButtonSelector : AreEqual<Component, typeof CameraButton> extends true ? CameraButtonSelector : AreEqual<Component, typeof ScreenShareButton> extends true ? ScreenShareButtonSelector : AreEqual<Component, typeof ParticipantList> extends true ? ParticipantListSelector : AreEqual<Component, typeof ParticipantsButton> extends true ? ParticipantsButtonSelector : AreEqual<Component, typeof EndCallButton> extends true ? EmptySelector : AreEqual<Component, typeof ErrorBar> extends true ? CallErrorBarSelector : AreEqual<Component, typeof Dialpad> extends true ? EmptySelector : AreEqual<Component, typeof HoldButton> extends true ? HoldButtonSelector : undefined;
 
 /**
  * Get the selector for a specified component.
@@ -4151,12 +5547,69 @@ export declare interface GridLayoutProps {
 }
 
 /**
- * {@link GridLayout} Component Styles.
- * @public
+ * {@link GridLayout} Component Styles.
+ * @public
+ */
+export declare interface GridLayoutStyles extends BaseCustomStyles {
+    /** Styles for each child of {@link GridLayout} */
+    children?: IStyle;
+}
+
+/**
+ * a button to hold or resume a ongoing call.
+ *
+ * Can be used with {@link ControlBar}
+ *
+ * @param props - properties for the hold button.
+ * @returns
+ * @beta
+ */
+export declare const HoldButton: (props: HoldButtonProps) => JSX.Element;
+
+/**
+ *@beta
+ */
+export declare interface HoldButtonProps extends ControlBarButtonProps {
+    /**
+     * Utility property for using this component with communication react handlers
+     * Holds the call or resumes it based on call state.
+     */
+    onToggleHold: () => Promise<void>;
+    /**
+     * Optional strings to override in component
+     */
+    strings?: HoldButtonStrings;
+}
+
+/**
+ * Selector type for the {@link HoldButton} component.
+ * @public
+ */
+export declare type HoldButtonSelector = (state: CallClientState, props: CallingBaseSelectorProps) => {
+    checked: boolean;
+};
+
+/**
+ * Strings for the hold button labels
+ * @beta
  */
-export declare interface GridLayoutStyles extends BaseCustomStyles {
-    /** Styles for each child of {@link GridLayout} */
-    children?: IStyle;
+export declare interface HoldButtonStrings {
+    /**
+     * Label for when action is to resume call.
+     */
+    onLabel: string;
+    /**
+     * Label for when action is to hold call.
+     */
+    offLabel: string;
+    /**
+     * Content for when button is checked
+     */
+    tooltipOnContent: string;
+    /**
+     * Content for when button is unchecked
+     */
+    tooltipOffContent: string;
 }
 
 /**
@@ -4239,6 +5692,20 @@ export declare interface _Identifiers {
     horizontalGalleryRightNavButton: string;
 }
 
+/**
+ * @beta
+ * This contains a readonly array that returns all the active `incomingCalls`.
+ * An active incoming call is a call that has not been answered, declined or disconnected.
+ */
+export declare type IncomingCallManagement = {
+    /**
+     * @beta
+     * @Remark This attribute doesn't exist on the {@link @azure/communication-calling#CallAgent} interface.
+     * @returns readonly array of {@link DeclarativeIncomingCall}
+     */
+    incomingCalls: ReadonlyArray<DeclarativeIncomingCall>;
+};
+
 /**
  * State only version of {@link @azure/communication-calling#IncomingCall}. {@link StatefulCallClient} will
  * automatically detect incoming calls and add their state to the state exposed by {@link StatefulCallClient}.
@@ -4705,6 +6172,11 @@ export declare type MessageThreadProps = {
      * `messageRenderer` is not provided for `CustomMessage` and thus only available for `ChatMessage` and `SystemMessage`.
      */
     onRenderMessage?: (messageProps: MessageProps, messageRenderer?: MessageRenderer) => JSX.Element;
+    /**
+     * Optional callback to render uploaded files in the message component.
+     * @beta
+     */
+    onRenderFileDownloads?: (userId: string, message: ChatMessage) => JSX.Element;
     /**
      * Optional callback to edit a message.
      *
@@ -4740,6 +6212,18 @@ export declare type MessageThreadProps = {
      * Optional strings to override in component
      */
     strings?: Partial<MessageThreadStrings>;
+    /**
+     * @beta
+     * Optional function called when someone clicks on the file download icon.
+     * If file attachments are defined in the `message.metadata` property using the `fileSharingMetadata` key,
+     * this function will be called with the data inside `fileSharingMetadata` key.
+     */
+    fileDownloadHandler?: FileDownloadHandler;
+    /**
+     * Optional function to provide customized date format.
+     * @beta
+     */
+    onDisplayDateTimeString?: (messageDate: Date) => string;
 };
 
 /**
@@ -4811,6 +6295,8 @@ export declare interface MessageThreadStrings {
     editBoxSubmitButton: string;
     /** String for action menu indicating there are more options */
     actionMenuMoreOptions?: string;
+    /** String for download file button in file card */
+    downloadFile: string;
 }
 
 /**
@@ -4993,6 +6479,31 @@ export declare interface MicrophoneButtonStyles extends ControlBarButtonStyles {
     menuStyles?: Partial<MicrophoneButtonContextualMenuStyles>;
 }
 
+/**
+ * Component to allow Contoso to help their end user with their devices should their permissions be blocked
+ * by their browsers settings.
+ *
+ * @beta
+ */
+export declare const MicrophoneSitePermissions: (props: MicrophoneSitePermissionsProps) => JSX.Element;
+
+/**
+ * @beta
+ * Props for MicrophoneSitePermissions component.
+ */
+export declare interface MicrophoneSitePermissionsProps extends CommonSitePermissionsProps {
+    /** Icon name for the microphone icon */
+    microphoneIconName?: string;
+    /** Strings for use with the {@link MicrophoneSitePermissions} */
+    strings?: MicrophoneSitePermissionsStrings;
+}
+
+/**
+ * @beta
+ * Strings for MicrophoneSitePermissions component.
+ */
+export declare type MicrophoneSitePermissionsStrings = SitePermissionsStrings;
+
 /**
  * Payload for {@link DiagnosticChangedEventListner} where there is a change in a network diagnostic.
  *
@@ -5100,6 +6611,14 @@ export declare interface ParticipantItemProps {
     onClick?: (props?: ParticipantItemProps) => void;
     /** prop to determine if we should show tooltip for participants or not */
     showParticipantOverflowTooltip?: boolean;
+    /**
+     * Optional value to determine and display a participants connection status.
+     * For example, `Connecting`, `Ringing` etc.
+     * The actual text that is displayed is determined by the localized string
+     * corresponding to the provided participant state.
+     * For example, `strings.participantStateConnecting` will be used if `participantState` is `Connecting`.
+     */
+    participantState?: ParticipantState;
 }
 
 /**
@@ -5120,6 +6639,10 @@ export declare interface ParticipantItemStrings {
     mutedIconLabel: string;
     /** placeholder text for participants who does not have a display name*/
     displayNamePlaceholder?: string;
+    /** String shown when `participantState` is `Ringing` */
+    participantStateRinging?: string;
+    /** String shown when `participantState` is `Hold` */
+    participantStateHold?: string;
 }
 
 /**
@@ -5490,6 +7013,10 @@ export declare interface RemoteParticipantState {
      * Proxy of {@link @azure/communication-calling#RemoteParticipant.isSpeaking}.
      */
     isSpeaking: boolean;
+    /**
+     * Proxy of {@link @azure/communication-calling#RemoteParticipant.role}.
+     */
+    role?: ParticipantRole;
 }
 
 /**
@@ -5514,6 +7041,7 @@ export declare interface RemoteVideoStreamState {
      * Proxy of {@link @azure/communication-calling#RemoteVideoStream.isReceiving}.
      * @beta
      */
+    isReceiving: boolean;
     /**
      * {@link VideoStreamRendererView} that is managed by createView/disposeView in {@link StatefulCallClient}
      * API. This can be undefined if the stream has not yet been rendered and defined after createView creates the view.
@@ -5521,6 +7049,26 @@ export declare interface RemoteVideoStreamState {
     view?: VideoStreamRendererViewState;
 }
 
+/**
+ * Menu options for remote video tiles in {@link VideoGallery}.
+ *
+ * @beta
+ */
+export declare interface RemoteVideoTileMenuOptions {
+    /**
+     * If set to true, remote video tiles in the VideoGallery will not have menu options
+     *
+     * @defaultValue false
+     */
+    isHidden?: boolean;
+}
+
+/**
+ * @beta
+ * The role of a call participant.
+ */
+export declare type Role = 'Presenter' | 'Attendee' | 'Consumer' | 'Organizer';
+
 /**
  * A button to start / stop screen sharing.
  *
@@ -5554,6 +7102,7 @@ export declare interface ScreenShareButtonProps extends ControlBarButtonProps {
  */
 export declare type ScreenShareButtonSelector = (state: CallClientState, props: CallingBaseSelectorProps) => {
     checked?: boolean;
+    disabled?: boolean;
 };
 
 /**
@@ -5591,6 +7140,19 @@ export declare type Selector = (state: ClientState, props: any) => any;
  */
 export declare const SendBox: (props: SendBoxProps) => JSX.Element;
 
+/**
+ * @beta
+ * Error to be displayed to the user in an error bar above sendbox.
+ */
+export declare interface SendBoxErrorBarError {
+    /** Error Message to be displayed */
+    message: string;
+    /**
+     * Unix Timestamp. Preferred generation using `Date.now()`
+     */
+    timestamp: number;
+}
+
 /**
  * Props for {@link SendBox}.
  *
@@ -5646,6 +7208,25 @@ export declare interface SendBoxProps {
      * When undefined nothing has focus on render
      */
     autoFocus?: 'sendBoxTextField';
+    /**
+     * Optional callback to render uploaded files in the SendBox. The sendbox will expand
+     * veritcally to accomodate the uploaded files. File uploads will
+     * be rendered below the text area in sendbox.
+     * @beta
+     */
+    onRenderFileUploads?: () => JSX.Element;
+    /**
+     * Optional array of active file uploads where each object has attibutes
+     * of a file upload like name, progress, errorMessage etc.
+     * @beta
+     */
+    activeFileUploads?: ActiveFileUpload[];
+    /**
+     * Optional callback to remove the file upload before sending by clicking on
+     * cancel icon.
+     * @beta
+     */
+    onCancelFileUpload?: (fileId: string) => void;
 }
 
 /**
@@ -5676,6 +7257,22 @@ export declare interface SendBoxStrings {
      * Aria label for send message button
      */
     sendButtonAriaLabel: string;
+    /**
+     * Error message indicating that all file uploads are not complete.
+     */
+    fileUploadsPendingError: string;
+    /**
+     * Aria label to notify user when focus is on cancel file upload button.
+     */
+    removeFile: string;
+    /**
+     * Aria label to notify user file uploading starts.
+     */
+    uploading: string;
+    /**
+     * Aria label to notify user file is uploaded.
+     */
+    uploadCompleted: string;
 }
 
 /**
@@ -5696,6 +7293,45 @@ export declare interface SendBoxStylesProps extends BaseCustomStyles {
     systemMessage?: IStyle;
 }
 
+/**
+ * @beta
+ * Strings for SitePermissions component
+ */
+export declare type SitePermissionsStrings = {
+    /**
+     * Main text string.
+     */
+    primaryText?: string;
+    /**
+     * Subtext string.
+     */
+    secondaryText?: string;
+    /**
+     * More help link string.
+     */
+    linkText?: string;
+    /**
+     * Primary button text string.
+     */
+    primaryButtonText?: string;
+    /**
+     * Aria label describing the content of the container
+     */
+    ariaLabel?: string;
+};
+
+/**
+ * Fluent styles for {@link SitePermissionsContainer}.
+ *
+ * @beta
+ */
+export declare interface SitePermissionsStyles extends BaseCustomStyles {
+    /** Styles for the primary button. */
+    primaryButton?: IButtonStyles;
+    /** Styles for the help troubleshooting link text. */
+    troubleshootingLink?: ILinkStyles;
+}
+
 /**
  * Defines the methods that allow CallClient {@link @azure/communication-calling#CallClient} to be used statefully.
  * The interface provides access to proxied state and also allows registering a handler for state change events. For
@@ -5802,6 +7438,19 @@ export declare interface StatefulCallClient extends CallClient {
      * @param stream - The LocalVideoStreamState or RemoteVideoStreamState to dispose.
      */
     disposeView(callId: string | undefined, participantId: CommunicationIdentifier | undefined, stream: LocalVideoStreamState | RemoteVideoStreamState): void;
+    /** @conditional-compile-remove(one-to-n-calling) */
+    /**
+     * The CallAgent is used to handle calls.
+     * To create the CallAgent, pass a CommunicationTokenCredential object provided from SDK.
+     * - The CallClient can only have one active CallAgent instance at a time.
+     * - You can create a new CallClient instance to create a new CallAgent.
+     * - You can dispose of a CallClient's current active CallAgent, and call the CallClient's
+     *   createCallAgent() method again to create a new CallAgent.
+     * @param tokenCredential - The token credential. Use AzureCommunicationTokenCredential from `@azure/communication-common` to create a credential.
+     * @param options - The CallAgentOptions for additional options like display name.
+     * @public
+     */
+    createCallAgent(...args: Parameters<CallClient['createCallAgent']>): Promise<DeclarativeCallAgent>;
 }
 
 /**
@@ -5814,7 +7463,16 @@ export declare type StatefulCallClientArgs = {
      * UserId from SDK. This is provided for developer convenience to easily access the userId from the
      * state. It is not used by StatefulCallClient.
      */
-    userId: CommunicationUserIdentifier;
+    userId: CommunicationUserIdentifier | /* @conditional-compile-remove(teams-identity-support) */ MicrosoftTeamsUserIdentifier;
+    /**
+     * A phone number in E.164 format that will be used to represent the callers identity. This number is required
+     * to start a PSTN call.
+     *
+     * example: +11234567
+     *
+     * This is not a cached value from the headless calling client.
+     */
+    alternateCallerId?: string;
 };
 
 /**
@@ -5954,6 +7612,59 @@ export declare interface SystemMessageCommon extends MessageCommon {
     iconName: string;
 }
 
+/**
+ * An Adapter interface specific for Teams identity which extends {@link CommonCallAdapter}.
+ *
+ * @beta
+ */
+export declare interface TeamsCallAdapter extends CommonCallAdapter {
+    /**
+     * Join the call with microphone initially on/off.
+     *
+     * @param microphoneOn - Whether microphone is initially enabled
+     *
+     * @beta
+     */
+    joinCall(microphoneOn?: boolean): TeamsCall | undefined;
+    /**
+     * Start the call.
+     *
+     * @param participants - An array of participant ids to join
+     *
+     * @beta
+     */
+    startCall(participants: string[], options?: StartCallOptions): TeamsCall | undefined;
+    /**
+     * Start the call.
+     * @param participants - An array of {@link @azure/communication-common#CommunicationIdentifier} to be called
+     * @beta
+     */
+    startCall(participants: CommunicationIdentifier[], options?: StartCallOptions): TeamsCall | undefined;
+}
+
+/**
+ * Arguments for creating the Azure Communication Services implementation of {@link TeamsCallAdapter}.
+ *
+ * @beta
+ */
+export declare type TeamsCallAdapterArgs = {
+    userId: MicrosoftTeamsUserIdentifier;
+    credential: CommunicationTokenCredential;
+    locator: TeamsMeetingLinkLocator;
+};
+
+/**
+ * Object containing all the teams call handlers required for calling components.
+ *
+ * Calling related components from this package are able to pick out relevant handlers from this object.
+ * See {@link useHandlers} and {@link usePropsFor}.
+ *
+ * @beta
+ */
+export declare interface TeamsCallingHandlers extends CommonCallingHandlers {
+    onStartCall: (participants: CommunicationIdentifier[], options?: StartCallOptions) => undefined | /* @conditional-compile-remove(teams-identity-support) */ TeamsCall;
+}
+
 /**
  * A string representation of a {@link @azure/communication-common#CommunicationIdentifier}.
  *
@@ -6133,11 +7844,117 @@ export declare interface TypingIndicatorStylesProps extends BaseCustomStyles {
     typingString?: IStyle;
 }
 
+/**
+ * UI to display to the user that the browser they are using is not supported by Azure Communications Calling service.
+ *
+ * @beta
+ */
+export declare const UnsupportedBrowser: (props: UnsupportedBrowserProps) => JSX.Element;
+
+/**
+ * props for {@link UnsupportedBrowser} UI
+ *
+ * @beta
+ */
+export declare interface UnsupportedBrowserProps {
+    /** Handler to perform an action when the help link is actioned */
+    onTroubleshootingClick?: () => void;
+    /** String overrides for the component */
+    strings?: UnsupportedBrowserStrings;
+}
+
+/**
+ * Strings for UnsupportedBrowser component
+ *
+ * @beta
+ */
+export declare interface UnsupportedBrowserStrings {
+    /** String for the primary text */
+    primaryText: string;
+    /** String for the secondary text */
+    secondaryText: string;
+    /** String to display in the text for the help link */
+    moreHelpLinkText: string;
+}
+
+/**
+ * UI to display to the user that the browser version they are using is out of date
+ * and not supported by Azure Communications Calling service.
+ *
+ * @beta
+ */
+export declare const UnsupportedBrowserVersion: (props: UnsupportedBrowserVersionProps) => JSX.Element;
+
+/**
+ * props for {@link UnsupportedBrowserVersion} UI
+ *
+ * @beta
+ */
+export declare interface UnsupportedBrowserVersionProps {
+    /** Handler to perform an action when the help link is actioned */
+    onTroubleshootingClick?: () => void;
+    /** String overrides for the component */
+    strings?: UnsupportedBrowserVersionStrings;
+    /** Handler to allow user to continue into the call */
+    onContinueAnywayClick?: () => void;
+}
+
+/**
+ * Strings for UnsupportedBrowser component
+ *
+ * @beta
+ */
+export declare interface UnsupportedBrowserVersionStrings {
+    /** String for the primary text */
+    primaryText: string;
+    /** String for the secondary text */
+    secondaryText: string;
+    /** String to display in the text for the help link */
+    moreHelpLinkText: string;
+    /** String for continue without updating button */
+    continueAnywayButtonText?: string;
+}
+
+/**
+ * UI to display to the user that the operating system they are using is not supported by Azure Communications Calling service.
+ *
+ * @beta
+ */
+export declare const UnsupportedOperatingSystem: (props: UnsupportedOperatingSystemProps) => JSX.Element;
+
+/**
+ * Props for {@link UnsupportedOperatingSystem} UI
+ *
+ * @beta
+ */
+export declare interface UnsupportedOperatingSystemProps {
+    /** Handler to perform a action when the help link is actioned */
+    onTroubleshootingClick?: () => void;
+    /** String overrides for the component */
+    strings?: UnsupportedOperatingSystemStrings;
+}
+
+/**
+ * Strings for UnsupportedBrowser component
+ *
+ * @beta
+ */
+export declare interface UnsupportedOperatingSystemStrings {
+    /** String for the primary text */
+    primaryText: string;
+    /** String for the secondary text */
+    secondaryText: string;
+    /** String to display in the text for the help link */
+    moreHelpLinkText: string;
+}
+
 /**
  * @public
  * Callback function run when a message is updated.
  */
-export declare type UpdateMessageCallback = (messageId: string, content: string) => Promise<void>;
+export declare type UpdateMessageCallback = (messageId: string, content: string, metadata?: Record<string, string>, options?: {
+    attachedFilesMetadata?: FileMetadata[];
+}) => Promise<void>;
 
 /**
  * A custom React hook to simplify the creation of {@link CallAdapter}.
@@ -6285,6 +8102,44 @@ export declare const usePropsFor: <Component extends (props: any) => JSX.Element
  */
 export declare const useSelector: <ParamT extends Selector | undefined>(selector: ParamT, selectorProps?: (ParamT extends Selector ? Parameters<ParamT>[1] : undefined) | undefined, type?: "chat" | "calling" | undefined) => ParamT extends Selector ? ReturnType<ParamT> : undefined;
 
+/**
+ * Hook to obtain {@link @azure/communication-calling#TeamsCall} from the provider.
+ *
+ * Useful when implementing a custom component that utilizes the providers
+ * exported from this library.
+ *
+ * you must have previously used the CallProvider with a TeamsCall object to use this hook
+ *
+ * @beta
+ */
+export declare const useTeamsCall: () => undefined | /* @conditional-compile-remove(teams-identity-support) */ TeamsCall;
+
+/**
+ * A custom React hook to simplify the creation of {@link TeamsCallAdapter}.
+ *
+ * Similar to {@link createTeamsAzureCommunicationCallAdapter}, but takes care of asynchronous
+ * creation of the adapter internally.
+ *
+ * Allows arguments to be undefined so that you can respect the rule-of-hooks and pass in arguments
+ * as they are created. The adapter is only created when all arguments are defined.
+ *
+ * Note that you must memoize the arguments to avoid recreating adapter on each render.
+ * See storybook for typical usage examples.
+ *
+ * @beta
+ */
+export declare const useTeamsCallAdapter: (args: Partial<TeamsCallAdapterArgs>, afterCreate?: ((adapter: TeamsCallAdapter) => Promise<TeamsCallAdapter>) | undefined, beforeDispose?: ((adapter: TeamsCallAdapter) => Promise<void>) | undefined) => TeamsCallAdapter | undefined;
+
+/**
+ * Hook to obtain {@link @azure/communication-calling#TeamsCallAgent} from the provider.
+ *
+ * Useful when implementing a custom component that utilizes the providers
+ * exported from this library.
+ *
+ * @beta
+ */
+export declare const useTeamsCallAgent: () => undefined | /* @conditional-compile-remove(teams-identity-support) */ TeamsCallAgent;
+
 /**
  * React hook to access theme
  *
@@ -6391,6 +8246,24 @@ export declare interface VideoGalleryProps {
      * Camera control information for button to switch cameras.
      */
     localVideoCameraCycleButtonProps?: LocalVideoCameraCycleButtonProps;
+    /**
+     * List of pinned participant userIds.
+     */
+    pinnedParticipants?: string[];
+    /**
+     * This callback will be called when a participant video tile is pinned.
+     */
+    onPinParticipant?: (userId: string) => void;
+    /**
+     * This callback will be called when a participant video tile is un-pinned.
+     */
+    onUnpinParticipant?: (userId: string) => void;
+    /**
+     * Options for showing the remote video tile menu.
+     *
+     * @defaultValue \{ kind: 'contextual' \}
+     */
+    remoteVideoTileMenuOptions?: false | VideoTileContextualMenuProps | VideoTileDrawerMenuProps;
 }
 
 /**
@@ -6403,6 +8276,11 @@ export declare interface VideoGalleryRemoteParticipant extends VideoGalleryParti
     isSpeaking?: boolean;
     /** Video stream of shared screen */
     screenShareStream?: VideoGalleryStream;
+    /**
+     * @beta
+     * The connection state of the participant. For example, 'Hold', 'Connecting' etc.
+     */
+    state?: ParticipantState;
 }
 
 /**
@@ -6433,6 +8311,8 @@ export declare interface VideoGalleryStream {
     isMirrored?: boolean;
     /** Render element of the video stream */
     renderElement?: HTMLElement;
+    /** Scaling mode of the video stream */
+    scalingMode?: ViewScalingMode;
 }
 
 /**
@@ -6455,6 +8335,14 @@ export declare interface VideoGalleryStrings {
     localVideoSelectedDescription: string;
     /** placeholder text for participants who does not have a display name*/
     displayNamePlaceholder: string;
+    /** Menu text shown in Video Tile contextual menu for setting a remote participants video to fit in frame */
+    fitRemoteParticipantToFrame: string;
+    /** Menu text shown in Video Tile contextual menu for setting a remote participants video to fill the frame */
+    fillRemoteParticipantFrame: string;
+    /** Menu text shown in Video Tile contextual menu for pinning a remote participant's video tile */
+    pinParticipantForMe: string;
+    /** Menu text shown in Video Tile contextual menu for setting a remote participant's video tile */
+    unpinParticipantForMe: string;
 }
 
 /**
@@ -6512,6 +8400,36 @@ export declare interface VideoStreamRendererViewState {
  */
 export declare const VideoTile: (props: VideoTileProps) => JSX.Element;
 
+/**
+ * Properties for showing contextual menu for remote {@link VideoTile} components in {@link VideoGallery}.
+ *
+ * @beta
+ */
+export declare interface VideoTileContextualMenuProps {
+    /**
+     * The menu property kind
+     */
+    kind: 'contextual';
+}
+
+/**
+ * Properties for showing drawer menu on remote {@link VideoTile} long touch in {@link VideoGallery}.
+ *
+ * @beta
+ */
+export declare interface VideoTileDrawerMenuProps {
+    /**
+     * The menu property kind
+     */
+    kind: 'drawer';
+    /**
+     * The optional id property provided on an element that the drawer menu should render within when a
+     * remote participant video tile Drawer is shown. If an id is not provided, then a drawer menu will
+     * render within the VideoGallery component.
+     */
+    hostId?: string;
+}
+
 /**
  * Props for {@link VideoTile}.
  *
@@ -6550,6 +8468,10 @@ export declare interface VideoTileProps {
      * Whether the video is muted or not.
      */
     isMuted?: boolean;
+    /**
+     * If true, the video tile will show the pin icon.
+     */
+    isPinned?: boolean;
     /**
      * Display Name of the Participant to be shown in the label.
      * @remarks `displayName` is used to generate avatar initials if `initialsName` is not provided.
@@ -6578,6 +8500,31 @@ export declare interface VideoTileProps {
     noVideoAvailableAriaLabel?: string;
     /** Whether the participant in the videoTile is speaking. Shows a speaking indicator (border). */
     isSpeaking?: boolean;
+    /**
+     * The call connection state of the participant.
+     * For example, `Hold` means the participant is on hold.
+     */
+    participantState?: ParticipantState;
+    strings?: VideoTileStrings;
+    /**
+     * Display custom menu items in the VideoTile's contextual menu.
+     * Uses Fluent UI ContextualMenu.
+     * An ellipses icon will be displayed to open the contextual menu if this prop is defined.
+     */
+    contextualMenu?: IContextualMenuProps;
+    /**
+     * Callback triggered by video tile on touch and hold.
+     */
+    onLongTouch?: () => void;
+}
+
+/**
+ * Strings of {@link VideoTile} that can be overridden.
+ * @beta
+ */
+export declare interface VideoTileStrings {
+    participantStateRinging: string;
+    participantStateHold: string;
 }
 
 /**