@azure/communication-react 1.4.0 → 1.4.1-beta.1

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';
@@ -42,18 +43,24 @@ 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 { 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 { IContextualMenuStyles } from '@fluentui/react';
+import { IDropdownOption } from '@fluentui/react';
+import { IDropdownStyles } 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';
@@ -61,6 +68,7 @@ import { MediaStreamType } from '@azure/communication-calling';
 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 +79,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 +113,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.
  *
@@ -218,6 +261,25 @@ export declare type AzureCommunicationCallAdapterArgs = {
     displayName: string;
     credential: CommunicationTokenCredential;
     locator: CallAdapterLocator;
+    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 +293,7 @@ export declare type AzureCommunicationCallWithChatAdapterArgs = {
     displayName: string;
     credential: CommunicationTokenCredential;
     locator: CallAndChatLocator | TeamsMeetingLinkLocator;
+    alternateCallerId?: string;
 };
 
 /**
@@ -314,6 +377,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;
+}
+
 /**
  * {@link CallComposite} Adapter interface.
  *
@@ -389,6 +582,12 @@ export declare interface CallAdapterCallManagement {
      * @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.
      *
@@ -409,6 +608,12 @@ export declare interface CallAdapterCallManagement {
      * @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.
      *
@@ -433,6 +638,31 @@ export declare interface CallAdapterCallManagement {
      * @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>;
 }
 
 /**
@@ -451,6 +681,16 @@ 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;
+    /**
+     * 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;
 };
 
 /**
@@ -535,7 +775,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 CallAdapter} state.
@@ -688,7 +928,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;
 }
 
 /**
@@ -713,7 +953,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;
 }
@@ -800,6 +1040,12 @@ 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;
 }
 
 /**
@@ -863,6 +1109,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;
 };
 
 /**
@@ -883,6 +1133,60 @@ export declare type CallCompositeOptions = {
      * @defaultValue true
      */
     callControls?: boolean | CallControlOptions;
+    /**
+     * Device permission restrictions for your call.
+     * Require device permissions to be set or have them as optional or not required to start a call
+     */
+    devicePermissions?: DevicePermissionRestrictions;
+    /**
+     * Opt in call readiness feature for your call
+     * Setting this to `true` will add call readiness features to the call experience
+     */
+    callReadinessOptedIn?: boolean;
+    /**
+     * 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;
 };
 
 /**
@@ -890,7 +1194,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}.
@@ -1092,10 +1396,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;
 }
 
 /**
@@ -1125,7 +1549,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
@@ -1135,12 +1561,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
@@ -1155,6 +1585,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;
+    };
 };
 
 /**
@@ -1216,7 +1660,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.
@@ -1244,24 +1688,9 @@ export declare type CallingBaseSelectorProps = {
  *
  * @public
  */
-export declare type CallingHandlers = {
-    onStartLocalVideo: () => Promise<void>;
-    onToggleCamera: (options?: VideoStreamOptions) => Promise<void>;
-    onStartCall: (participants: (CommunicationUserIdentifier | PhoneNumberIdentifier | UnknownIdentifier)[], options?: StartCallOptions) => Call | undefined;
-    onSelectMicrophone: (device: AudioDeviceInfo) => Promise<void>;
-    onSelectSpeaker: (device: AudioDeviceInfo) => Promise<void>;
-    onSelectCamera: (device: VideoDeviceInfo, options?: VideoStreamOptions) => Promise<void>;
-    onToggleMicrophone: () => Promise<void>;
-    onStartScreenShare: () => Promise<void>;
-    onStopScreenShare: () => Promise<void>;
-    onToggleScreenShare: () => Promise<void>;
-    onHangUp: (forEveryone?: boolean) => Promise<void>;
-    onCreateLocalStreamView: (options?: VideoStreamOptions) => Promise<void | CreateVideoStreamViewResult>;
-    onCreateRemoteStreamView: (userId: string, options?: VideoStreamOptions) => Promise<void | CreateVideoStreamViewResult>;
-    onRemoveParticipant(userId: string): Promise<void>;
-    onDisposeRemoteStreamView: (userId: string) => Promise<void>;
-    onDisposeLocalStreamView: () => Promise<void>;
-};
+export declare interface CallingHandlers extends CommonCallingHandlers {
+    onStartCall: (participants: CommunicationIdentifier[], options?: StartCallOptions) => Call | undefined;
+}
 
 /**
  * Helper type for {@link usePropsFor}.
@@ -1298,6 +1727,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[];
 };
 
 /**
@@ -1316,7 +1764,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;
 }
 
 /**
@@ -1330,6 +1778,10 @@ export declare interface CallState {
      * Proxy of {@link @azure/communication-calling#Call.id}.
      */
     id: string;
+    /**
+     * Type of the call.
+     */
+    type: 'Teams' | 'ACS';
     /**
      * Proxy of {@link @azure/communication-calling#Call.callerInfo}.
      */
@@ -1412,6 +1864,10 @@ export declare interface CallState {
      * Stores the latest call diagnostics.
      */
     diagnostics: DiagnosticsCallFeatureState;
+    /**
+     * Proxy of {@link @azure/communication-calling#Call.role}.
+     */
+    role?: ParticipantRole;
 }
 
 /**
@@ -1435,6 +1891,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.
      *
@@ -1489,6 +1951,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.
      *
@@ -1641,6 +2109,45 @@ 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>;
 }
 
 /**
@@ -1711,6 +2218,14 @@ 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;
 }
 
 /**
@@ -1735,6 +2250,8 @@ 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;
 }
 
 /**
@@ -1801,6 +2318,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;
@@ -1827,6 +2347,53 @@ 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 permission restrictions for your call.
+     * Require device permissions to be set or have them as optional or not required to start a call
+     */
+    devicePermissions?: DevicePermissionRestrictions;
+    /**
+     * 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;
+    /**
+     * Opt in call readiness feature for your call
+     * setting this to True will add call readiness feature in call experience
+     */
+    callReadinessOptedIn?: boolean;
 };
 
 /**
@@ -1952,6 +2519,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
      */
@@ -1964,6 +2535,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
      */
@@ -1990,12 +2589,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
@@ -2012,12 +2615,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;
+    };
 }
 
 /**
@@ -2027,6 +2650,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 CameraAndMicrophoneDomainPermissions: (props: CameraAndMicrophoneDomainPermissionsProps) => JSX.Element;
+
+/**
+ * @beta
+ * Props for CameraAndMicrophoneDomainPermissions component.
+ */
+export declare interface CameraAndMicrophoneDomainPermissionsProps extends CommonDomainPermissionsProps {
+    /** 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 CameraAndMicrophoneDomainPermissions} */
+    strings?: CameraAndMicrophoneDomainPermissionsStrings;
+}
+
+/**
+ * @beta
+ * Strings for CameraAndMicrophoneDomainPermissions component.
+ */
+export declare type CameraAndMicrophoneDomainPermissionsStrings = DomainPermissionsStrings;
+
 /**
  * A button to turn camera on / off.
  *
@@ -2163,12 +2815,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 CameraDomainPermissions: (props: CameraDomainPermissionsProps) => JSX.Element;
+
+/**
+ * @beta
+ * Props for CameraDomainPermissions component.
+ */
+export declare interface CameraDomainPermissionsProps extends CommonDomainPermissionsProps {
+    /** Icon name for the camera icon */
+    cameraIconName?: string;
+    /** Strings for use with the {@link CameraDomainPermissions} */
+    strings?: CameraDomainPermissionsStrings;
+}
+
+/**
+ * @beta
+ * Strings for CameraDomainPermissions component.
+ */
+export declare type CameraDomainPermissionsStrings = DomainPermissionsStrings;
+
 /**
  * {@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.
@@ -2276,7 +2953,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.
      */
@@ -2298,6 +2977,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;
 };
 
 /**
@@ -2400,6 +3086,7 @@ export declare type ChatCompositeIcons = {
     ParticipantItemOptionsHovered?: JSX.Element;
     SendBoxSend?: JSX.Element;
     SendBoxSendHovered?: JSX.Element;
+    SendBoxAttachFile?: JSX.Element;
 };
 
 /**
@@ -2414,6 +3101,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
@@ -2424,6 +3118,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;
 };
 
 /**
@@ -2451,6 +3151,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';
 }
 
 /**
@@ -2465,6 +3171,10 @@ export declare interface ChatCompositeStrings {
      * Chat list header text
      */
     chatListHeader: string;
+    /**
+     * Upload File Button text
+     */
+    uploadFile: string;
 }
 
 /**
@@ -2530,7 +3240,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>;
 };
 
@@ -2556,6 +3268,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[];
 }
 
 /**
@@ -2680,6 +3398,68 @@ export declare type ClientState = CallClientState & ChatClientState;
  */
 export declare type Common<A, B> = Pick<A, CommonProperties<A, B>>;
 
+/**
+ * Object containing all the 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}.
+ *
+ * @public
+ */
+export declare interface CommonCallingHandlers {
+    onStartLocalVideo: () => Promise<void>;
+    onToggleCamera: (options?: VideoStreamOptions) => Promise<void>;
+    onSelectMicrophone: (device: AudioDeviceInfo) => Promise<void>;
+    onSelectSpeaker: (device: AudioDeviceInfo) => Promise<void>;
+    onSelectCamera: (device: VideoDeviceInfo, options?: VideoStreamOptions) => Promise<void>;
+    onToggleMicrophone: () => Promise<void>;
+    onStartScreenShare: () => Promise<void>;
+    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;
+}
+
+/**
+ * @beta
+ * Props for DomainPermissions components.
+ */
+export declare interface CommonDomainPermissionsProps {
+    /**
+     * Name of application calling experience is in.
+     */
+    appName: string;
+    /**
+     * Type of the Domain Permissions component.
+     */
+    type: 'request' | 'denied' | 'check';
+    /**
+     * 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 DomainPermissions component.
+     */
+    styles?: DomainPermissionsStyles;
+}
+
 /**
  * Return intersect properties of 2 types
  *
@@ -2816,6 +3596,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;
 }
 
 /**
@@ -2857,6 +3642,36 @@ 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 domain permission request prompt */
+    CameraAndMicrophoneDomainPermissionsRequest: DomainPermissionsStrings;
+    /** Strings for a domain permission request prompt */
+    CameraDomainPermissionsRequest: DomainPermissionsStrings;
+    /** Strings for a domain permission request prompt */
+    MicrophoneDomainPermissionsRequest: DomainPermissionsStrings;
+    /** Strings for a domain permission generic checking prompt */
+    CameraAndMicrophoneDomainPermissionsCheck: DomainPermissionsStrings;
+    /** Strings for a domain permission generic checking prompt */
+    CameraDomainPermissionsCheck: DomainPermissionsStrings;
+    /** Strings for a domain permission generic checking prompt */
+    MicrophoneDomainPermissionsCheck: DomainPermissionsStrings;
+    /** Strings for a domain permission denied prompt */
+    CameraAndMicrophoneDomainPermissionsDenied: DomainPermissionsStrings;
+    /** Strings for a domain permission denied prompt */
+    CameraDomainPermissionsDenied: DomainPermissionsStrings;
+    /** Strings for a domain permission denied prompt */
+    MicrophoneDomainPermissionsDenied: DomainPermissionsStrings;
+    /** Strings for unsupported browser UI */
+    UnsupportedBrowser: UnsupportedBrowserStrings;
+    /** Strings for BrowserPemissionDenied */
+    BrowserPermissionDenied: BrowserPermissionDeniedStrings;
+    /** Strings for BrowserPemissionDeniedIOS */
+    BrowserPermissionDeniedIOS: BrowserPermissionDeniedIOSStrings;
 }
 
 /**
@@ -3164,7 +3979,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, options }: AzureCommunicationCallAdapterArgs) => Promise<CallAdapter>;
 
 /**
  * Create a {@link CallAdapter} using the provided {@link StatefulCallClient}.
@@ -3174,7 +3989,9 @@ 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?: {
+    roleHint?: Role;
+}) => Promise<CallAdapter>;
 
 /**
  * Create a CallWithChatAdapter backed by Azure Communication services
@@ -3182,7 +3999,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 }: AzureCommunicationCallWithChatAdapterArgs) => Promise<CallWithChatAdapter>;
 
 /**
  * Create a {@link CallWithChatAdapter} using the provided {@link StatefulChatClient} and {@link StatefulCallClient}.
@@ -3214,7 +4031,7 @@ export declare const createAzureCommunicationChatAdapter: ({ endpoint: endpointU
 export declare const createAzureCommunicationChatAdapterFromClient: (chatClient: StatefulChatClient, chatThreadClient: ChatThreadClient) => Promise<ChatAdapter>;
 
 /**
- * Create the default implementation of {@link CallingHandlers}.
+ * Create the default implementation of {@link CallingHandlers} for teams call.
  *
  * Useful when implementing a custom component that utilizes the providers
  * exported from this library.
@@ -3235,6 +4052,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
@@ -3310,8 +4137,159 @@ 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;
 };
 
+/**
+ * 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.
  *
@@ -3331,6 +4309,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.
  *
@@ -3347,8 +4337,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;
@@ -3381,9 +4374,21 @@ 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;
+    DomainPermissionsSparkle: JSX.Element;
+    DomainPermissionCamera: JSX.Element;
+    DomainPermissionMic: JSX.Element;
+    DomainPermissionCameraDenied: JSX.Element;
+    DomainPermissionMicDenied: JSX.Element;
+    UnsupportedBrowserWarning: JSX.Element;
+    BrowserPermissionDeniedError: JSX.Element;
+    VideoTilePinned: JSX.Element;
 };
 
 /**
@@ -3404,6 +4409,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;
@@ -3446,6 +4452,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;
@@ -3456,11 +4466,25 @@ 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;
+    DomainPermissionsSparkle: JSX.Element;
+    DomainPermissionCamera: JSX.Element;
+    DomainPermissionMic: JSX.Element;
+    DomainPermissionCameraDenied: JSX.Element;
+    DomainPermissionMicDenied: JSX.Element;
+    UnsupportedBrowserWarning: JSX.Element;
+    BrowserPermissionDeniedError: JSX.Element;
+    VideoTilePinned: JSX.Element;
 };
 
 /**
@@ -3518,6 +4542,95 @@ export declare type DeviceManagerState = {
     unparentedViews: LocalVideoStreamState[];
 };
 
+/**
+ * A dropdown to trigger device permission prompt
+ *
+ * @internal
+ */
+export declare const _DevicePermissionDropdown: (props: _DevicePermissionDropdownProps) => JSX.Element;
+
+/**
+ * Props for {@link _DevicePermissionDropdown}.
+ *
+ * @internal
+ */
+export declare interface _DevicePermissionDropdownProps {
+    /**
+     * icon shown in dropdown placeholder
+     */
+    icon?: JSX.Element;
+    /**
+     * Dropdown content
+     */
+    options?: IDropdownOption[];
+    /**
+     * Ask for permissions of devices.
+     *
+     * @remarks
+     * Browser permission window will pop up if permissions are not granted yet
+     *
+     * @param constrain - Define constraints for accessing local devices {@link @azure/communication-calling#PermissionConstraints }
+     */
+    askDevicePermission?(constrain: _PermissionConstraints): Promise<void>;
+    /**
+     * Optional callback when component is clicked
+     */
+    onClick?: () => void;
+    /**
+     * Define constraints for accessing local devices  {@link @azure/communication-calling#PermissionConstraints }
+     */
+    constrain?: _PermissionConstraints;
+    /**
+     * Strings for devicepermissiondropdown
+     */
+    strings?: _DevicePermissionDropdownStrings;
+    /**
+     * Styles for devicepermissiondropdown
+     */
+    styles?: Partial<IDropdownStyles>;
+}
+
+/**
+ * Strings of {@link DevicePermissionDropdown} that can be overridden.
+ *
+ * @internal
+ */
+export declare interface _DevicePermissionDropdownStrings {
+    /**
+     * dropdown label
+     */
+    label?: string;
+    /**
+     * dropdown placeholder
+     */
+    placeHolderText: string;
+    /** string for action button  */
+    actionButtonContent?: string;
+}
+
+/**
+ * Device Permission restrictions.
+ * Be able to start a call depending on camera and microphone permission options.
+ *
+ * @beta
+ */
+export declare interface DevicePermissionRestrictions {
+    /**
+     * 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';
+}
+
 /**
  * A button to open a menu that controls device options.
  *
@@ -3672,34 +4785,134 @@ export declare type DiagnosticChangedEventListner = (event: MediaDiagnosticChang
  */
 export declare interface DiagnosticsCallFeatureState {
     /**
-     * Stores diagnostics related to network conditions.
+     * Stores diagnostics related to network conditions.
+     */
+    network: NetworkDiagnosticsState;
+    /**
+     * Stores diagnostics related to media quality.
+     */
+    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.
+ *
+ * @public
+ */
+export declare type DisplayNameChangedListener = (event: {
+    participantId: CommunicationIdentifierKind;
+    displayName: string;
+}) => void;
+
+/**
+ * Functionality for correctly disposing a Composite.
+ *
+ * @public
+ */
+export declare interface Disposable {
+    /** Dispose of the Composite */
+    dispose(): void;
+}
+
+/**
+ * @beta
+ * Strings for DomainPermissions component
+ */
+export declare type DomainPermissionsStrings = {
+    /**
+     * Main text string.
+     */
+    primaryText?: string;
+    /**
+     * Subtext string.
+     */
+    secondaryText?: string;
+    /**
+     * More help link string.
+     */
+    linkText?: string;
+    /**
+     * Primary button text string.
      */
-    network: NetworkDiagnosticsState;
+    primaryButtonText?: string;
     /**
-     * Stores diagnostics related to media quality.
+     * Aria label describing the content of the container
      */
-    media: MediaDiagnosticsState;
-}
+    ariaLabel?: string;
+};
 
 /**
- * Callback for {@link CallAdapterSubscribers} 'displayNameChanged' event.
+ * Fluent styles for {@link DomainPermissionsContainer}.
  *
- * @public
+ * @beta
  */
-export declare type DisplayNameChangedListener = (event: {
-    participantId: CommunicationIdentifierKind;
-    displayName: string;
-}) => void;
+export declare interface DomainPermissionsStyles extends BaseCustomStyles {
+    /** Styles for the primary button. */
+    primaryButton?: IButtonStyles;
+    /** Styles for the help troubleshooting link text. */
+    troubleshootingLink?: ILinkStyles;
+}
 
 /**
- * Functionality for correctly disposing a Composite.
+ * DTMF tone for PSTN calls.
  *
- * @public
+ * @beta
  */
-export declare interface Disposable {
-    /** Dispose of the Composite */
-    dispose(): void;
-}
+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.
@@ -3923,6 +5136,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.
  *
@@ -3963,7 +5369,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 : AreEqual<Component, typeof _DevicePermissionDropdown> extends true ? EmptySelector : undefined;
 
 /**
  * Get the selector for a specified component.
@@ -4025,6 +5431,63 @@ export declare interface GridLayoutStyles extends BaseCustomStyles {
     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 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;
+}
+
 /**
  * {@link HorizontalGallery} Component Styles.
  * @public
@@ -4105,6 +5568,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}.
@@ -4571,6 +6048,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.
      *
@@ -4606,6 +6088,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;
 };
 
 /**
@@ -4677,6 +6171,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;
 }
 
 /**
@@ -4859,6 +6355,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 MicrophoneDomainPermissions: (props: MicrophoneDomainPermissionsProps) => JSX.Element;
+
+/**
+ * @beta
+ * Props for MicrophoneDomainPermissions component.
+ */
+export declare interface MicrophoneDomainPermissionsProps extends CommonDomainPermissionsProps {
+    /** Icon name for the microphone icon */
+    microphoneIconName?: string;
+    /** Strings for use with the {@link MicrophoneDomainPermissions} */
+    strings?: MicrophoneDomainPermissionsStrings;
+}
+
+/**
+ * @beta
+ * Strings for MicrophoneDomainPermissions component.
+ */
+export declare type MicrophoneDomainPermissionsStrings = DomainPermissionsStrings;
+
 /**
  * Payload for {@link DiagnosticChangedEventListner} where there is a change in a network diagnostic.
  *
@@ -4966,6 +6487,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;
 }
 
 /**
@@ -4986,6 +6515,12 @@ export declare interface ParticipantItemStrings {
     mutedIconLabel: string;
     /** placeholder text for participants who does not have a display name*/
     displayNamePlaceholder?: string;
+    /** String shown when `participantState` is `Connecting` */
+    participantStateConnecting?: string;
+    /** String shown when `participantState` is `Ringing` */
+    participantStateRinging?: string;
+    /** String shown when `participantState` is `Hold` */
+    participantStateHold?: string;
 }
 
 /**
@@ -5289,6 +6824,16 @@ export declare type ParticipantsRemovedListener = (event: {
  */
 export declare type ParticipantState = 'Idle' | 'Connecting' | 'Ringing' | 'Connected' | 'Hold' | 'InLobby' | 'EarlyMedia' | 'Disconnected';
 
+/**
+ * Define constraints for accessing local devices  {@link @azure/communication-calling#PermissionConstraints }
+ *
+ * @internal
+ */
+export declare type _PermissionConstraints = {
+    audio: boolean;
+    video: boolean;
+};
+
 /**
  * An array of key value pairs that stores each sender's display name and last read message
  *
@@ -5352,6 +6897,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;
 }
 
 /**
@@ -5376,6 +6925,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.
@@ -5383,6 +6933,12 @@ export declare interface RemoteVideoStreamState {
     view?: VideoStreamRendererViewState;
 }
 
+/**
+ * @beta
+ * The role of a call participant.
+ */
+export declare type Role = 'Presenter' | 'Attendee' | 'Consumer' | 'Organizer';
+
 /**
  * A button to start / stop screen sharing.
  *
@@ -5416,6 +6972,7 @@ export declare interface ScreenShareButtonProps extends ControlBarButtonProps {
  */
 export declare type ScreenShareButtonSelector = (state: CallClientState, props: CallingBaseSelectorProps) => {
     checked?: boolean;
+    disabled?: boolean;
 };
 
 /**
@@ -5453,6 +7010,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}.
  *
@@ -5508,6 +7078,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;
 }
 
 /**
@@ -5538,6 +7127,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;
 }
 
 /**
@@ -5664,6 +7269,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>;
 }
 
 /**
@@ -5677,6 +7295,15 @@ export declare type StatefulCallClientArgs = {
      * state. It is not used by StatefulCallClient.
      */
     userId: CommunicationUserIdentifier;
+    /**
+     * 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;
 };
 
 /**
@@ -5816,6 +7443,18 @@ export declare interface SystemMessageCommon extends MessageCommon {
     iconName: string;
 }
 
+/**
+ * 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}.
  *
@@ -5995,11 +7634,46 @@ export declare interface TypingIndicatorStylesProps extends BaseCustomStyles {
     typingString?: IStyle;
 }
 
+/**
+ * UI to display to the user that the browser they are using is not supported by calling application.
+ *
+ * @beta
+ */
+export declare const UnsupportedBrowser: (props: UnsupportedBrowserProps) => JSX.Element;
+
+/**
+ * props for UnsupportedBrowser UI
+ *
+ * @beta
+ */
+export declare interface UnsupportedBrowserProps {
+    /** Handler to perform a 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 for the help link */
+    moreHelpLink: 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}.
@@ -6055,6 +7729,8 @@ export declare const useAzureCommunicationChatAdapter: (args: Partial<AzureCommu
  * Useful when implementing a custom component that utilizes the providers
  * exported from this library.
  *
+ * you must have previously used the CallProvider with a Call object to use this hook
+ *
  * @public
  */
 export declare const useCall: () => Call | undefined;
@@ -6145,6 +7821,28 @@ 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;
+
+/**
+ * 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
  *
@@ -6263,6 +7961,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;
 }
 
 /**
@@ -6410,6 +8113,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.
@@ -6438,6 +8145,22 @@ 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;
+}
+
+/**
+ * Strings of {@link VideoTile} that can be overridden.
+ * @beta
+ */
+export declare interface VideoTileStrings {
+    participantStateConnecting: string;
+    participantStateRinging: string;
+    participantStateHold: string;
 }
 
 /**